graphite-mcp

MCP server for the Graphite Financial Knowledge Graph — wires the graph into Claude Code, Claude Desktop, Cursor, Codex CLI, and any other MCP-compatible client.

Your Claude / agent does the reasoning. Graphite answers the graph questions it asks for. No LLM tokens are billed by Graphite — you bring your own LLM (subscription or API key); we only serve graph data.

Install

pip install graphite-mcp

Or from source:

git clone https://github.com/GraphiteAI/graphite-mcp
cd graphite-mcp
pip install -e .

Get a Graphite key

Free tier — 100 graph queries / month — at: https://graph.graphite-ai.net/#/portal

Sign up with your email; you get back a key like sk-….

Chat-with-the-graph in the web portal is BYOK — you bring your own Anthropic or OpenAI key (it stays in your browser). Or skip the portal and use this MCP server with your Claude / ChatGPT subscription, no API key needed on the LLM side at all.

Configure your client

Same JSON shape works for every MCP client; only the file path differs.

{
  "mcpServers": {
    "graphite": {
      "command": "graphite-mcp",
      "env": {
        "CENTRAL_SERVER_URL": "https://api.graphite-ai.net",
        "CUSTOMER_API_KEY": "sk-your-graphite-key"
      }
    }
  }
}

Client	Config path
Claude Code	~/.claude/mcp.json
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
Cursor	~/.cursor/mcp.json
Codex CLI	~/.codex/config.json

Restart your client after editing.

If you installed from source and don't want to put the package on PATH, replace the command line with:

"command": "python",
"args": ["-m", "graphite_mcp"],

Available tools

Once configured, Claude can call these tools to answer questions about companies, supply chains, executives, regulations, and patents.

Tool	Purpose
search_entities	Free-text search by name, ticker, sector, or description
get_entity	Full record for one entity by ID (e.g. company:NVDA)
get_relationships	Every edge attached to an entity (employs, supplies, depends_on, …)
get_facts	Typed fact log for an entity (revenue, headcount, etc.)
find_path	Shortest path between two entities through the graph
exposure_analysis	1st + 2nd-degree neighborhood, sector breakdown — supply-chain risk view
compare_entities	Shared connections + path distance + direct relationships between two

Example prompts

After setup, just ask Claude:

• "What's NVIDIA's supply-chain exposure to TSMC?"
• "Find the shortest path from company:AAPL to company:ASML."
• "Compare Microsoft and Google — who do they share board members with?"
• "List every revenue-from edge for NVDA."

Claude will pick the right tool, call this MCP server, and ground its answer in real graph data.

How it works

your Claude          graphite-mcp           api.graphite-ai.net
─────────────       ────────────────       ─────────────────────
"NVDA exposure?" ─→ exposure_analysis ─→  GET /graph/exposure
                    (this package)         (returns JSON)
                                       ←─
              ←─    formatted answer

The MCP server is a thin stdio adapter — it doesn't store anything, doesn't see your prompts, doesn't bill you. All the value lives in the graph at api.graphite-ai.net.

Env vars

Var	Default	Notes
CENTRAL_SERVER_URL	http://localhost:8000	Override to use a different Graphite deployment
CUSTOMER_API_KEY	(empty)	Required — issued at https://graph.graphite-ai.net/#/portal

License

MIT. Use freely, modify freely, no warranty.