Kuotia
Server Details
Spanish tax calendar, RETA and IRPF estimates and guides for autónomos in Spain, by Kuotia.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 9 tools
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.
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.
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.
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 toolsgestoria_get_obligationsVer mis obligaciones del añoARead-onlyIdempotentInspect
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 impuestosARead-onlyIdempotentInspect
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 gestorARead-onlyIdempotentInspect
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 gestorADestructiveIdempotentInspect
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 accionesARead-onlyIdempotentInspect
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ónomoARead-onlyIdempotentInspect
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ónomosARead-onlyIdempotentInspect
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ónomosARead-onlyIdempotentInspect
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 fiscalesARead-onlyIdempotentInspect
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
Fiscalidad, derecho laboral y finanzas de España: IRPF, autónomos (cuota RETA, modelos 130 y 303, gastos deducibles), nóminas de bruto a neto, despidos (indemnización, finiquito, paro), herencias y donaciones por comunidad autónoma, jubilación y pensiones, hipotecas y compraventa de vivienda. Incluye consultas de escenario que combinan varios cálculos a la vez, como haría una gestoría. Gratuito, sin registro ni API key.
The first fiscal MCP server for Spain: IAE/CNAE 2025, AEAT modelos, IRPF/IVA, RETA quota.
Personal finance with balance forecast; VAT and income tax for the self-employed in Spain.
Spanish invoicing (Verifactu/TicketBAI), bookkeeping, bank and tax returns for autónomos and SLs.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides 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.1032 npm13MIT
- AlicenseNot gradedqualityDmaintenanceThe first fiscal MCP server for Spain, connecting AI agents to live IAE, CNAE 2025, AEAT tax-form, and RETA data from official sources.MIT
- AlicenseAqualityCmaintenanceMCP 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).234MIT
- FlicenseNot gradedqualityCmaintenanceEnables 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.-
Glama MCP Gateway
Add one secure layer between your agents and this server.