godmod3-mcp

MCP bridge for G0DM0D3 with dedicated skills for Odysseus and Hermes Agent.

This package delegates 100% to a self-hosted G0DM0D3 API and exposes every flagship feature as an MCP tool:

• ULTRAPLINIAN multi-model racing

• CONSORTIUM hive-mind synthesis

• Single-chat with GODMODE / AutoTune / Parseltongue / STM

• AutoTune analysis, Parseltongue obfuscation, STM transforms

• Dataset + research endpoints

• Local OpenAI-compatible model support (Ollama, LM Studio, vLLM)

Quick start

Recommended deployment

Run the upstream G0DM0D3 API as a container, run a local stdio bridge for Hermes, and run a separate HTTP bridge container for Odysseus.

1. Start the G0DM0D3 API container

cp .env.example .env
# edit .env with optional keys
docker compose -f docker-compose.api.yml up -d --build

The API is available at http://localhost:7860 from the host and at http://godmod3-api:7860 from containers on the shared godmod3 network.

Note: The upstream G0DM0D3 API currently has a path-to-regexp compatibility issue (/batch/* route pattern). The local Dockerfile.api clones upstream and applies a small patch before building so the container starts correctly.

Avoid upstream rate limits

By default the API runs in Free tier mode: 5 total requests, 10/min, 50/day. To get unlimited local use, set a tier key in .env:

GODMODE_API_KEY=my-local-key-123
GODMODE_TIER_KEYS=enterprise:my-local-key-123

Then pass the same key to the bridge via GODMOD3_API_KEY. Restart the API container to apply.

2. Install the bridge locally for Hermes (stdio)

pip install -e .

This installs the bridge and the console script godmod3-mcp.

3. Start the HTTP bridge container for Odysseus

docker compose -f docker-compose.bridge-http.yml up -d --build

Odysseus connects to http://localhost:3001/sse.

4. Verify

python -m godmod3_mcp.server --test

Alternative: run the API directly

If you prefer not to containerize the API:

git clone https://github.com/elder-plinius/G0DM0D3.git
cd G0DM0D3
npm install
npm run api

Alternative: full stack at once

docker compose up -d --build

This is equivalent to starting both docker-compose.api.yml and docker-compose.bridge-http.yml together.

Related MCP server: Multi-CLI MCP

Configuration

MCP Tools

• health_check

• server_info

• list_models

• get_tier

• single_chat

• ultraplinian_chat

• consortium_chat

• autotune_analyze

• parseltongue_encode

• parseltongue_detect

• transform_text

• submit_feedback

• dataset_stats

• export_dataset

• research_info

• research_stats

• research_query

Connect to Odysseus

Via the MCP admin UI or API:

{
  "name": "godmod3",
  "transport": "stdio",
  "command": "python",
  "args": ["-m", "godmod3_mcp.server"],
  "env": {
    "GODMOD3_BASE_URL": "http://localhost:7860",
    "GODMOD3_API_KEY": "optional-key"
  }
}

Or via the HTTP bridge container:

{
  "name": "godmod3",
  "transport": "http",
  "url": "http://localhost:3001/sse"
}

Install the skill:

cp -r skills/odysseus/godmod3 /path/to/odysseus/data/skills/

Connect to Hermes Agent

Hermes launches the bridge as a local stdio subprocess. Make sure you installed the bridge with pip install -e . and that the API container is exposing port 7860.

Add to your Hermes MCP config (file path depends on install; often ~/.hermes/mcp_servers.json or via hermes config):

{
  "godmod3": {
    "command": "godmod3-mcp",
    "env": {
      "GODMOD3_BASE_URL": "http://localhost:7860",
      "GODMOD3_API_KEY": "optional-key"
    }
  }
}

Install the skill:

cp -r skills/hermes/godmod3 ~/.hermes/skills/

Then invoke with /godmod3.

Connect other MCP clients (Claude Code, Codex, Cursor, Kimi Code)

The bridge is a standard MCP server. Any MCP-compatible client can connect via stdio or HTTP/SSE.

HTTP/SSE (recommended for shared access)

{
  "mcpServers": {
    "godmod3": {
      "url": "http://localhost:3001/sse"
    }
  }
}

stdio

{
  "mcpServers": {
    "godmod3": {
      "command": "/home/vudu/.venv/godmod3-mcp/bin/godmod3-mcp",
      "env": {
        "GODMOD3_BASE_URL": "http://localhost:7860",
        "GODMOD3_API_KEY": "optional-key"
      }
    }
  }
}

Client-specific skill files

Copy the appropriate skill file into your client config:

These files explain when and how to use the G0DM0D3 tools in each client.

Local model support

Pass local_model_url and local_models to any chat tool:

{
  "messages": [{"role": "user", "content": "Hello"}],
  "local_model_url": "http://localhost:11434/v1",
  "local_models": ["qwen3:8b"],
  "provider_preference": "all"
}

Tests

pytest tests/test_tools.py

License

AGPL-3.0-or-later — same as G0DM0D3.