> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.ripio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect your AI assistant to Ripio through the Model Context Protocol.

The **Ripio MCP Server** lets AI assistants interact with Ripio directly. It exposes Ripio's public APIs through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) — an open standard that lets AI applications discover and use external tools.

Once connected, your assistant can do things like check your wallet balances, review your recent transactions, or send crypto to another address on your behalf — using natural language, without you writing any code.

## Connection URL

Point your MCP client at:

```
https://api.ripio.com/mcp
```

This is a remote, HTTP-based MCP server, so there's nothing to install or run locally.

## Supported clients

Connecting requires an approved MCP client that supports remote (HTTP) servers with OAuth sign-in. The following clients are supported and work out of the box:

| Client                                 | How to add it                                                 |
| -------------------------------------- | ------------------------------------------------------------- |
| **Claude** (Claude.ai and Claude Code) | Add a custom connector / MCP server pointing to the URL above |
| **ChatGPT**                            | Add it as a custom connector                                  |
| **VS Code**                            | Add it as an MCP server in your MCP configuration             |

In most clients you just paste the connection URL — the client handles the rest, including opening Ripio's sign-in page the first time you connect.

<Warning>
  Keep your client (Claude, ChatGPT, or VS Code) up to date. The Ripio MCP server uses a modern OAuth sign-in flow that older client versions don't support — on an outdated client, connecting or authenticating can fail. If you run into connection problems, update your client to the latest version and try again.
</Warning>

### Example: Claude Code

Add the server from your terminal:

```bash theme={null}
claude mcp add --transport http ripio -s user https://api.ripio.com/mcp
```

The `-s user` flag adds the server to your user scope, so it's available across all your projects.

Or add it to your project's `.mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "ripio": {
      "type": "http",
      "url": "https://api.ripio.com/mcp"
    }
  }
}
```

Then run `/mcp` inside Claude Code and choose to authenticate. Claude Code opens Ripio's sign-in page in your browser, where you log in and choose what the assistant can do (see below). Once you approve, the server shows as connected and its tools become available.

## Signing in and granting permissions

You need to sign in with your Ripio account to use the server — it does not connect anonymously. Your client starts a standard, secure OAuth flow for you, so you don't need to register anything or copy any tokens by hand.

During sign-in, Ripio asks what the assistant is allowed to do. You choose a **permission preset**:

| Preset        | What the assistant can do                    |
| ------------- | -------------------------------------------- |
| **Read-only** | View data such as balances and order history |
| **Operate**   | View data and place or cancel orders         |
| **Full**      | Everything above, plus withdrawals           |
| **Custom**    | Pick exactly which permissions to grant      |

You'll also be asked to accept a short liability disclaimer before the connection is authorized. You can review or revoke a connection at any time from your [Ripio account](https://app.ripio.com/profile?tab=mcp).

## What your assistant can do

After connecting, the assistant automatically discovers the tools it's allowed to use, based on the permissions you granted. These mirror Ripio's API endpoints and fall into two groups:

* **Reference data** — supported currencies, networks, and exchange rates. Available on any connection, regardless of the preset you chose.
* **Account actions** — checking your balances, reviewing transactions, sending crypto to an address, making withdrawals (such as PIX or bank transfers), and swapping between currencies. Available only when your preset grants the matching permission.

The assistant picks the right tool for what you ask — you don't need to know tool names or parameters. You can simply ask it to "show my wallet balances" or "list my recent transactions," and it takes care of the rest.