// MCP TOOL REFERENCE

ACTUAL TOOLS

25 tools from the Actual MCP Server, categorised by risk level.

// ALL 25 ACTUAL TOOLS

READ 8 tools

Read balance-history Get account balance history over time Read get-accounts Retrieve a list of all accounts with their current balance and ID. Read get-grouped-categories Retrieve a list of all category groups with their id, name, type and category list. Read get-payees Retrieve a list of all payees with their id, name, categoryId and transferAccountId. Read get-rules Retrieve a list of all rules. PS amount comes in cents: positive for deposit, negative for payment Read get-transactions Get transactions for an account with optional filtering Read monthly-summary Get monthly income, expenses, and savings Read spending-by-category Get spending breakdown by category for a specified date range

WRITE 11 tools

Write create-category Create a new category Write create-category-group Create a new category group Write create-payee Create a new payee Write create-rule Create a new rule Write create-transaction Create a new transaction. Use this to add transactions to accounts. Supports transfers between accounts by ... Write import-transactions Import a list of transactions into an account using reconciliation logic. Write update-category Update a category Write update-category-group Update a category group Write update-payee Update a payee Write update-rule Update a rule Write update-transaction Update an existing transaction. Can modify date, amount, payee, category, notes, cleared status, and subtra...

DESTRUCTIVE 5 tools

Destructive delete-category Delete a category Destructive delete-category-group Delete a category group Destructive delete-payee Delete a payee Destructive delete-rule Delete a rule Destructive delete-transaction Delete a transaction by its ID. This action is permanent and cannot be undone.

EXECUTE 1 tools

Execute run-bank-sync Run bank synchronization (GoCardless/SimpleFIN) to download latest transactions.

// FAQ

How many tools does the Actual MCP server have? +

The Actual MCP server exposes 25 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Actual tools? +

Route the Actual server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do Actual tools fall into? +

Actual tools are categorised as Read (8), Write (11), Destructive (5), Execute (1). Each category has a recommended default policy.

Enforce policy on every Actual tool call.

Deterministic rules across all 25 Actual tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.

GOVERN ACTUAL →

Free to start. No card required.

42,500+ MCP servers and 110,000+ tools scanned and risk-classified.