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

# MCP Quickstart

> Connect an AI assistant to the Blockworks MCP server and run your first prompt in a few minutes.

This page takes you from nothing to an assistant answering questions with Blockworks data. Setup is the same for
every client: one URL, one browser sign-in.

<Steps>
  <Step title="Get an API key">
    Sign in at [app.blockworks.com/account/api](https://app.blockworks.com/account/api) and copy an API key.

    You need the key only once, during the OAuth step below. It is not stored in any config file on your machine.
  </Step>

  <Step title="Add the server to your client">
    Point your MCP client at the hosted server URL:

    ```
    https://mcp.blockworks.com/mcp
    ```

    In Claude Code, that is a single command:

    ```bash theme={null}
    claude mcp add --transport http blockworks https://mcp.blockworks.com/mcp
    ```

    Every other client is a settings screen or a small JSON block. See [Client setup](/mcp/clients) for the exact
    steps for Claude, Claude Desktop, Cursor, ChatGPT, and generic MCP clients.
  </Step>

  <Step title="Authenticate in the browser">
    The first time your client connects, it detects that the server requires authentication and opens a browser
    window. Enter your Blockworks API key there to complete the OAuth flow.

    Your client stores the resulting OAuth credentials and reuses them on later connections, so you only do this
    once per client.

    <Note>
      If no browser window appears, check that popups are not blocked and that your client supports remote MCP
      servers with OAuth 2.0. See [Troubleshooting](/mcp/troubleshooting).
    </Note>
  </Step>

  <Step title="Confirm the tools are loaded">
    Ask your assistant:

    ```text theme={null}
    What Blockworks tools do you have available?
    ```

    It should list the five Blockworks tools it can call: `search_documents`, `tabular_catalog`, `tabular_data`,
    `timeseries_catalog`, and `timeseries_data`. See the [tools reference](/mcp/tools/overview) for what each one
    does.

    If the list is empty, the connection or the OAuth step did not complete. Reconnect the server and try again.
  </Step>

  <Step title="Run your first prompt">
    Try a lookup that clearly needs live data:

    ```text theme={null}
    What is Bitcoin's current price and 24h trading volume?
    ```

    Then something with more shape to it:

    ```text theme={null}
    Compare Ethereum and Solana daily active addresses over the last 90 days,
    and summarize what changed.
    ```

    Your assistant should call a Blockworks tool and answer from the returned data rather than from memory.
  </Step>
</Steps>

## Where to go next

<CardGroup cols={3}>
  <Card title="Client setup" icon="adjustments" href="/mcp/clients">
    Per-client configuration, including JSON config formats.
  </Card>

  <Card title="What to ask" icon="messages" href="/mcp/prompts">
    Prompt patterns that get the best results.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/mcp/troubleshooting">
    Auth loops, invalid keys, and stale credentials.
  </Card>
</CardGroup>