Skip to main content
Glama
fintaro-mcp

fintaro-mcp

Official
by fintaro-ai

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

whoami

Show the organization, scopes, and expiry the key is bound to

—

upload_invoice(file_path)

Upload a local PDF/PNG/JPEG/WebP receipt (≤ 25 MB)

invoices:write

get_invoice(invoice_id)

Narrow, PII-free summary of one invoice

invoices:read

list_invoices()

Narrow, PII-free summaries of the org's invoices

invoices:read

list_transactions()

The org's bank transactions

transactions:read

list_unmatched()

Transactions still missing a receipt

transactions:read

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

  1. In Fintaro, open Settings → API keys and create a key.

  2. Grant the minimum scopes for what you need:

    • read-only review: invoices:read, transactions:read

    • plus receipt upload: add invoices:write

  3. 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

FINTARO_API_KEY

yes

—

the ftk_ key

FINTARO_BASE_URL

no

https://api.fintaro.ai/api/v1

must be https://

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 -v

Available Tools

6 tools
get_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

    A4.1/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    With 6 tools, the set covers core financial operations (invoices, transactions, identity) without being bloated or too sparse, fitting the domain well.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      1
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      2
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables MCP clients to read Fortnox invoices and customers, validate receipts, and optionally perform approved write operations with strict safety controls.
      3
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      16
      322 npm
      MIT