SEAL in your AI tool

Add SEAL to Claude, ChatGPT or Codex. Your own AI then gets our cited lessons, the glossary and live ledger lookups.

It is read-only. Nothing signs, sends or moves funds. You sign in with your xrpl.fyi account, so it can also tell you your own progress. This uses MCP, the Model Context Protocol, the standard way AI tools add new skills.

Server URL

MCP server
https://mcp.xrpl.fyi/mcp

No API key. Sign in when your app opens xrpl.fyi, then click Allow.

Set it up

Claude Code

  1. Run one of the commands below.
  2. In Claude Code, type /mcp, pick xrpl-fyi and choose Authenticate.
  3. Sign in when your app opens xrpl.fyi, then click Allow.
Run in your terminal
claude mcp add --transport http xrpl-fyi https://mcp.xrpl.fyi/mcp
Or for every project
claude mcp add --transport http xrpl-fyi --scope user https://mcp.xrpl.fyi/mcp

Then /mcp shows it as connected. Claude Code keeps you signed in.

Claude Code MCP docs

Claude (web and desktop app)

  1. Open Customize, then Connectors.
  2. Click Add, then Add custom connector.
  3. Name it xrpl-fyi and paste the server URL. Click Continue.
  4. For Authentication, pick Sign in now. Keep the recommended OAuth client. Click Add.
  5. Sign in when your app opens xrpl.fyi, then click Allow.
  6. In a chat, turn it on from + then Connectors.
Server URL
https://mcp.xrpl.fyi/mcp

Works on every plan. Free plans can add one custom connector. On Team and Enterprise, an Owner adds it first in Organization settings, then Connectors. Members then click Connect.

Custom connectors

Codex (CLI, IDE and app)

  1. Add the server with the command or the config below.
  2. Run codex mcp login xrpl-fyi. In the IDE or app, click Authenticate instead.
  3. Sign in when your app opens xrpl.fyi, then click Allow.
Run in your terminal
codex mcp add xrpl-fyi --url https://mcp.xrpl.fyi/mcp
Or add to ~/.codex/config.toml
[mcp_servers.xrpl-fyi]
url = "https://mcp.xrpl.fyi/mcp"

The Codex CLI, the IDE extension and the app share this config file.

Codex MCP docs · config.toml reference

ChatGPT

  1. On ChatGPT on the web, go to chatgpt.com/plugins.
  2. Click +, then Add custom MCP server.
  3. Enter a name and a short description.
  4. Under Connection, paste the server URL. For authentication, pick OAuth.
  5. Read the warning and click I understand and want to continue.
  6. Click Create as a plugin.
  7. Sign in when your app opens xrpl.fyi, then click Allow.
  8. In a new chat, type @ and pick it.
Server URL
https://mcp.xrpl.fyi/mcp

Custom MCP servers depend on your ChatGPT plan and workspace settings. On Business and Enterprise, an admin may need to turn them on first.

Connect to ChatGPT · Apps SDK auth

Cloud and remote agents

Claude Code on the web

  1. Commit this .mcp.json to the root of your repo. Cloud sessions load it.
  2. In the environment settings, set Network access to Limited and add mcp.xrpl.fyi to Allowed domains. Or use Full.
.mcp.json
{
  "mcpServers": {
    "xrpl-fyi": {
      "type": "http",
      "url": "https://mcp.xrpl.fyi/mcp"
    }
  }
}

A cloud session can’t open a browser to sign in. Add SEAL as a Claude connector (above) and sign in there. Connectors work in cloud sessions.

Claude Code on the web · Cloud environments

Codex cloud

OpenAI's docs for Codex cloud tasks don't cover MCP servers yet. Use Codex in the CLI, IDE or app.

Codex cloud environments

Any MCP client

mcp.json or .mcp.json
{
  "mcpServers": {
    "xrpl-fyi": {
      "type": "http",
      "url": "https://mcp.xrpl.fyi/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "xrpl-fyi": {
      "type": "http",
      "url": "https://mcp.xrpl.fyi/mcp"
    }
  }
}

The server speaks Streamable HTTP and asks for sign-in with standard MCP OAuth. Apps that support it open xrpl.fyi in your browser. No API key.

VS Code MCP config · Cursor MCP docs

What you allow

  • Read lessons and ledger data. Always on.
  • See your learning progress, XP and badges. You can turn this off on the Allow page.

It can\u2019t change anything, sign or send. Connected apps

Try asking

  • Teach me trust lines in simple words.
  • What is the owner reserve, and how much XRP does it lock?
  • Explain this account: rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De
  • How close is LendingProtocol to passing?
  • What changed on the XRP Ledger this week?

Tools

Lessons
search_knowledge, find_lessons, read_lesson, define_term
Live ledger
get_account_overview, get_trust_lines, get_nfts, get_amm_pool, explain_transaction, get_ledger_stats
Votes and news
get_amendment_status, list_changes
Projects
lookup_project, token_info, collection_info
Your progress
my_progress, my_xp, my_badges, my_next_lesson

Every answer lists its sources with links back to xrpl.fyi and the date each was checked.

Limits

  • Read-only. No tool signs, sends or moves funds.
  • SEAL never asks for a secret key, seed or recovery phrase. Tools refuse text that holds one.
  • Sign in with your xrpl.fyi account. Disconnect any app in Settings, under Connected apps.
  • Up to 200 tool calls every 10 minutes per account and per IP, and 1,500 a day per IP.
  • Live ledger lookups: up to 40 every 10 minutes per IP.
  • No price talk or buying advice.

Rather ask here? Ask SEAL