MODEL CONTEXT PROTOCOL

Gaia MCP

The Gaia Skill Tree, wired directly into your editor. Discover and inspect evidence-backed skills over a single stdio connection.

ACT ACTIVE@gaia-research/mcp@0.1.0

$ npm install @gaia-research/mcp@0.1.0

Two modes. One package.

Registry Mode

Active

Reads directly from the public Gaia Skill Tree registry. No local checkout required. Skills are fetched on demand and cached locally.

Source: gaiaskilltree.com registry API
Local files: None required
Best for: Consuming published skills

Bonded Mode

Local

Points to a local gaia-skill-tree checkout. Edits to your local skills are reflected immediately — no publish cycle needed.

Source: Local filesystem path
Local files: gaia-skill-tree checkout
Best for: Developing new skills

$ GAIA_SKILL_TREE=../gaia-skill-tree npx -y @gaia-research/mcp@0.1.0

Available Tools (v0.1.0)

Registry mode tools currently shipped in @gaia-research/mcp@0.1.0. These read-only tools allow complete exploration of public skills.

gaia_search

Find generic and Named Skills in the public Gaia Registry. Returns ranked structured results with trust and source freshness metadata.

query*: Task, capability, or skill to find.
limit: Max number of results to return (default: 20).
kinds: Filter by kinds: generic or named.

gaia_inspect

Return an evidence-backed dossier for one generic or Named Skill, including relationships, implementations, trust, sources, and data freshness.

id*: Generic id, Named Skill id, or Named catalog reference.

gaia_status

Report server version, Registry mode, data-contract compatibility, source freshness, counts, and available tools.

Planned Capabilities

Under development for upcoming releases. These tools enable local mutations, benchmark runs, and skill composition.

gaia_skill_install

Install a Gaia skill from the registry into the current agent harness configuration.

skill*: Skill slug, e.g. gaia-research/skill-ci-churn
harness: Target harness: claude-code | codex | cursor | pi

gaia_skill_list

List all skills available in the Gaia Skill Tree registry, with optional category filter.

category: Optional category filter, e.g. ci, cost, context

gaia_skill_compose

Compose two installed skills into a unified SKILL.md using skill-fuse.

skill_a*: First skill slug
skill_b*: Second skill slug
output_name: Name for the composed skill

gaia_context_analyze

Analyze a context/SKILL.md file and return a token-budget breakdown against the harness limit.

path*: Absolute path to the context file to analyze
harness_limit: Token limit to check against (default: 200000)

gaia_benchmark_submit

Validate and submit a GSB benchmark result JSON to the Gaia Research ledger.

path*: Absolute path to the GSB submission JSON file
dry_run: Set to true to validate without submitting

Wire it up in 60 seconds.

Add Gaia MCP to your editor's config file, restart, and your agent gains the full Skill Tree as native tools.

Config file: .mcp.json (project root)

{
  "mcpServers": {
    "gaia": {
      "command": "npx",
      "args": [
        "-y",
        "@gaia-research/mcp@0.1.0"
      ]
    }
  }
}

$ {
  "mcpServers": {
    "gaia": {
      "command": "npx",
      "args": [
        "-y",
        "@gaia-research/mcp@0.1.0"
      ]
    }
  }
}

Bonded mode: prefix the command with GAIA_SKILL_TREE=/path/to/gaia-skill-tree to use a local checkout instead of the live registry.

OPEN SOURCE

Get started today.

@gaia-research/mcp@0.1.0 is published and ready for use. Star the repository to follow development.

Star on GitHub ↗Browse research →