MCP for Spanish tax procedures.
Connect your AI agent to Melso to read your tax records, organise invoices and prepare work for Spanish tax procedures. Access uses OAuth; approvals and filing are handled in Melso.
Your AI + Melso
expenses · listYour expenses, in context.
- Software
- €480.00
- Work supplies
- €320.00
- Professional services
- €650.00
- Total recorded
- €1,450.00
What you can do with Melso MCP.
Check your expenses.
Read this quarter’s records and retrieve the details behind each expense.
expenses · list, get
“Summarise my second-quarter expenses by category.”
Record a supplier invoice.
Add an expense to your books from its details or from a document.
expenses · create, from_document
“Record this supplier invoice as an expense and show me the result.”
Prepare an invoice.
Create a draft with your customer and line items. Issuing it requires your approval in the Melso web app.
invoices · prepare, request_approval
“Prepare an invoice for this month’s work and send me the draft to review.”
Read your tax calendar.
Check deadlines and read the returns available for your tax profile, such as modelo 303 for VAT and modelo 130 for income tax.
taxes · calendar, list, get
“Show my next tax returns and explain my modelo 303 draft.”
Available actions depend on your tax profile and your account’s current access to the tools.
How to connect Claude Code, Cursor or Codex.
Choose a client that supports remote MCP and OAuth. These examples use Melso’s hosted server. Settings → Connect your AI has the URL and command for your own account.
Set up your account.
Create your Melso account and confirm its tax profile. Already use Melso? Open Settings → Connect your AI.
Add Melso to your client.
Run the Claude Code or Codex command. For Cursor, add the configuration to .cursor/mcp.json and keep any servers you already have.
Authorise the connection.
Finish signing in to Melso in your browser and choose the company this connection will work in. Check that your client lists the Melso tools before you start.
Melso configuration
Remote server · Streamable HTTP
Run this command in your Claude Code terminal.
claude mcp add --transport http melso https://mcp.melso.ai/mcpComplete browser authorisation before using the tools.
AI prepares. You decide.
Your client can read records and prepare work using the tools available to your account. You approve invoice issuance and authorise tax filing in the Melso web app.
Melso and its professionals review and file your included returns with Spain’s tax agency, the AEAT, after your approval. An MCP client cannot approve, file or pay your taxes.
Questions about MCP and Spanish taxes.
An MCP server for Spanish taxes lets an AI client use tax-related tools through the Model Context Protocol. Melso MCP connects your AI to your expenses, invoices and tax calendar in Melso. You sign in through OAuth, and the connection retains your account’s permissions.
A Melso account with a confirmed self-employed tax profile and current access to the tools. Your client receives only the actions available to your account. Connecting MCP does not add permissions or extend your tax service’s scope.
Your client needs to support remote MCP over Streamable HTTP and OAuth authorisation. This page provides the configuration for Claude Code, Cursor and Codex. Check that your client version supports that connection.
An MCP client cannot approve, file or pay tax returns. It can read your tax calendar and the drafts available for your profile. You authorise the exact version in the Melso web app. Melso and its professionals review and file your included returns; filing is evidenced by the actual receipt from Spain’s tax agency, the AEAT.
Melso MCP is operated by Melso, not by Spain’s tax agency, the AEAT. It works with your tax records in Melso. Melso’s tax service and its professionals file your included returns with the AEAT after your approval and with the required authority.
From the records of the company you choose when authorising the connection: expenses, invoices and returns stored in Melso. Each connection works in one company. The server checks access on every call; a different company needs a separate connection.
Settings → Connect your AI lists your authorised connections and the company each one can access. Revoke access there at any time. To work in a different company, create another connection and choose it during authorisation.
A tax service that fits how you work.
Get started with Melso for your tax work in Spain, then connect your AI from Settings → Connect your AI.