Skip to main content
Glama

Server Details

Spanish tax calendar, RETA and IRPF estimates and guides for autónomos in Spain, by Kuotia.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
ChatGPT
–
Claude
–

TDQS

A4.2/5.0

Scored across 9 tools

Disambiguation4/5

The gestoria_/kuotia_ prefix split cleanly separates connected-client tools from public tools, and the descriptions cross-reference each other (e.g. tax_calendar explicitly delegates client status to gestoria_get_tax_status). The main soft spot is kuotia_estimate_net_income vs kuotia_estimate_reta, since the former also computes a cuota the latter already returns; the descriptions differentiate them (full take-home vs tramo) but an agent could still pick the wrong one. gestoria_get_obligations vs gestoria_get_tax_status are also adjacent, though 'which returns and by when' vs 'progress and amounts' is stated clearly.

Naming Consistency4/5

All names are snake_case with a verb_noun shape (get_obligations, get_tax_status, list_requests, send_message, estimate_net_income, estimate_reta, get_autonomo_guide, get_tax_calendar), so the pattern is readable and predictable. Minor deviations: two different namespace prefixes, and kuotia_action_receipts has no verb, which breaks the pattern of the rest.

Tool Count5/5

Nine tools is well within the sweet spot and each one maps to a distinct job: four client-side gestoría operations, one recovery/verification tool, and four public advisory tools. No tool looks redundant enough to cut without losing a capability.

Completeness4/5

The domain (Spanish autónomo tax guidance plus connected gestoría client operations) is covered end to end: obligations, status, requests, messaging, write-safety receipts, IRPF/RETA estimates, a sourced knowledge guide, and a filing calendar. The stated gaps are deliberate (no reading messages back, no answering requests, no attachments, calendar limited to verified periods), but the absence of any document-upload path despite 'send documents via the portal' guidance is a real dead end for the agent.

Available Tools

9 tools
gestoria_get_obligationsVer mis obligaciones del añoA
Read-onlyIdempotent
Inspect

Use this when a connected gestoría client asks which returns they must file in a year and by when, as their gestor confirmed them. Do not use for someone who is not a connected client.

Inputs: year (required). Returns: object

gestoria_get_tax_statusVer cómo van mis impuestosA
Read-onlyIdempotent
Inspect

Use this when a connected Kuotia gestoría client asks how their taxes are going: which periods are being prepared, ready to file or filed, deadlines, and the amounts their gestor has made ready or filed. Amounts appear only for ready or filed returns. Read only: it never files, approves or changes anything. Do not use for general deadlines or estimates (public tools).

Inputs: period. Returns: object

gestoria_list_requestsVer lo que me pide mi gestorA
Read-onlyIdempotent
Inspect

Use this when a connected gestoría client asks what their gestor needs from them or whether something they sent arrived. Lists each pending or sent request with its type, period, due date and a portal link; the client answers in the Kuotia portal. Do not use to answer or create requests.

Inputs: status. Returns: object

gestoria_send_messageEscribir a mi gestorA
DestructiveIdempotent
Inspect

Use this when a connected Kuotia gestoría client explicitly asks to send a text message to their gestor (a question, a heads-up, a reply). It sends exactly the text the client approved, as the client, to their own gestor in the Kuotia portal, where the gestor answers; it cannot be unsent. Show the final text and get the client's confirmation before calling. Recommend sending documents, identity numbers (DNI, NIF, NIE) and bank details through the Kuotia portal instead of this message; the text is sent as the client writes it. No attachments, and it never reads messages back. Reuse the same idempotency_key when retrying the same message. Do not use for questions general tools answer.

Inputs: body (required), idempotency_key (required), topic, subject, +1 more. Returns: object

kuotia_action_receiptsComprobar accionesA
Read-onlyIdempotent
Inspect

Use this after a message sent with gestoria_send_message, or another write made through this connection, had an uncertain outcome (a timeout or an error), to see whether it completed before trying again. Never repeat an uncertain action with a new idempotency_key before checking. It lists only this connection's own actions, never message text.

Inputs: page, receipt_id, idempotency_key. Returns: receipts

