{"id":"com.materialscodegraph/mcg","slug":"com-materialscodegraph-mcg","title":"MaterialsCodeGraph","description":"Materials simulations for AI agents over MCP: binding token quote before every run, record after it.","version":"0.1.1","publisher":{"kind":"domain","id":"materialscodegraph.com","label":"materialscodegraph.com","url":"https://materialscodegraph.com"},"website":"https://materialscodegraph.com","repository":"https://github.com/materialscodegraph/materialscodegraph","remotes":[{"type":"streamable-http","url":"https://api.materialscodegraph.com/mcp","headers":[{"description":"Bearer mcg_sk_... API key, minted on the Keys page of app.materialscodegraph.com.","isRequired":true,"isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-09-20","updated":"2026-09-20","status":"online","auth":"","latency_ms":2175,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"mcg_catalog","title":"","description":"Enabled simulation kinds (each with example mcg_quote arguments that price, a note naming what must exist first, or both; traced says whether the kind's default lineage has a single public OpenMaterials node pin, traced_note why or why not; research coordinators instead expose record_contract describing per-task completion requirements, not completed results), the costed lineage menu (runnability,","read_only":true},{"name":"mcg_rates","title":"","description":"The public rate card: token_usd, overheads, rate_card_version. FREE, no arguments; also a connectivity check.","read_only":true},{"name":"mcg_quote","title":"","description":"Price a simulation. FREE: no hardware starts. Returns quote_id, quote_hash, tokens, rate_card_version, wall_s, expires_at, resource_class, resource_label and sku (the GPU class the quote is bound to, its name, and the offer SKU it priced; null when none was chosen), resource_options (one row per class the run can rent at this venue: resource_class, label, sku, tokens, wall_s, available; tokens and","read_only":false},{"name":"mcg_clusters","title":"","description":"Connected clusters: id, name, preset (hive or auto), status (pending until the agent's first sync; connected; stale: the agent stopped syncing; revoked; scheduler_down: the agent syncs but cannot reach the scheduler, nothing is offered; agent_outdated: the agent is older than 0.2.10, the minimum for new jobs, or an auto cluster's agent sends no inventory, nothing is offered; snapshot_rejected: its","read_only":true},{"name":"mcg_stage","title":"","description":"Create a DRAFT simulation whose input files are uploaded before pricing. FREE. Takes the same kind, spec, study, material and conditions as mcg_quote plus inputs: one entry per file the run needs, each with a name and, for small text files, the text inline (staged immediately). Entries without text come back in uploads as presigned PUT URLs (valid 15 minutes, 4 GiB per file): upload each with a pl","read_only":false},{"name":"mcg_run","title":"","description":"Launch the quoted simulation. SPENDS TOKENS: provisions hardware and bills the account. Requires the quote_id and quote_hash from mcg_quote (a stale hash or an expired quote REJECTS: re-quote and retry) and a client-generated idempotency_key (replaying it returns the existing run instead of launching twice). Optional max_tokens is a hard ceiling: a quote above it REJECTS the launch, never clamps. ","read_only":false},{"name":"mcg_list_runs","title":"","description":"List runs, newest first: every run of this key's owner, or one quote's runs when quote_id is given. Returns at most limit rows (default 20, maximum 100). Each row carries state, spend_tokens, created_by_key_name (null when launched in the browser), study, headline (the AI brief's first line) and app_url. Returns runs and next_before: pass next_before as before to get the next older page; it is nul","read_only":true},{"name":"mcg_get_study","title":"","description":"Fetch a study (the project a quote's `study` named) with its member simulations and their latest runs. Pass study_id or the exact name. Returns study (with summary and parent_id), parent (the project it is filed under, or null), children (its subprojects with run counts by state, last_activity_at, latest_headline and their members), progress (the same counts over its own members), rollup (the stud","read_only":true},{"name":"mcg_study_members","title":"","description":"Add simulations to a study and remove them from it. You must own the study (get its id from mcg_get_study) and every listed simulation; a missing one is named and nothing changes. add appends in order (a member already present keeps its place); remove takes a simulation out of this study only, and the simulation and its runs are untouched. Joining a public study is refused for a run that cannot be","read_only":false},{"name":"mcg_list_studies","title":"","description":"Your projects and their subprojects. A project is a study with no parent; a subproject is a study filed under one project. Each entry carries id, name, summary (one line, may be empty), n_members (unarchived simulations) and app_url; each project lists its subprojects, oldest first. Projects come newest first.","read_only":true},{"name":"mcg_update_study","title":"","description":"Describe and file a study you own. name renames it; summary sets its one-line purpose; story_md replaces its long narrative. parent_id files it under a project (null makes it a project again); parent_name does the same by exact project name and creates that project if you have none by that name. The tree is one level deep: a project with subprojects cannot be filed under another. roles labels memb","read_only":false},{"name":"mcg_delete_study","title":"","description":"Delete a study you own: the study and its membership list go. Its simulations, runs, artifacts and spend are untouched and stay reachable by id and in mcg_list_runs. A deleted project's subprojects become projects. Refused while the study has documents or a live public link (remove those in the app first). Returns study_id, deleted true and former_member_ids, enough to rebuild it.","read_only":false},{"name":"mcg_archive","title":"","description":"Archive or unarchive a simulation you own. Archiving hides it from the app's lists and studies; its runs, artifacts and spend are untouched, its direct link still opens, and archived false restores it. Use it to clear drafts that never ran (they cannot be deleted once quoted). Returns simulation_id, archived, archived_at (null when unarchived) and app_url.","read_only":false},{"name":"mcg_get_run","title":"","description":"Fetch a run's state, event timeline and LLM spend. The payload leads with a derived summary (state, current_stage, billing {quoted_tokens, charged_tokens, hold, policy}, fault, refusal, next, last event, campaign) for cheap polling, then app_url (the run page, for the human), study and headline. events holds the newest events that fit about 12 KB plus the last complete or fail event; events_omitte","read_only":true},{"name":"mcg_cancel_run","title":"","description":"Cancel a run from any non-terminal state before collecting (a collecting run's outputs are delivered and charged: 409). The cancel request is recorded immediately and returns run_id and cancel_requested true (and a note, for a running campaign); the platform kills the machine and terminalizes the run as state killed on its next orchestration tick (about 60 s). A running campaign's cancel takes sev","read_only":false},{"name":"mcg_fetch_artifacts","title":"","description":"List a run's collected artifacts as a typed manifest: artifacts, a list of path, bytes, stage and sha256 per file, plus removed on a file the retention sweep deleted (its bytes are gone; do not fetch it) and attribution on a third-party model's file (its license notice; keep it with any copy); truncated; source. Never returns file contents; fetch one file with mcg_get_artifact.","read_only":true},{"name":"mcg_get_artifact","title":"","description":"Fetch one artifact file's TEXT content, up to max_bytes (default 65536), with an explicit truncation note. Binary content REJECTS with unsupported_content; fetch binaries from the run's public page. A third-party model's file returns its full license notice first, as an [attribution] text item.","read_only":true}],"server_info":{"name":"mcg","title":"MaterialsCodeGraph","version":"0.1.2"},"category":"crypto","tags":["agents"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-09-20","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-materialscodegraph-mcg/"}