Skip to main content

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.

​
Overview

Both Cursor and Windsurf support MCP servers, letting you bring live EventGraph data into your development workflow. Query markets, pull price data, and build trading-adjacent applications without ever leaving your editor.

​
Cursor Setup

​
1. Complete the MCP quickstart

MCP Quickstart →

Set up the EventGraph MCP server (5 min)

​
2. Open Cursor MCP settings

Go to Cursor Settings → Features → MCP Servers (or edit ~/.cursor/mcp.json directly).

​
3. Add EventGraph

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

​
4. Restart Cursor

After restarting, open the chat panel (Cmd+L) and you should see EventGraph tools available.

​
Windsurf Setup

​
1. Open Windsurf MCP config

Edit ~/.codeium/windsurf/mcp_config.json: 
{
  "mcpServers": {
    "eventgraph": {
      "command": "node",
      "args": ["/absolute/path/to/eventgraph-mcp/server.js"],
      "env": {
        "EVENTGRAPH_API_KEY": "eg_live_your_key_here"
      }
    }
  }
}

​
2. Restart Windsurf

Cascade (Windsurf’s AI) will pick up the new server on restart.

​
Other MCP clients

The same config pattern works for any MCP-compatible client:
ClientConfig file
Continue.continue/config.json → mcpServers block
VS Code (MCP extension).vscode/mcp.json
Zed~/.config/zed/settings.json → context_servers
Claude Codeclaude mcp add CLI command
For Claude Code (CLI): 
claude mcp add eventgraph \
  --command node \
  --args /path/to/eventgraph-mcp/server.js \
  --env EVENTGRAPH_API_KEY=eg_live_your_key

​
Use cases in a coding context

Building a trading dashboard? 
Pull the current order book for the top 5 most-traded Kalshi markets
and generate TypeScript types for the response structure.
Writing analysis scripts? 
Fetch price history for market ID abc123 over the last 30 days
and generate a Python script to plot it with matplotlib.
Researching an API integration? 
Search for all active sports markets and show me the structure
of a market object so I can design my database schema.

​
Troubleshooting

  1. Check Cursor version — MCP requires Cursor 0.43+
  2. Verify the JSON in ~/.cursor/mcp.json is valid
  3. Use an absolute path (not ~ or relative paths) for server.js
  4. Check Cursor Settings → MCP to see server status
This usually means an unhandled error in the server. Check your Node.js version (node --version should be 18+) and ensure the server.js file is complete and unmodified.