# Developer MCP

## Introduction

Developer Tools Only
The Developer MCP is built for developer tools like Claude Code, Codex, OpenCode, Cursor, and VS Code. It isn't available in the Claude app yet.

The Developer MCP exposes this developer portal through the Model Context Protocol (MCP), and once connected, your AI assistant can:

- Scaffold your integration using working code examples and best practices from this portal
- Explain what a specific API error means and how to resolve it
- Browse the structure of Belvo's API reference
- Look up a specific endpoint's parameters, request body, and responses
- Read authentication and security scheme details
- Search this documentation site's content


This means you can ask your assistant questions like "Which endpoint retrieves transactions for a Link?" or "What security scheme does the Payments API use?" and it can answer directly from Belvo's official docs.

No authentication is required. The Developer MCP is public, the same as this developer portal.

Read-Only Access
The Developer MCP only exposes this public developer portal. It can't access your Belvo account, credentials, or any customer data, and it can't make API calls on your behalf. We're actively expanding what the Developer MCP can do, so check back for updates.

## Connect with one click

If your client is Cursor or VS Code, use the button below to connect directly, or copy the server configuration to paste into any other client:

## Manual setup

For clients without a one-click option, add the server manually using its URL:

```shell MCP Server URL
https://developers.belvo.com/mcp
```

Claude Code
Run the following command in your terminal:

```shell Add the Developer MCP server
claude mcp add --transport http belvo-docs https://developers.belvo.com/mcp
```

Alternatively, add it directly to your project's `.mcp.json`:

```json .mcp.json
{
  "mcpServers": {
    "belvo-docs": {
      "type": "http",
      "url": "https://developers.belvo.com/mcp"
    }
  }
}
```

Codex
Add the following block to `~/.codex/config.toml`:

```toml ~/.codex/config.toml
[mcp_servers.belvo_docs]
url = "https://developers.belvo.com/mcp"
```

OpenCode
Add the following to your `opencode.json`:

```json opencode.json
{
  "mcp": {
    "belvo-docs": {
      "type": "remote",
      "url": "https://developers.belvo.com/mcp",
      "enabled": true
    }
  }
}
```

Cursor
Add the following to `.cursor/mcp.json` in your project, or `~/.cursor/mcp.json` to make it available in every project:

```json .cursor/mcp.json
{
  "mcpServers": {
    "belvo-docs": {
      "url": "https://developers.belvo.com/mcp"
    }
  }
}
```

VS Code
Add the following to `.vscode/mcp.json` in your workspace, or run **MCP: Open User Configuration** from the Command Palette to make it available in every workspace:

```json .vscode/mcp.json
{
  "servers": {
    "belvo-docs": {
      "type": "http",
      "url": "https://developers.belvo.com/mcp"
    }
  }
}
```

## Feedback

Found an issue with the Developer MCP? Let us know using the feedback widget below, and include your email in the comment so we can follow up.