Business operationsPublic source

mcp-finance

Finance & Accounting MCP Server — invoices, expenses, accounts, journal entries, reconciliation, and financial reports for AI agents. Multi-backend: QuickBooks Online, Xero, and a local in-memory ledger for testing.

Open the source Read the official guide ↗

What it gives an agent

A purpose-built capability behind one MCP connection.

The server owns its domain logic and publishes a tool contract an MCP client can discover. ADK-Rust can load that contract into an agent, normalize each schema for the chosen model provider, and keep the connection lifecycle outside the agent’s business logic.

14 financial tools covering the full accounting lifecycle

Multi-backend: QuickBooks Online, Xero, or local ledger

Zero-config demo mode (local ledger with seed data)

Registry-compliant with mcp-server.toml manifest

Risk-classified tools for governance gates

Architecture

How mcp-finance fits into an agent system.

The model never needs the implementation details or credentials of the system behind the server. It sees reviewed tool definitions. The MCP client handles discovery and calls, while the server keeps ownership of validation, policy, and communication with its domain system.

ADK-Rust agent

Chooses a capability from the reviewed tool catalog.

→

MCP client

Discovers schemas, sends calls, and receives typed content.

→

mcp-finance

Validates the request and owns 14 documented tool contracts.

→

Domain system

Keeps the API, data, credentials, and business rules behind the server.

Connection: stdio · Server framework: ADK MCP SDK + rmcp

mcp-finance architecture diagram from its official repository

Tool catalog

What can an agent ask mcp-finance to do?

Each tool has a stable name, a human-readable purpose, and a JSON input contract discovered during MCP initialization. Risk classes come from the project’s registry manifest when one is available.

14 named tools

list_invoices

List invoices with optional status filter (paid, unpaid, overdue, draft)

read only

get_invoice

Get invoice details by ID

read only

create_invoice

Create a new invoice

internal write

list_expenses

List expenses/bills with optional category filter

read only

create_expense

Record a new expense

internal write

list_accounts

List chart of accounts

read only

get_account_balance

Get account balance by account ID

read only

list_transactions

List recent transactions with optional account filter

read only

create_journal_entry

Create a journal entry (debit/credit). Debits must equal credits.

financial action

reconcile_transaction

Reconcile a transaction by matching it to an invoice or expense

internal write

get_profit_loss

Get Profit & Loss report for a date range

read only

get_balance_sheet

Get balance sheet as of a specific date

read only

Governance

Understand the effect of every tool.

A server connection inherits the authority of its credentials and deployment environment. The declarations below come from this project’s README and MCP registry manifest; your application still decides which tools an agent receives and where approval is required.

10 read only3 internal write1 financial action

The registry manifest declares read only, internal write, financial action tool risk classes.

MCP surface

What the current documentation declares.

MCP can carry tools, resources, prompts, structured results, progress, cancellation, and long-running work. This record highlights the modern protocol features explicitly mentioned by this repository.

The current README concentrates on its tool surface. Check the source and release notes before relying on optional MCP capabilities beyond tool discovery and invocation.

ADK MCP SDKrmcpRegistry manifest

Install and connect

Follow the project’s documented starting point.

Install the server in the environment that owns its credentials and domain access. Add it to your MCP host, verify the discovered tools, and narrow the toolset before giving it to a production agent.

Install

cargo install mcp-finance

MCP client configuration

{
  "mcpServers": {
    "finance": {
      "command": "/path/to/mcp-finance",
      "env": {
        "QUICKBOOKS_ACCESS_TOKEN": "your-token",
        "QUICKBOOKS_REALM_ID": "your-realm-id"
      }
    }
  }
}

Commands and configuration are extracted from the public README. Confirm prerequisites, environment variables, and release-specific options in the official documentation before deployment.

Official documentation

Continue with the project maintainers’ source of truth.

This page provides an approachable map of the server. The repository remains authoritative for exact schemas, prerequisites, configuration, examples, tests, releases, and security updates.

Overview ↗README.md Architecture ↗docs/assets/architecture.svg Issues and support ↗github.com issues

Keep exploring