Skip to content
Agentmart
Submit a tool

Aikount MCP

Contabilidad española con IA: facturas, gastos por OCR, conciliación bancaria e impuestos AEAT.

Connector by mutonby · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)Remote (HTTP)★ 3
Write a review

Install

Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/mutonby-aikount-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://api.aikount.com/mcp Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Contabilidad española con IA: facturas, gastos por OCR, conciliación bancaria e impuestos AEAT.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools
14 read · 3 write · 0 delete · 7 not yet classified
Secrets
1 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Python package

Tools by what they do 24

Read from the source code; the running server may list different tools.

Read 14 · Look things up without changing anything.

  • get_ingest_job
  • get_invoice
  • get_purchase
  • ledger
  • list_accounts
  • list_bank_movements
  • list_contacts
  • list_invoices
  • list_products
  • list_purchases
  • list_tax_types
  • list_treasuries
Show 2 more tools
  • reconciliation_board
  • whoami

Write 3 · Create, change, send or run things.

  • api_request
  • create_contact
  • create_invoice

Not yet classified 7 · We could not tell from the name and description.

  • ingest_purchase_pdf
  • issue_invoice
  • modelo_303_csv
  • modelo_303_summary
  • reconcile_movement
  • trial_balance
  • wrapper

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • AIKOUNT_TOKEN

Other settings (environment variables or headers).

  • AIKOUNT_API

Network hosts it talks to 4

  • aikount.com · found in code
  • api.aikount.com · found in remote endpoint, install command, code
  • github.com · found in code
  • glama.ai · found in code

Files it touches

  • Any path the agent passes to its tools