kuotia_estimate_net_incomeEstimar neto anual de autónomoA
Read-onlyIdempotent
Inspect

Use this when an autónomo in mainland Spain or Baleares asks roughly how much IRPF and cuota de autónomos they would pay in a year and how much they would keep, from yearly income, expenses and comunidad autónoma. Income and expenses are yearly amounts without recoverable VAT and without their own cuota de autónomos (the tool adds the cuota). Assumes a full year in estimación directa simplificada, individual filing, no other income, and the minimum cuota of their tramo unless they give theirs. An annual estimate, not a quarterly modelo 130 or 303 amount, and without regional deductions. tipo_medio_irpf is the IRPF over gross income. Do not use for employees, companies, Canarias, País Vasco, Navarra, Ceuta or Melilla, or a connected client's real returns.

Inputs: year (required), region (required), annual_income (required), annual_expenses (required), +3 more. Returns: object

kuotia_estimate_retaEstimar cuota de autónomosA
Read-onlyIdempotent
Inspect

Use this when someone asks how much cuota de autónomos (RETA, Seguridad Social) they would pay in Spain, or which tramo applies, from expected yearly income and expenses. Assumes a full year of activity as a persona física autónoma (not societario) in estimación directa simplificada of the common IRPF, income and expenses without recoverable VAT and without their own cuota, the 5 % allowance for gastos de difícil justificación (at most 2,000 EUR a year) and then the general 7 % deduction for generic expenses. The tramo table is the same in all of Spain, but the rendimiento is computed with these common-regime rules: under módulos, estimación directa normal or the foral IRPF of País Vasco and Navarra the tramo may differ. Does not decide whether they qualify for the tarifa plana. Do not use for employees, for companies or for a connected client's real payments.

Inputs: year (required), annual_income (required), annual_expenses (required). Returns: object

kuotia_get_autonomo_guideGuía de autónomosA
Read-onlyIdempotent
Inspect

Use this when someone asks how to become autónomo in Spain (alta in Hacienda with modelo 036 and in the RETA), what an autónomo files each quarter and year, how IVA, IRPF retención and the cuota de autónomos work, what an invoice must contain, what a gestoría or gestor does, whether an autónomo needs one and what to check when choosing one (topic need_gestoria), or how to change gestoría. Returns short statements, each with its official source and review date. Modelo 037 no longer exists (abolished in February 2025). Do not use for personal legal advice, companies or non-Spanish taxes.

Inputs: topic (required). Returns: object

kuotia_get_tax_calendarConsultar plazos fiscalesA
Read-onlyIdempotent
Inspect

Use this when someone asks until when an autónomo in Spain can file or pay a specific tax return (modelo 303 IVA, 130 IRPF, 111, 115, 390, 347, 180, 190 or 100 renta) for a given tax period, or the last day to pay it by domiciliación. Give the modelo and the tax period it declares (for example 303 for 2026-T3, or 100 for tax year 2025), not the filing year. Only periods whose dates Kuotia has checked against the AEAT calendar are answered; others return not_verified with the official rule. Mainland Spain and Baleares only. Do not use for a connected client's own status (gestoria_get_tax_status) or for other countries.

Inputs: modelo (required), period (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides access to official Spanish fiscal data and tools based on AEAT and BOE sources, covering income tax, VAT, and regional deductions. It enables AI assistants to answer tax-related queries and verify filing deadlines using verified information.
      10
      32 npm
      13
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Spanish accounting for freelancers and SMEs, enabling AI agents to issue invoices, OCR expense PDFs, reconcile bank transactions, and prepare quarterly VAT (Modelo 303).
      23
      4
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables labor and Social Security professionals to automate Spanish payroll and HR compliance workflows, including NOMINASOL procedures, SILTRA/FIE/FDI and CRA file processing, contribution and bonus calculations, SEPE contract and certificate queries, accident reporting deadlines, garnishment calculations under Art. 607 LEC, and sanction deadline tracking. It also lets users manage a local deadlines agenda with Slack alerts and Notion synchronization.
      -
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources