● Model Context Protocol server

MCP Server

Connect Gaia's public Registry to an MCP-compatible agent for discovery, evidence inspection, temporary skill summoning, and status checks.

● Current package contract — v0.4.0

The external gaia-research/gaia-mcp release publishes @gaia-research/mcp. Its current rich Registry/Bond package surface is gaia_search, gaia_inspect, summon, and gaia_status. It is a working prototype, not the deleted in-repository MCP implementation.

Overview

Gaia MCP is a stdio server. It reads public Gaia Registry projections; it does not mutate the Registry, a project checkout, or persistent agent configuration. summon materializes a matching Named Skill only into an ephemeral session directory.

summon is the current tool name. There is no current gaia_summon tool. The package's four tools are not an implemented or measured D4 thin search_skills + summon Heaven/Summon profile.

Installation

Public commands use @latest. The scoped package has two bins, so always select gaia-mcp explicitly when configuring an MCP client.

Claude Code
claude mcp add gaia -- npx --yes --package=@gaia-research/mcp@latest gaia-mcp

For any MCP client that accepts a command and argument array:

MCP config
{
  "command": "npx",
  "args": [
    "--yes",
    "--package=@gaia-research/mcp@latest",
    "gaia-mcp"
  ]
}

For one-shot Skill Hell use, choose the separate npx-friendly alias:

shell
npx --yes skill-hell@latest summon "code review" --card

Tools

Four tools are registered in the current package:

gaia_search
Find generic and Named Skills by task and constraints.
gaia_inspect
Return an evidence-backed dossier for one candidate.
summon
Materialize a matching Named Skill's full directory into an ephemeral session.
gaia_status
Report package version, data freshness, compatibility, counts, and available tools.

Prototype boundaries

  • No Registry mutation, fusion, Intake submission, project analysis, or persistent installation path.
  • No Hell/Heaven score, routing-eligibility decision, or content-hash admission or verification system.
  • D4's thin two-tool Heaven/Summon profile is separate from this rich four-tool package and does not deprecate it.
  • Normal Registry use needs no GAIA_USER or GitHub token. For isolated testing, TREE_URL and TREE_NAMED_URL can override the public projections.

Prompt examples

  • "Search the Gaia Registry for a code-review skill."
  • "Inspect the evidence for garrytan/review."
  • "Summon a skill for reviewing this pull request."
  • "Check Gaia MCP status and Registry freshness."

How it works

The stdio server loads Gaia's public generic and Named Skill projections on demand. Search and inspection return structured Registry facts. A summon resolves the selected source, validates it, and materializes the whole skill directory in a session-scoped temporary location; a bounded payload cache may make later materializations warm.

A temporary session is not a permanent installation or an admission decision. The package reports its source and cache state so callers can see those boundaries.