MCP server and static JSON API description for ORCHID CALPHAD data (literature values, phase diagrams, DFT hulls, TDB catalog) with full provenance
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"orchid-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# orchid-mcp An [MCP](https://modelcontextprotocol.io) server for **ORCHID** (Open Repository for CALPHAD Hypotheses, Intelligence, and Discovery): literature thermodynamic and phase-equilibrium values, calculated binary phase diagrams, Materials Project / OQMD formation energies and the TDB catalog — every value returned with its citation, DOI, page, quote (or table locator), evidence class and flags. Also: an OpenAPI description of the static JSON files at `data.orchid-project.org` (`openapi/openapi.yaml`). ## Install ```bash python3.13 -m venv .venv # a dedicated environment (git-ignored) .venv/bin/pip install -e '.[mcp]' # with the official MCP Python SDK, pinned to mcp==2.3.0 (recommended) .venv/bin/pip install -e . # stdlib only: built-in stdio fallback server, no HTTP mode ``` The package itself has no runtime dependencies. If the `mcp` SDK is installed, the server runs on it (`MCPServer` in mcp 2.x, tested with 2.3.0; `FastMCP` in mcp 1.x is also supported); otherwise `orchid-mcp` serves the MCP stdio protocol (tools, resources, prompts) with a small built-in JSON-RPC loop. Streamable HTTP (`--transport http`) needs `pip install mcp`. ## Data source | variable | default | meaning | |---|---|---| | `ORCHID_DATA_DIR` | — | local copy of `data.orchid-project.org` (an `orchid-data` checkout). If set, no network is used. | | `ORCHID_DATA_URL` | `https://data.orchid-project.org/` | online data | | `ORCHID_SITE_DATA_DIR` | — | local copy of `orchid-project.org/data` (`catalog.json`, `databases/`) | | `ORCHID_SITE_DATA_URL` | `https://orchid-project.org/data/` | online catalog and bundled TDB files | | `ORCHID_CACHE_DIR` | `~/.cache/orchid-mcp` | on-disk cache of remote files | | `ORCHID_CACHE_TTL` | `86400` | seconds before a cached file is refetched (stale copies are used if offline) | | `ORCHID_OFFLINE` | — | `1`: never touch the network, serve from the cache | ## Run ```bash orchid-mcp …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.