Gaia MCP server provides read-only tools for discovering and inspecting skills from the public Gaia Registry, plus server status monitoring. Use gaia_search to find generic and named skills by query, with filters for kind, tier, star rating, trust magnitude, contributors, installability, and types; returns ranked results with freshness metadata. Use gaia_inspect to get a detailed evidence-backed dossier for a specific skill, including relationships, implementations, trust signals, sources, and data freshness. Use gaia_status to check server version, registry mode, data freshness, counts, and available tools. (Note: The summon tool to materialize named skills into ephemeral sessions exists in the package but is not exposed in the current schema.)
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Gaia MCP Find a high-trust skill for automating email replies"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Agent-native Gaia Registry discovery, evidence inspection, and temporary skill summoning for Gaia Skill Tree.
Status:
@gaia-research/mcp@0.4.0is published. It is a working prototype: its current package interface is usable, while later Heaven/Summon profile work remains separate.
Gaia MCP consumes public Registry data; it does not own or mutate the Registry.
The published rich Registry/Bond package surface has four tools:
Tool | Current purpose |
| Find generic and Named Skills by task and constraints. |
| Return an evidence-backed skill dossier. |
| Materialize matching Named Skills into an ephemeral Skill Hell session. |
| Report version, Registry freshness, compatibility, counts, and available tools. |
summon is the current tool name; gaia_summon is not a current package tool.
It materializes skills in a temporary session and may maintain a bounded,
temporary cross-session payload cache. It never changes the Registry, current
repository, or permanent harness/project configuration.
The package's four tools are not an implementation or measurement of D4's
thin, two-tool Heaven/Summon profile (search_skills, summon). The latter is
a profile and schema-dose constraint for Skill Heaven work. It does not rename,
remove, or deprecate any of the published package tools above.
Related MCP server: aai-gateway
Requires Node.js 22.14 or newer.
Use an explicit package selector and binary. @gaia-research/mcp registers two
binaries, so a package name alone cannot select the MCP server:
claude mcp add gaia -- npx --yes --package=@gaia-research/mcp@latest gaia-mcpFor another MCP client, use this command and argument shape:
{
"command": "npx",
"args": ["--yes", "--package=@gaia-research/mcp@latest", "gaia-mcp"]
}The npx-friendly alias is the shortest one-shot command:
npx --yes skill-hell@latest summon "code review" --cardYou can also select the skill-hell binary directly from the rich package:
npx --yes --package=@gaia-research/mcp@latest skill-hell summon "code review" --cardFor a persistent shell installation, install the rich package and use either of its two binaries:
npm install --global @gaia-research/mcp@latest
gaia-mcp
skill-hell summon "code review" --cardskill-hell@latest is an alias package with its own forwarding binary. The
scoped package deliberately exposes both gaia-mcp and skill-hell; always
select the intended binary with --package when running it through npx.
npm ci
npm run build
node dist/bin/gaia-mcp.jsThe server speaks MCP over stdio, so it normally appears idle when run directly.
Connect an MCP client to the absolute path of dist/bin/gaia-mcp.js.
For isolated source testing, override the public projection endpoints with
TREE_URL and TREE_NAMED_URL.
summon materializes the whole skill directory — SKILL.md plus referenced
files, templates, scripts, and fixtures — under an ephemeral session root. It
returns cards, inspect links, timing, cache state, and its ranking disclosure.
skill-hell summon "code review" --count 3
skill-hell sessions
# Re-attach in a new shell/session:
eval "$(skill-hell attach skill-hell-AbCd12)"--count is bounded to 1–5. Named Skills may publish an open trust object;
when there is no comparable signal, the result explicitly reports
relevance-only ordering. This per-invocation ordering is not Hell/Heaven
scoring, routing eligibility, or a content-hash admission policy. Those
features are not shipped.
Warm roots remain under os.tmpdir() for the configured TTL. skill-hell
never writes into the current repository, ~/.claude, or permanent skill
configuration.
npm run check # format check, typecheck, unit/protocol/package tests
npm run test:live # current Gaia public-data contract
npm pack --dry-run # publishable artifact contentsGaia MCP is not:
a second Registry implementation;
a direct Registry or Skill Tree mutation path;
a permanent skill installer or background update daemon;
an implemented Hell/Heaven scoring, routing-eligibility, or content-hash admission system;
the thin Heaven/Summon profile merely because it has a summon tool.
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
A registry of 5,900+ peer-authored skills any MCP agent can search and load on demand.
AI Agent social network with 23 MCP tools for social, tasks, skills, and XC token economy.
Your memory, everywhere AI goes. Build knowledge once, access it via MCP anywhere.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/gaia-research/gaia-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server