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

# Claude Desktop

> Connect EventGraph to Claude for live prediction market intelligence

## Overview

Claude Desktop supports MCP natively. Once connected, you can ask Claude questions like *"What are the most active Polymarket markets right now?"* and it will fetch live data from EventGraph in real time.

***

## Setup

### 1. Complete the MCP quickstart

First, create and test your `server.js` locally:

<Card title="MCP Quickstart →" icon="bolt" href="/mcp/quickstart">
  Set up the EventGraph MCP server (5 min)
</Card>

### 2. Find your Claude config file

| OS      | Path                                                              |
| ------- | ----------------------------------------------------------------- |
| macOS   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json`                     |

If the file doesn't exist, create it.

### 3. Add the EventGraph server

```json theme={null}
{
  "mcpServers": {
    "eventgraph": {
      "command": "node",
      "args": ["/absolute/path/to/eventgraph-mcp/server.js"],
      "env": {
        "EVENTGRAPH_API_KEY": "eg_live_your_key_here"
      }
    }
  }
}
```

Replace `/absolute/path/to/eventgraph-mcp/server.js` with the actual path to your file. On macOS this might be `/Users/yourname/eventgraph-mcp/server.js`.

### 4. Restart Claude Desktop

Fully quit and reopen Claude Desktop. You should see a **hammer icon** (🔨) in the chat input — click it to confirm the EventGraph tools are listed.

***

## Try it out

Open a new Claude conversation and ask:

```
What prediction markets are active right now related to the US economy?
```

```
Find arbitrage opportunities between Polymarket and Kalshi.
```

```
Show me the price history for the most traded market this week.
```

Claude will automatically call the right EventGraph tool, fetch live data, and incorporate it into its response.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Hammer icon doesn't appear">
    1. Make sure you fully quit Claude (not just close the window) — use Cmd+Q on Mac
    2. Check the config file path is correct and valid JSON
    3. Verify Node.js is installed: `node --version`
    4. Check the absolute path to `server.js` has no typos
  </Accordion>

  <Accordion title="Server listed but tools fail">
    1. Open Claude Desktop logs: **Help → Show Logs**
    2. Look for errors from the `eventgraph` server
    3. Make sure `EVENTGRAPH_API_KEY` is your actual key starting with `eg_live_`
    4. Test the key directly: `curl https://app.eventgraph.ai/api/v1/status -H "X-API-Key: YOUR_KEY"`
  </Accordion>

  <Accordion title="Pro tools return 403">
    The `find_arbitrage`, `compare_markets`, and `get_market_history` tools require a Pro API key. [Upgrade here →](https://app.eventgraph.ai/pricing)
  </Accordion>
</AccordionGroup>

***

## Example conversation

> **You:** What are the biggest prediction markets by volume right now?
>
> **Claude:** *\[calls `search_markets` with sort=volume]*
>
> Here are the top markets by volume across all platforms:
>
> 1. **Will the Fed cut rates in June 2026?** — Polymarket — 67% Yes — \$2.4M volume
> 2. **2026 US House majority** — Kalshi — 54% Republican — \$1.8M volume
> 3. ...

<Note>
  Claude remembers the context across tool calls in a conversation. You can ask follow-up questions like *"How has that first market moved over the last week?"* and Claude will call `get_market_history` automatically.
</Note>