Connect it in a minute. Choose your assistant.
One URL. Sign in with your Melso account, choose the company and you’re done.
Claude
Web and desktop1 clickOpens the connector with Melso already filled in.Claude Code
In your terminalTerminalclaude mcp add --transport http melso https://mcp.melso.ai/mcpCursor
EditorConfigurationAdd the entry to .cursor/mcp.json.Codex
In your terminalTerminalcodex mcp add melso --url https://mcp.melso.ai/mcpAnother client
With remote MCP and OAuthURLhttps://mcp.melso.ai/mcp
What you can ask. The way you’d say it.
- expenses_read · list, get
Check your expenses.
The quarter, and the details of every expense.
- expenses · from_document
Record a supplier invoice.
From its details or from the document.
- invoices · prepare, issue
Draft and issue invoices.
It saves the draft. It issues it only if you, as the owner, ask for that exact version. Available once your company sends its invoices to VERI*FACTU, with its certificate authorized.
- taxes · calendar, list, get
Read your tax calendar.
Deadlines and returns, such as modelo 303 and 130.
One click copies the prompt. Available actions depend on your tax profile and your plan; your AI never approves, files or pays your taxes.
- With your permissionSign in with your Melso account. No keys to copy.
- One company per connectionYour AI only works with the company you choose.
- Disconnect it any timeIn Settings → Connect your AI.
MCP tax tools reference · 30
Your client gets these tools for the company you authorise. Each tool groups its actions, and your client only sees the ones your account allows.
- company
- Read the company the connection works in: its name, whether you are self-employed or a company, and whether your setup is still pending.
- contacts_readlist, get
- Find customers and suppliers and read the records associated with each contact.
- contactsupsert, merge, delete
- Save, merge or delete contacts. A merge combines their roles and details and preserves historical associations without changing issued invoices.
- invoices_readget, request_approval, list
- Read invoices, outstanding balances and registration, PDF and delivery states. request_approval opens review in the app. Available once your company sends its invoices to VERI*FACTU, with its certificate authorized.
- invoicesprepare, issue, correct
- Prepare drafts or corrections. Where the account and server allow it, the owner can authorize issuance of the exact saved version with id and expected_version. request_approval offers web review. Check registration, PDF and delivery states before reporting completion. Available once your company sends its invoices to VERI*FACTU, with its certificate authorized.
- paymentsmark_paid
- Mark an issued invoice as paid. It never charges or moves money. Available once your company sends its invoices to VERI*FACTU, with its certificate authorized.
- expenses_readlist, get, document_status
- Find expenses by counterparty, number, dates or payment status. Read full details and document processing states.
- expensescreate, from_document, update, upload, delete
- Record and correct expenses, including from an invoice or a receipt, and the euros you paid for one in another currency.
- income_readlist, get
- Read income invoiced outside Melso and its tax details.
- incomeupdate, delete
- Correct your recorded income, and the euros you received for one in another currency.
- taxescalendar, list, get, request_approval, aeat_file
- Read your tax calendar and the returns Melso calculates, and open their approval in the web app.
- accounting_readjournal, proposals, trial_balance, statements, corporate_tax, stock_count, subaccounts, assets, asset, asset_preview, entry, opening_balance_preview
- For a company: read its posted journal, pending proposals and blockers by year, balances, annual accounts, corporate tax, stock count, subaccounts and assets.
- accountingautomate, post, corporate_tax_update, corporate_tax_filed, stock_count_set, subaccount_set, subaccount_delete, asset_create, asset_update, asset_dispose, asset_disposal_undo, asset_delete, entry_create, entry_update, entry_delete, opening_balance
- For a company: run automatic bookkeeping, reconcile verified matches and post valid source entries. Corrections append entries in open periods and report actual blockers. Also keep adjustments, the stock count, assets and manual proposals; post records one exact saved manual adjustment.
- bank_readaccounts, movements, movement, documents
- For a company: read accounts, bank movements and the documents proposed for reconciliation.
- bankaccount_update, reconcile, unreconcile
- For a company: map its bank accounts to ledger accounts and reconcile movements from verified evidence: invoices, a tax paid or refunded, a loan, capital or a transfer between its accounts.
- bank_statements_readread
- For a company: inspect a bank statement before importing it.
- bank_statementsimport, upload
- For a company: upload a bank statement (Norma 43, CSV, Excel or PDF), saved only when it adds up.
- book_imports_readread, list
- For a company: inspect its books and list saved imports.
- book_importsimport, upload, delete
- For a company: upload the journal, VAT books or list of subaccounts from its previous program, and the employees and paid payrolls from its payroll program, and import them whole or not at all.
- payroll_reademployees, preview, runs, run, payslip, contracts, contract_document, contract_submissions, settings, documents, changes, file, red_responses, siltra_files, liquidations, leaves, request_approval
- For a company with the payroll service: read employees and their history, their contracts and the company's labour data, cost a contract without saving anything, read each month's payslips, check what the written contract still needs, read each employee's documents (signed contract, agreement and documento informativo) and download the official files (payslips, SEPA order, Sistema RED, Contrat@, Certific@2) and reconcile each month's SILTRA responses employee by employee, with the errors explained and the file that fixes each difference, and list the sick leaves the INSS reported in the FIE.
- payrollemployee_create, employee_update, run_create, payslip_update, recalculate, run_delete, approve, reopen, paid, unpaid, contract_create, contract_update, contract_delete, contract_submit, settings_update, document_record, siltra_file_generate, red_response_import, fie_import
- For a company with the payroll service: add employees with their modelo 145 and contracts, keep the labour data, open the month (a late one too), record overtime, leave, variable pay or a settlement (finiquito), record the delivery of the documento informativo and, when the person asks, approve, reopen or mark the month paid at the version they reviewed. To import a SILTRA response or the INSS's FIE of sick leaves, it gives the link to the month or to Bajas, where the person uploads the file.
- gestiones_readlist, get, kinds, request_approval, document_get
- Read case kinds, prices, your cases, versions and documents, and the link to review a version.
- gestionescreate, submit, message, answer, verify_identity, cancel, upload, upload_complete
- Open cases, such as incorporating an S.L., which gets its own company in Melso; follow yours, send messages, provide documents and give each partner their identity verification link. Approve each version and pay in the web app.
- documentslist, get, read, upload, save
- Find your company's documents: issued invoices, quotes, expenses, tax returns with their receipts, deeds, tax ID, registrations and contracts. Search by type, words and dates, read each file and save your own.
- fiscal_profile_readget
- Read the saved tax profile and the details missing from setup.
- fiscal_profileupdate, set_registration, submit_setup
- Complete the company's tax profile and its activities. Owners and admins only.
- mcp_servers_readlist
- Read your company's MCP servers in Melso and whether your Melso agent can use them.
- mcp_serversadd, connect, delete
- Add an MCP server to Melso by its address for your Melso agent to use. Sign-in happens in Melso's web app, and keys never go through your client.
- connect_app
- Ask to connect an app to Melso, such as your Gmail, so Melso finds your invoices. You connect it in Melso's web app.
- support_tickets_create
- Write to Melso's team about a problem or a question, or ask them for a procedure no tool covers.
- Company bookkeeping automation needs accounting access; manual edits keep their plan requirements. Without a plan that includes the tools, you can read your records and save case drafts. Sending them requires a plan that includes the tax service.
- A company that signed itself up on the web and has not paid its plan, or stopped paying it, can only read its records: any other action answers plan_required with the link where the owner pays.
- While you set up your account, only company, fiscal_profile_read, fiscal_profile and support_tickets_create are available.
- An expense or income already covered by a return approved or filed with Melso cannot be deleted; a return your previous adviser filed does not stop it.
Common questions Frequently asked questions.
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. Claude connects in one click with the button on this page; you’ll also find the Claude Code and Codex commands, the Cursor configuration and the URL for any other client. 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 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.
Less paperwork.
More time for you.
Start with Melso or tell us about your case on WhatsApp.
Chat on WhatsApp (opens in a new tab)- No lock-in
- Real professionals
- Mistakes covered