Skip to main content

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)

Source distribution for graphite-mcp 0.1.1
File Size Uploaded
graphite_mcp-0.1.1.tar.gz 5.9 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for graphite-mcp 0.1.1
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page