# MaterialsCodeGraph

> MaterialsCodeGraph runs materials simulations for AI agents over MCP, with a binding token quote before every run and a permanent record after it.

- MCP endpoint: https://api.materialscodegraph.com/mcp (Streamable HTTP, POST-only JSON-RPC; header Authorization: Bearer <mcg_sk_ key>)
- Registry: com.materialscodegraph/mcg at https://registry.modelcontextprotocol.io/v0.1/servers?search=materialscodegraph
- Tools (twelve): mcg_catalog, mcg_rates, mcg_quote, mcg_clusters, mcg_stage, mcg_run, mcg_list_runs, mcg_get_study, mcg_get_run, mcg_cancel_run, mcg_fetch_artifacts, mcg_get_artifact
- Key scopes: read, quote, spend; a spend key carries a finite daily_token_cap
- Rates: https://api.materialscodegraph.com/api/rates (version 6, token_usd 0.001 on 2026-10-07)
- Kinds: https://api.materialscodegraph.com/api/kinds

## Connect

Claude Code:
claude mcp add --transport http mcg https://api.materialscodegraph.com/mcp --header "Authorization: Bearer $MCG_MCP_KEY"

Codex:
codex mcp add mcg --url https://api.materialscodegraph.com/mcp --bearer-token-env-var MCG_MCP_KEY

Other clients:
curl -s https://api.materialscodegraph.com/mcp -H "Authorization: Bearer $MCG_MCP_KEY" -H "content-type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mcg_rates","arguments":{}}}'

## Pages

- https://materialscodegraph.com/ (sections: How an agent uses it, From the catalog, The record, Pricing, Connect)
- https://materialscodegraph.com/fixtures/quote-2026-09-19.json (a captured mcg_quote response)
- https://materialscodegraph.com/fixtures/record-2026-10-07.json (a captured run record)
- https://materialscodegraph.com/fixtures/record-raw-2026-10-07.json (the mcg_get_run response it was cut from)
- https://materialscodegraph.com/terms.html
- https://materialscodegraph.com/privacy.html
- App: https://app.materialscodegraph.com

MaterialsCodeGraph is operated by Da Vinci Labs, Berkeley.