Skip to content

MCP for Spanish tax procedures Your gestoría, in your AI. With your records.

Connect your AI to Melso and work with your expenses, invoices and tax calendar without leaving the chat.

Remote server · Streamable HTTP · OAuth

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 desktop
    1 click
    Opens the connector with Melso already filled in.
  • Claude Code

    In your terminal
    Terminal
    claude mcp add --transport http melso https://mcp.melso.ai/mcp
  • Cursor

    Editor
    Configuration
    Add the entry to .cursor/mcp.json.
  • Codex

    In your terminal
    Terminal
    codex mcp add melso --url https://mcp.melso.ai/mcp
  • Another client

    With remote MCP and OAuth
    URL
    https://mcp.melso.ai/mcp
Already use Melso?Your URL and connections are in Settings.Open Settings → Connect your AI
Let your AI do itPaste these instructions.

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.

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