@idosgames/mcp

An MCP server that serves the iDosGames Module & Skills Registry to AI coding agents (Claude Code, Codex, Cursor, …). It lets an agent discover and pull composable game modules and the host scaffold, and load skills for @idosgames/core, the module contract, and composition.

Add it to your agent

Runs over stdio via npx — no install needed:

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

• Claude Code: claude mcp add idosgames -- npx -y @idosgames/mcp
• Cursor / Codex / others: add the JSON above to the client's MCP config.

The registry is bundled in the package, so it works offline. To point at the hosted registry instead (always the newest, published to the CDN by npm run push:registry), set:

IDOSGAMES_REGISTRY_URL=https://cloud.idosgames.com/drive/registry/latest

Tools

| Tool | Purpose | | ------------------- | ------------------------------------------------------------ | | list_modules | Catalog of modules (id, name, type, engine, genre, deps) | | get_module {id} | One module's full source + install/registration instructions | | list_skills | Available skills (name + description) | | get_skill {name} | A skill's full SKILL.md + reference files | | get_host_scaffold | The host-shell files for a new project | | get_manifest | @idosgames runtime packages + exact versions | | search {query} | Keyword search over modules and skills |

Tools return content; the agent writes files into its own project (standard MCP pattern). A typical flow: get_host_scaffold → write to root → get_module {id} for each chosen module → write to src/modules/{id}/ and register in src/modules.ts → install get_manifest versions.

See docs/composable-modules-architecture.md in the monorepo for the full design.