Get started - DeFi Orbit API

DeFi Orbit AI is the MCP server for the DeFi Orbit API: the same position data, exposed as read-only tools for Claude, Cursor, VS Code, and any MCP client. The dashboard MCP page is the source for the live server URL. The production value recorded for that URL is https://mcp.orbitcontrol.xyz/mcp. If the dashboard shows a different URL, use that one. Every tool call is billed and rate-limited the same way as a direct API call with that key. The tools are read-only. Prefer the header config. Use the query-parameter form when the client cannot send custom headers. Replace <API_KEY> with an active key from API Keys.

Header
Query param

{
  "mcpServers": {
    "defiorbit": {
      "url": "https://mcp.orbitcontrol.xyz/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}

{
  "mcpServers": {
    "defiorbit": {
      "url": "https://mcp.orbitcontrol.xyz/mcp?api_key=<API_KEY>"
    }
  }
}

Tools

Tool names match the REST routes. A few that are easy to mix up:

uniswapv3-snapshot is the current health check. uniswapv3-snapshots is one row per UTC day.
aavev3-list-positions omits calculations. aavev3-bundle includes them.
kamino-events is obligation history with a nested snapshot. kamino-snapshots is the performance series.
usage-credits and usage-logs read the organization attached to the key.

The server exposes 52 read-only tools across six protocols, plus portfolio and usage. The full list is on the dashboard MCP page, limited to tools that are turned on.

​Tools

Tools