@gera-services/mcp-geracity

MCP (Model Context Protocol) server for GeraCity — part of Gera Services.

MCP server for GeraCity smart city builder game — build cities, manage resources, connect to real Gera services, and earn GeraCoins.

Enables AI assistants (Claude, ChatGPT, Gemini, etc.) to interact directly with GeraCity on behalf of the user.

Installation

npm install @gera-services/mcp-geracity

Or run ad-hoc via npx:

npx @gera-services/mcp-geracity

Usage with Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "geracity": {
      "command": "npx",
      "args": ["@gera-services/mcp-geracity"]
    }
  }
}

With a custom API endpoint

{
  "mcpServers": {
    "geracity": {
      "command": "npx",
      "args": ["@gera-services/mcp-geracity"],
      "env": {
        "GERACITY_API_URL": "https://api.gera.games"
      }
    }
  }
}

Configuration

| Environment Variable | Description | Default | |---|---|---| | GERACITY_API_URL | Base URL for the GeraCity API | https://api.gera.games |

Available Tools

This server exposes GeraCity capabilities as MCP tools. Read-only tools (search, browse, list) work without authentication. Mutating tools (booking, purchasing, submitting) require a user bearer token passed via an auth_token parameter.

For the complete list of tools and their schemas, start the server and inspect it via an MCP-compatible client, or see the source at src/server.ts.

Multi-Country Support

GeraCity operates across 50+ countries. Most tools accept a country parameter (ISO 3166-1 alpha-2, e.g. GB, US, GE, UG, KE) to scope results.

About Gera Services

GeraCity is a product of Gera Services Ltd — a worldwide platform building 22 verticals across healthcare, commerce, payments, and more. All products share a unified identity via GeraCoins and single sign-on.

License

MIT — see LICENSE.