@idosgames/mcp

@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.