# MaterialsCodeGraph

> MaterialsCodeGraph is a freemium MCP server for health and science. MCP server for materials simulations with a binding price quoted before every run. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $10 a month
- **Platforms:** API, Web
- **Website:** https://materialscodegraph.com
- **Repository:** https://github.com/materialscodegraph/materialscodegraph
- **MCP Registry name:** com.materialscodegraph/mcg
- **Categories:** health and science, engineering simulation
- **Listing updated:** 2026-11-16

## About

MaterialsCodeGraph wraps Quantum ESPRESSO, GPUMD and kALDo behind one endpoint, mainly for computing thermal conductivity. The distinguishing mechanism is billing: mcg_quote returns a free, binding quote with a hash and expiry, mcg_run spends exactly that amount or refuses a repriced or expired quote, and mcg_get_run returns the finished record. Each run's artifacts carry SHA-256 hashes so a rerun can be checked file by file.

The site's worked example is a kALDo direct-inversion calculation for silicon at 300 K costing 179 tokens, or $0.18, finished in 4 minutes 20 seconds, with the result compared against a pinned reference within a 2 percent tolerance. It is candid that this does not predict measured silicon, and that the QE plus D3Q engine currently covers silicon only on meshes below convergence, so its values are pipeline checks.

Tokens cost $0.001 each. Academic emails (.edu, .ac.xx) get 5,000 tokens at signup, other keys can read and quote free, and spend keys must set a daily token cap. Access uses bearer API keys with read, quote and spend scopes.

## Features

- **Binding quotes:** Get a fixed price for free before any compute starts.
- **Permanent run records:** Inputs, code versions and artifact hashes are kept.
- **Three engines:** Quantum ESPRESSO, GPUMD and kALDo.
- **Scoped keys:** Read, quote and spend scopes with a required daily token cap.
- **Idempotent runs:** Reusing an idempotency key returns the same run.
- **Live catalog:** mcg_catalog lists methods with token cost and wall time.

## Good for

- Price a thermal conductivity calculation before committing
- Run a phonon calculation from an agent and keep an auditable record
- Reproduce a recorded result and check artifact hashes
- Cap daily spend for an autonomous agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcg https://api.materialscodegraph.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.materialscodegraph.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcg": {
      "url": "https://api.materialscodegraph.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcg": {
      "type": "http",
      "url": "https://api.materialscodegraph.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcg": {
      "serverUrl": "https://api.materialscodegraph.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcg": {
      "type": "http",
      "url": "https://api.materialscodegraph.com/mcp"
    }
  }
}
```

## Tools

- `mcg_catalog`: Lists available methods with cost and time.
- `mcg_rates`: Returns the rate card.
- `mcg_quote`: Returns a binding price for a request.
- `mcg_clusters`: Lists clusters.
- `mcg_stage`: Stages a run.
- `mcg_run`: Launches a quoted run.
- `mcg_list_runs`: Lists runs.
- `mcg_get_study`: Reads a study.
- `mcg_list_studies`: Lists studies.
- `mcg_update_study`: Updates a study.
- `mcg_study_members`: Manages study members.
- `mcg_delete_study`: Deletes a study.
- `mcg_archive`: Archives items.
- `mcg_get_run`: Returns run state, billing and record.
- `mcg_cancel_run`: Cancels a run.
- `mcg_fetch_artifacts`: Lists artifacts with SHA-256 hashes.
- `mcg_get_artifact`: Fetches one artifact.

## FAQ

### Do quotes cost anything?

No. mcg_quote is free and binding.

### How much does a run cost?

Tokens are $0.001 each; the kALDo silicon example cost 179 tokens, or $0.18.

### Who gets free tokens?

Academic email addresses receive 5,000 tokens at signup.

### Are the results validated against experiment?

Not necessarily. The site says its silicon examples do not predict measured values and the QE plus D3Q values are pipeline checks.

### Is MaterialsCodeGraph free?

MaterialsCodeGraph has a free plan, with paid plans for more usage or features. Paid plans start at $10 a month.

### How do I add MaterialsCodeGraph to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcg https://api.materialscodegraph.com/mcp

### What are the best alternatives to MaterialsCodeGraph?

The closest alternatives to MaterialsCodeGraph are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Petrolytx: decline curves and well economics](https://ai-powered.com/mcp/petrolytx-decline-curves-and-well-economics): Petrolytx: decline curves and well economics is a freemium MCP server for analytics and data.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.

---
Source: https://ai-powered.com/mcp/materialscodegraph