Tools (24)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • api_request

    Call any Aikount API endpoint not covered by a dedicated tool. The full surface is documented at https://api.aikount.com/openapi.json — fetch it (e.g. api_request('GET', '/../openapi.json')) when you need an endpoint this server doesn't wrap. Args: method: GET / POST / PATCH / DELETE. path: API path relative to the base, e.g. '/invoices' or '/contacts/<uuid>'. Leading slash optional. params: query parameters. body: JSON body (for POST/PATCH).

  • create_contact

    Create a contact. `country` is an ISO-3166 alpha-2 code (e.g. 'ES').

  • create_invoice

    Create a DRAFT sales invoice (call issue_invoice to assign a number). Money is in MAJOR units (euros as decimals), e.g. unit_price 1200.00 — NOT cents. Each line is a dict: { "description": "Consultoría mayo", # required "quantity": 1, # default 1 "unit_price": 1200.00, # default 0, euros "tax_type_id": "<uuid>", # from list_tax_types; omit # to inherit the contact/ # product default "discount_pct": 0, …

  • get_ingest_job

    Poll the status/result of an AI ingest job (see ingest_purchase_pdf).

  • get_invoice

    Fetch one sales invoice in full by UUID.

  • get_purchase

    Fetch one purchase document in full by UUID.

  • ingest_purchase_pdf

    Queue a purchase PDF/image for AI extraction (OCR -> deduped purchase). The AI reads the supplier, lines and taxes and creates the purchase doc, deduplicating by invoice identity (contact + supplier_invoice_number, fallback total + date) so the same invoice never lands twice. Runs async: this returns a job immediately — poll get_ingest_job(job_id) until its status is done, then read result for the created document. Args: file_path: local path to a PDF / JPG / PNG / WebP / HEIC. force: bypass dedup and ingest anyway (use only when you are sure it is a genuinely distinct inv…

  • issue_invoice

    Issue a draft invoice — assigns the next sequential legal number. Irreversible-ish: issued numbers must stay contiguous, so do not delete issued invoices to "renumber". Confirm with the user before issuing.

  • ledger

    Read ledger movements for ONE PGC account. Args: account_id: the account's UUID (required). Resolve it from list_accounts — e.g. find the account whose code is '572' (bancos) and pass its id here. from_date / to_date: ISO date bounds.

  • list_accounts

    List the Spanish PGC chart of accounts (code, name, UUID, balance). Use this to resolve an account's UUID for `ledger`, or to browse by `group` (1-7, the leading PGC digit: 5 = financial accounts, 4 = receivables/payables, …) or free-text `search` (code or name).

  • list_bank_movements

    List bank movements, optionally scoped to one treasury. Args: treasury_id: restrict to a single treasury (UUID). status: e.g. 'unreconciled' / 'reconciled'. from_date / to_date: ISO date bounds. search: free-text match on the movement description.

  • list_contacts

    List contacts (customers and suppliers). Args: search: free-text match on name / legal name / VAT. kind: 'customer' or 'supplier' to filter; omit for both. limit: page size (1-500, default 50). offset: pagination offset.

  • list_invoices

    List sales invoices. Lifecycle: draft -> issued -> paid. Args: status: e.g. 'draft', 'issued', 'paid'. contact_id: filter to one customer (UUID). from_date / to_date: ISO 'YYYY-MM-DD' bounds on doc_date.

  • list_products

    List catalog products/services.

  • list_purchases

    List purchase documents (supplier invoices / expenses).

Show 9 more tools
  • list_tax_types

    List the tenant's tax types (IVA/IGIC/IPSI/IRPF), each with its UUID. Invoice/purchase lines reference a tax by `tax_type_id` (a UUID from this list), not by a string code — call this to resolve which UUID is the 21% IVA, the 10% reducido, exento, etc.

  • list_treasuries

    List treasuries (bank / Stripe / PayPal accounts) with balances. Stripe/PayPal treasuries return a live balance pulled on read; bank-feed treasuries return the last synced snapshot.

  • modelo_303_csv

    Modelo 303 backing detail for one quarter as CSV text. Returns the per-transaction breakdown (one row per invoice/purchase line: date, doc, contact, base, rate, iva, input/output) that the quarter's VAT figures are built from — useful for auditing the numbers. For the aggregated box totals, use modelo_303_summary. Args: year: e.g. 2026. quarter: 1-4.

  • modelo_303_summary

    Modelo 303 (quarterly VAT) — JSON summary of every quarter with activity. One row per (year, quarter): sales base, output VAT, rectified VAT, input VAT, and the net amount to pay. Use this for a machine-readable overview; use modelo_303_csv for the AEAT-format file of one quarter.

  • reconcile_movement

    Manually match a bank movement to an invoice/purchase document. Args: movement_id: bank movement UUID. document_id: invoice or purchase UUID.

  • reconciliation_board

    Get the reconciliation board: suggested movement<->document matches. The system auto-reconciles matches with confidence >= 0.95; everything below is a suggestion to confirm (reconcile_movement) or dismiss.

  • trial_balance

    Balance de sumas y saldos (trial balance) across every account. A one-shot overview of all account balances — no account_id needed. Args: at_date: ISO date to compute balances as of (default: today).

  • whoami

    Verify the token and return the active tenant (id, name, VAT, currency…). Call this first. A 200 confirms the token works; a 401/403 means it is missing, revoked, or malformed. Note: with an 'agl_' API key this reads /tenants/me. The /auth/me endpoint is reserved for interactive session logins (onboarding/membership flow) and deliberately rejects API keys.

  • wrapper

Signals

Stars
3
Forks
0
Open issues
0
Weekly downloads
37
Last commit
Oct 19, 2026 (9 days ago)
Last release
Oct 19, 2026 (9 days ago)
Last package publish
Sep 27, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.mutonby/aikount-mcp
Version
0.2.0
Auth
Auth not stated, API key
Packages
pypi aikount-mcp
License
MIT
Repository
github.com/mutonby/aikount-mcp
Website
aikount.com/mcp-contabilidad
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from mutonby

Cite this page

Aikount MCP. Agent Mart. https://agentmart.dev/connectors/mutonby-aikount-mcp (last updated 2026-10-24)