io.github.Ainode-tech/accounting-mcp

Official9 tools

8 EU accounting (x402 USDC on Base): reconcile, VAT, invoicing. Free health.

Handles EU accounting tasks including reconciliation, VAT, and invoice generation.

Captured live from the server via tools/list.

health

Health check. Returns server status and optional echo.

Parameters (1)

echostring
Optional string to echo back

reconcile_transactions

Match bank statement lines against unreconciled Xero transactions. Returns confidence-scored matches (>=0.8 matched, 0.5-0.8 suggested, <0.5 unmatched).

Parameters (3)

api_key_hashstringrequired
Customer API key hash identifying Xero token
from_datestring
Start date filter (YYYY-MM-DD)
to_datestring
End date filter (YYYY-MM-DD)

confirm_reconciliation

Apply confirmed reconciliation matches to Xero. Marks matched bank transactions as reconciled.

Parameters (2)

matchesarrayrequired
Array of confirmed statement-to-transaction matches
api_key_hashstringrequired
Customer API key hash identifying Xero token

categorise_expenses

Suggest Portuguese tax categories for uncategorised Xero expenses. Returns category, VAT tier, deductibility, and VAT breakdown per transaction.

Parameters (4)

api_key_hashstringrequired
Customer API key hash identifying Xero token
from_datestring
Start date filter (YYYY-MM-DD)
to_datestring
End date filter (YYYY-MM-DD)
regionstring
Portuguese tax region

apply_categories

Apply confirmed Portuguese tax categories to Xero transactions. Updates AccountCode and TaxType.

Parameters (2)

categoriesarrayrequired
Array of transaction-to-category assignments
api_key_hashstringrequired
Customer API key hash identifying Xero token

calculate_vat

Calculate Portuguese VAT for a given amount, category, and region. Supports Mainland, Azores, and Madeira rates. Detects intra-community B2B reverse charge.

Parameters (5)

amountnumberrequired
Net amount (ex-VAT) to calculate VAT on
categorystring
Portuguese tax category code (e.g. office_supplies, food_restaurant)
regionstring
Portuguese tax region
is_b2bboolean
Whether the transaction is business-to-business
counterpart_countrystring
ISO 3166-1 alpha-2 country code of the counterpart

draft_invoice

Create a DRAFT invoice in Xero with VAT preview. Returns line totals and tax amounts for review before sending.

Parameters (8)

contact_namestringrequired
Invoice recipient name
contact_emailstringrequired
Invoice recipient email address
line_itemsarrayrequired
Invoice line items
due_datestringrequired
Due date (YYYY-MM-DD)
currencystring
Currency code (defaults to EUR)
referencestring
Invoice reference number
notesstring
Notes for internal use
api_key_hashstringrequired
Customer API key hash identifying Xero token

send_invoice

Authorise a DRAFT invoice and email it to the contact via Xero. Two-step: sets status to AUTHORISED then triggers email.

Parameters (2)

invoice_idstringrequired
Xero InvoiceID to authorise and send
api_key_hashstringrequired
Customer API key hash identifying Xero token

generate_report

Generate a financial report: P&L, Balance Sheet, Cash Flow (indirect method from balance sheet deltas), or VAT Summary with Portuguese SAF-T filing hints.

Parameters (4)

report_typestringrequired
Report type to generate
from_datestring
Start date (YYYY-MM-DD, defaults to 1st of current month)
to_datestring
End date (YYYY-MM-DD, defaults to today)
api_key_hashstringrequired
Customer API key hash identifying Xero token

Install

claude_desktop_config.json

{
  "mcpServers": {
    "accounting-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xero.api.ainode.tech/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.