# MCP for Spanish tax procedures | Melso

https://melso.ai/en/mcp

Your gestoría, in your AI.

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

## What you can do with Melso MCP.

**Check your expenses.**

The quarter, and the details of every expense.

**Record a supplier invoice.**

From its details or from the document.

**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.

**Read your tax calendar.**

Deadlines and returns, such as modelo 303 and 130.

Available actions depend on your tax profile and your account’s current access to the tools.

## AI prepares. You decide.

Your assistant can draft invoices through MCP and issue them where your account and server-side prerequisites allow. Issuance requires the owner to authorize the exact saved version through their own OAuth connection, a plan with tools and verified issuer authorization. A draft request does not authorize issuance. You can also review and issue in the Melso app; tax returns and cases require approval in the app.

Melso and its professionals review and file your included returns with Spain’s tax agency, the AEAT. An MCP client cannot approve, file or pay your taxes.

## 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.

[Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Melso&connectorUrl=https%3A%2F%2Fmcp.melso.ai%2Fmcp)

Run this command in your Claude Code terminal.

```
claude mcp add --transport http melso https://mcp.melso.ai/mcp
```

Add this entry to your project’s .cursor/mcp.json, keeping your other servers.

```
{
  "mcpServers": {
    "melso": {
      "url": "https://mcp.melso.ai/mcp"
    }
  }
}
```

Run this command in your Codex terminal.

```
codex mcp add melso --url https://mcp.melso.ai/mcp
```

Complete browser authorisation before using the tools.

https://docs.melso.ai/mcp/connect

## Frequently asked questions

**What is an MCP server for 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.

**What do I need to use the tax tools?**

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.

**Can I use any AI client?**

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.

**Can MCP file modelo 303 or 130 with the AEAT?**

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.

**Is Melso MCP an official AEAT server?**

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.

**Where does the data my AI reads come from?**

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.

**How do I disconnect my AI?**

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.
