fintaro-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fintaro-mcp list my recent invoices"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
fintaro-mcp
A Model Context Protocol server that lets an
MCP-capable agent (Claude Desktop, etc.) read your Fintaro invoices and
transactions and upload receipts — over the Fintaro API gateway, authenticated
with a scoped, bring-your-own ftk_ API key.
The server is read-mostly and PII-safe by construction: get_invoice returns
a narrow projection that never includes raw OCR text, raw extraction JSON, or
tax-IDs/emails, so attacker-controlled invoice content cannot be injected into
the agent's context.
Tools
Tool | What it does | Required scope |
| Show the organization, scopes, and expiry the key is bound to | — |
| Upload a local PDF/PNG/JPEG/WebP receipt (≤ 25 MB) |
|
| Narrow, PII-free summary of one invoice |
|
| Narrow, PII-free summaries of the org's invoices |
|
| The org's bank transactions |
|
| Transactions still missing a receipt |
|
Prompt: monatsabschluss_check — a guided pre-close review that uses
list_unmatched to find transactions still without a receipt.
Related MCP server: pai
Agent skills
Ready-to-use, copy-paste skill definitions that teach an MCP-capable agent real
Fintaro workflows over these tools live in skills/ —
onboarding/setup, the pre-close (Monatsabschluss) review, receipt upload, and an
invoice/transaction review. Each is a SKILL.md usable as an agent skill or as a
standalone prompt template.
Mint an API key
In Fintaro, open Settings → API keys and create a key.
Grant the minimum scopes for what you need:
read-only review:
invoices:read,transactions:readplus receipt upload: add
invoices:write
Copy the
ftk_…key once (it is shown only at creation) and store it in your MCP client's environment. The organization is derived from the key — there is no org parameter to pass.
Configuration
Variable | Required | Default | Notes |
| yes | — | the |
| no |
| must be |
The server rejects any tool call without FINTARO_API_KEY or with a non-https
base URL (the configuration is validated on the first tool invocation).
Client config (uvx)
{
"mcpServers": {
"fintaro": {
"command": "uvx",
"args": ["fintaro-mcp"],
"env": {
"FINTARO_API_KEY": "ftk_your_scoped_key"
}
}
}
}Onboarding a tester
See ONBOARDING.md for a ready-to-send tester summary and a copy-paste
onboarding prompt for an MCP-capable agent. The package is not on PyPI yet, so uvx fintaro-mcp
does not resolve on its own. Until it is published, install straight from this repo:
{
"mcpServers": {
"fintaro": {
"command": "uvx",
"args": ["--from", "git+https://github.com/fintaro-ai/fintaro-mcp", "fintaro-mcp"],
"env": { "FINTARO_API_KEY": "ftk_your_scoped_key" }
}
}
}Alternatively distribute a built wheel (pip wheel . -w dist --no-deps) and configure the client
with uvx --from <path>/fintaro_mcp-*.whl fintaro-mcp.
Development
python3 -m pip install -e ".[dev]"
python3 -m pytest -vAvailable Tools
6 toolsget_invoiceA
Return a narrow, PII-free summary of a single invoice.
Inputs: invoice_id (required).
list_invoicesA
List one page of the organization's invoices as narrow, PII-free summaries.
Newest-first. One call returns one page; if hasMore is true, call again with
offset advanced by limit (clamped to 100). total is unknown (the gateway
list endpoint returns no count).
Returns {"invoices", "total", "offset", "limit", "returned", "hasMore"}.
Inputs: limit, offset.
list_transactionsA
List one page of the organization's bank transactions as narrow summaries.
One call returns one page; if hasMore is true, call again with offset
advanced by limit (clamped to 200). Narrow the window with date_from /
date_to (ISO dates, e.g. "2026-06-01") to cover a period without paging all
history.
Returns {"transactions", "total", "offset", "limit", "returned", "hasMore"}.
Inputs: limit, offset, date_to, date_from.
list_unmatchedA
List one page of transactions that still need a matching receipt.
Same paging/filtering contract as list_transactions: one page per call,
advance offset by limit while hasMore, optionally bound by date_from /
date_to. For a month-end close, pass the period's bounds.
Returns {"transactions", "total", "offset", "limit", "returned", "hasMore"}.
Inputs: limit, offset, date_to, date_from.
upload_invoiceA
Upload a local receipt file (PDF/PNG/JPEG/WebP) to Fintaro for processing.
Inputs: file_path (required).
whoamiA
Show which organization and scopes the configured API key is bound to.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a unique, well-defined purpose. get_invoice and list_invoices are clearly distinct, list_transactions and list_unmatched are differentiated by filter criteria, and whoami is a standalone identity check.
All tool names follow a consistent verb_noun pattern with lowercase underscores (e.g., get_invoice, list_transactions). whoami is a minor exception but common in practice, not causing confusion.
With 6 tools, the set covers core financial operations (invoices, transactions, identity) without being bloated or too sparse, fitting the domain well.
The tool surface covers invoice retrieval, listing, upload, transaction listing, and unmatched transaction listing. Missing update/delete for invoices is a minor gap, but the core workflow is intact.
Maintenance
Related MCP Connectors
Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.
Manage Apollo invoices and customers with entity-scoped OAuth and optional read/write access.
Host any HTTP API as MCP tools with a tamper-evident cross-agent settlement ledger.
Pay-per-call APIs and MCP services for agents, no accounts or keys, with verifiable receipts.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible agents to securely access an Invoice4U account for searching documents and customers and creating receipts linked to paid invoices, with read-only behavior by default.1MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to manage API keys and child keys with budgets and spending caps, set plans and model routing, handle wallet payments and top-ups, and verify signed receipts through MCP tools.265 npm2MIT
- AlicenseBqualityCmaintenanceEnables MCP clients to read Fortnox invoices and customers, validate receipts, and optionally perform approved write operations with strict safety controls.3MIT
- AlicenseBqualityCmaintenanceEnables MCP clients to query and register invoices, suppliers, and payments through the Contasimple API v2, including optional write access for creating records, attaching files, and managing payments.16322 npmMIT