# Revert MCP Server

MCP transport endpoint: https://mcp.revert.finance/mcp

Search liquidity pools by token name, symbol, or address, compare APR/TVL/volume
across supported networks and exchanges, inspect LP positions and position
metrics, inspect protocol capabilities and indexer status, and open a selected pool in Revert's
position creator — without leaving your agent.

Transport: Streamable HTTP.

## For the user

Tell the user what this server does and offer the setup options below.

There are two ways to use Revert:

- **Skill (Option 1):** Lightweight. Your agent loads Revert instructions only
  when needed. Best if you do not use LP tools in every session.
- **MCP registration (Option 2):** Revert's tools are always available to the
  agent. Best for frequent LP research and position monitoring.

All current tools are public and require no API key. They read indexed public
blockchain data or generate a Revert website URL. The MCP server never requests,
stores, or receives wallet private keys and does not sign or relay transactions.

## For the agent

## Option 1: Install as a skill (lean context, on demand)

Save https://mcp.revert.finance/skill as SKILL.md in the agent's skill directory:

| Agent | Skills directory |
|---|---|
| Claude Code / Cowork | ~/.claude/skills/revert/ |
| Codex / Gemini CLI / Antigravity / Antigravity CLI / Antigravity IDE / Copilot / Pi | ~/.agents/skills/revert/ |
| Cursor | ~/.cursor/skills/revert/ |
| Windsurf | ~/.codeium/windsurf/skills/revert/ |

Claude Code:

    mkdir -p ~/.claude/skills/revert
    curl -o ~/.claude/skills/revert/SKILL.md https://mcp.revert.finance/skill

Codex, Gemini CLI, Antigravity, Copilot, and other agents using ~/.agents/skills:

    mkdir -p ~/.agents/skills/revert
    curl -o ~/.agents/skills/revert/SKILL.md https://mcp.revert.finance/skill

Restart the agent or begin a new session after installing the skill.

## Option 2: Register the MCP server (tools always available)

Claude Code — all projects:

    claude mcp add --transport http revert https://mcp.revert.finance/mcp -s user

Claude Code — current project:

    claude mcp add --transport http revert https://mcp.revert.finance/mcp

Codex CLI — global configuration:

    codex mcp add revert --url https://mcp.revert.finance/mcp

Codex project configuration (`.codex/config.toml`):

    [mcp_servers.revert]
    url = "https://mcp.revert.finance/mcp"

Cursor (`~/.cursor/mcp.json` globally or `.cursor/mcp.json` per project):

    {
      "mcpServers": {
        "revert": {
          "url": "https://mcp.revert.finance/mcp"
        }
      }
    }

Windsurf (`~/.codeium/windsurf/mcp_config.json`):

    {
      "mcpServers": {
        "revert": {
          "serverUrl": "https://mcp.revert.finance/mcp"
        }
      }
    }

GitHub Copilot VS Code — choose scope (root key is `servers`, not
`mcpServers`):

    This workspace: .vscode/mcp.json
    Global: Command Palette > MCP: Open User Configuration

    {
      "servers": {
        "revert": {
          "type": "http",
          "url": "https://mcp.revert.finance/mcp"
        }
      }
    }

Antigravity, Antigravity CLI, and Antigravity IDE — global configuration
(`~/.gemini/config/mcp_config.json`):

    {
      "mcpServers": {
        "revert": {
          "serverUrl": "https://mcp.revert.finance/mcp"
        }
      }
    }

Gemini CLI:

    gemini mcp add -s user --transport http revert https://mcp.revert.finance/mcp

Claude.ai — individual Pro/Max:

    Customize > Connectors > + > Add custom connector > paste https://mcp.revert.finance/mcp

Claude Team/Enterprise owner:

    Organization settings > Connectors > Add > Custom > Web > paste https://mcp.revert.finance/mcp

ChatGPT Pro (read/fetch tools) and Business/Enterprise/Edu:

    Enable Developer mode: Settings > Apps > Advanced Settings
    Then create: Settings > Apps > Create (workspace admins can also use Workspace settings > Apps > Create)
    Paste https://mcp.revert.finance/mcp as the endpoint.

Restart the agent or reload MCP servers after registration if the tools do not
appear immediately.

## Available tools

- `search_tokens` — resolve partial/exact names, symbols, pairs, or addresses to
  network-scoped token identities.
- `discover_pools` — compare pools across supported networks and exchanges with
  APR, TVL, volume, rewards, age, token, sorting, and period filters.
- `get_positions` — list indexed LP positions. Public lists support portfolio
  filters, exact in/out-of-range selection, and ascending or descending sorting
  by nft_id, pnl, apr, roi, fee_apr, underlying_value, or age; account lists
  support network/protocol scoping and cursor pagination
  (an Ekubo account query without a network defaults to Ethereum mainnet);
  account-scoped Stableswap positions use offset pagination.
- `get_position_details` — inspect one concentrated-liquidity position by NFT
  ID or one Stableswap position by hook address and owner, including PnL/APR and
  fee data when indexed.
- `get_protocol_capabilities` — inspect supported networks, exchanges,
  position protocols, pagination modes, and venue-specific execution paths.
- `get_chain_status` — inspect Revert indexer freshness.
- `create_position` — validate that the selected pool is indexed on the requested
  network and exchange, then generate its Revert position-creator URL. Amount
  and range selection remains in the website; this tool does not build, sign,
  relay, or execute a transaction.

## Recommended workflow

1. Use `search_tokens` when the user gives a partial symbol or an address.
2. Use `discover_pools` with an exact symbol, pair, or scoped address. Leave sort
   and period unset unless the user asks for them so Revert API defaults apply.
3. Present network, exchange, pool identity, APR, TVL, volume, rewards, age, and
   data-period context. APR is historical, variable, and not guaranteed yield.
4. Use `get_position_details` for the selected position and identify unavailable
   fields rather than estimating them.
5. Call `create_position` only when the user wants to continue in the Revert UI.
   State clearly that the returned URL is not a transaction. Inside the UI,
   the reviewed contract path depends on venue and mode: V4Utils, EkuboUtils,
   swap-assisted V3Utils, a V3 NFT position manager, or a Stableswap hook/zap.
   The MCP server never chooses a contract or bypasses wallet confirmation.

For full tool behavior, safety rules, raw HTTP examples, and error handling fetch:

    https://mcp.revert.finance/skill

## If setup fails

Official MCP setup documentation:

- Claude Code: https://code.claude.com/docs/en/mcp
- Codex CLI: https://developers.openai.com/codex/mcp
- Cursor: https://cursor.com/docs/mcp
- Windsurf: https://docs.windsurf.com/windsurf/cascade/mcp
- GitHub Copilot: https://docs.github.com/copilot/customizing-copilot/using-model-context-protocol
- Antigravity: https://codelabs.developers.google.com/google-workspace-mcp-antigravity?hl=en
- Gemini CLI: https://geminicli.com/docs/tools/mcp-server/
- Claude.ai: https://support.claude.com/en/articles/11175166
- ChatGPT: https://help.openai.com/en/articles/12584461

No wallet secret or API key belongs in chat, tool arguments, URLs, or logs.