# Connect AI assistants

Connecting an AI assistant to the Ripple Docs [MCP](https://modelcontextprotocol.io)
server lets it search this documentation and read current pages — API reference,
payload examples, and release-specific behavior — before it answers. The server
covers all products on `docs.ripple.com`, including Ripple Custody (Wallet),
and requires no authentication:

```text
https://docs.ripple.com/mcp
```

## Claude Code

```bash
claude mcp add --transport http ripple-docs https://docs.ripple.com/mcp
```

## Cursor

Open the command palette (**Cmd+Shift+P**, or **Ctrl+Shift+P** on Windows and
Linux), select **Open MCP settings**, then **Add custom MCP**, and add the
server to `mcp.json`:

```json
{
  "mcpServers": {
    "ripple-docs": {
      "url": "https://docs.ripple.com/mcp"
    }
  }
}
```

## VS Code

Add the server to `.vscode/mcp.json` in your workspace:

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

## Other clients

Most MCP clients accept the same URL — consult your tool's documentation for how
to register a remote MCP server over HTTP. If the client offers a choice, add the
server as a plain HTTP MCP server rather than as an authorized connector.

## Troubleshooting

**Your client asks you to sign in.** The server needs no credentials, so dismiss
the prompt. Clients that require an OAuth sign-in before they list tools,
including claude.ai custom connectors, cannot connect at all — use Claude Code,
Cursor, or VS Code instead.

**Your client lists only `authenticate` and `complete_authentication`.** Those
belong to the client's own authorization layer, not to this server. A working
connection exposes `search`, `list-apis`, `get-endpoints`, `get-endpoint-info`,
`get-security-schemes`, and `get-full-api-description`.

**Check the server directly.** This returns `"name": "Ripple Docs MCP server"`
without credentials. Both `Accept` types are required; without them the server
responds `406 Not Acceptable`.

```sh
curl -sS -X POST https://docs.ripple.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"probe","version":"1.0"}}}'
```

## Context7

This documentation is also indexed by [Context7](https://context7.com), which
serves version-current docs to tools with the Context7 integration. Add the
[Context7 MCP server](https://github.com/upstash/context7) to your tool, then
reference the library ID `/websites/ripple_products_wallet` in your prompt, or
view the [entry on Context7](https://context7.com/websites/ripple_products_wallet).

Both integrations are read-only views of the public documentation. They do not
provide access to your Ripple Custody (Wallet) organization, wallets,
vaults, or any customer data, and you cannot execute API operations through
them.