# MCP quickstart

The service exposes a stateless MCP server over Streamable HTTP at `https://api.criptonlabs.com/mcp`. There is no session and no authentication. `GET https://api.criptonlabs.com/` with `Accept: application/json` returns a JSON index with this MCP URL, the endpoint list and the same documentation links as `/llms.txt`; a browser gets a landing page with the same "Connect via MCP" snippets and copy buttons.

## Connect

The server needs no authentication. Use the URL `https://api.criptonlabs.com/mcp` and the name `agent-apis` in any client.

### Claude Code

```sh
claude mcp add --transport http agent-apis https://api.criptonlabs.com/mcp
```

Or in `.mcp.json`:

```json
{ "mcpServers": { "agent-apis": { "type": "http", "url": "https://api.criptonlabs.com/mcp" } } }
```

### Claude Desktop and claude.ai

In Customize > Connectors choose + Add > Add custom connector, enter the name `agent-apis` and the URL `https://api.criptonlabs.com/mcp`, and set Authentication to "No sign in". Free plans allow one custom connector; on Team and Enterprise plans the owner adds it in Organization settings > Connectors.

### Cursor

In `~/.cursor/mcp.json` or `.cursor/mcp.json`:

```json
{ "mcpServers": { "agent-apis": { "url": "https://api.criptonlabs.com/mcp" } } }
```

Or open the install link `cursor://anysphere.cursor-deeplink/mcp/install?name=agent-apis&config=eyJ1cmwiOiJodHRwczovL2FwaS5rcmlwdG9uaWFubGFicy5jb20vbWNwIn0=`.

### VS Code and Copilot

In `.vscode/mcp.json`:

```json
{ "servers": { "agent-apis": { "type": "http", "url": "https://api.criptonlabs.com/mcp" } } }
```

### Gemini CLI

```sh
gemini mcp add --transport http agent-apis https://api.criptonlabs.com/mcp
```

The command writes to the project scope by default; add `-s user` for all projects. Or in `settings.json` (`httpUrl` is the streamable HTTP field):

```json
{ "mcpServers": { "agent-apis": { "httpUrl": "https://api.criptonlabs.com/mcp" } } }
```

### Codex CLI

```sh
codex mcp add agent-apis --url https://api.criptonlabs.com/mcp
```

Or in `~/.codex/config.toml`:

```toml
[mcp_servers.agent-apis]
url = "https://api.criptonlabs.com/mcp"
```

### Windsurf

In `mcp_config.json` (`~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows):

```json
{ "mcpServers": { "agent-apis": { "serverUrl": "https://api.criptonlabs.com/mcp" } } }
```

### Zed

In `settings.json`:

```json
{ "context_servers": { "agent-apis": { "url": "https://api.criptonlabs.com/mcp" } } }
```

Zed may show an OAuth prompt when the entry has no Authorization header; this server needs no authentication, so the prompt is not needed.

## Endpoints and views

`/mcp` lists the tools of every network. To load only the tools of one network, use a view: `/mcp/xrpl` lists only the XRPL tools and `/mcp/solana` only the Solana tools. Their paid twins `/mcp/pro` (all tools), `/mcp/pro/xrpl` and `/mcp/pro/solana` follow the payment mode like `/mcp/pro`. A view returns the same payloads as `/mcp` for the tools it lists; a tool of another network is not found on it. Prefer a view when you work on one network only, to save context; prefer `/mcp` when you need both.

## Tools

`xrpl_fee`, `xrpl_latest_ledger`, `xrpl_network_health`, `xrpl_orderbook`, `xrpl_slippage`, `xrpl_amm`, `xrpl_account_summary`, `xrpl_account_lines`, `xrpl_account_transactions`, `xrpl_token`, `xrpl_payment_readiness`, `xrpl_paths`, `solana_transfer_readiness`, `solana_token`, `solana_latest_slot` and `solana_network_health`. Each returns the same body as its REST endpoint (including `meta`) as structured content and as JSON text.

## Behavior

- Errors come back as a tool result with `isError: true` whose text is the problem+json body.
- Every `/mcp` request counts against the `mcp` rate tier; every tool except `xrpl_fee`, `xrpl_network_health`, `xrpl_latest_ledger`, `solana_latest_slot` and `solana_network_health` also counts against the `expensive` tier. See the rate-limits guide.
- Browser origins other than localhost are rejected; use a server-side client.
- The paid twin `/mcp/pro` offers the same tools; see the payments guide for when it is charged.
- Prefer A2A? The same tools are available as skills at `/a2a`; see the A2A guide.

## Try it with curl

```sh
curl -s https://api.criptonlabs.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```