> ## Documentation Index
> Fetch the complete documentation index at: https://docs.defiorbit.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get started

> Connect an MCP client to the same API key, credits, and rate limit as a direct call.

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](https://platform.defiorbit.xyz/dashboard/keys).

<Tabs>
  <Tab title="Header">
    ```json theme={null}
    {
      "mcpServers": {
        "defiorbit": {
          "url": "https://mcp.orbitcontrol.xyz/mcp",
          "headers": {
            "Authorization": "Bearer <API_KEY>"
          }
        }
      }
    }
    ```
  </Tab>

  <Tab title="Query param">
    ```json theme={null}
    {
      "mcpServers": {
        "defiorbit": {
          "url": "https://mcp.orbitcontrol.xyz/mcp?api_key=<API_KEY>"
        }
      }
    }
    ```
  </Tab>
</Tabs>

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.