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.
Metadata
Release files for graphite-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| graphite_mcp-0.1.1.tar.gz | 5.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| graphite_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 12.6 kB
Release files / graphite_mcp-0.1.1.tar.gz
| Download URL | graphite_mcp-0.1.1.tar.gz |
|---|---|
| Size | 5.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
70ec5deb3b3e530908fdb0e8e94953ca3f5c463692f997eded639cbd01c5d569
|
|
BLAKE2b-256 checksum How to use checksums |
38e6f6bd73617529d0dd1427d19be2e2400351a1a5bae603509352c7a99b7b49
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 19, 2026.
Transparency logRelease files / graphite_mcp-0.1.1-py3-none-any.whl
| Download URL | graphite_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 6.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
62f22d668ffa9e3fef4b1e426c62b8edd6978899565db85fcf797c754c365355
|
|
BLAKE2b-256 checksum How to use checksums |
2fcd58c42fe9123d3eacb46f668a126854e2d4771b3b5cfae06d8e304c287919
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 19, 2026.
Transparency log