goodmorning-mcp

An MCP (Model Context Protocol) server that exposes models available on the gm inference gateway — a Bittensor subnet product — as callable tools, so a coding agent (Codex, Claude Code) can call gm models by name and list what's available.

Install

npx -y goodmorning-mcp

Requirements

Node >= 22.

Getting an API key

Environment variables

Variable	Required	Default	Notes
`GM_API_KEY`	yes	—	gm API key used as the bearer token for all requests
`GM_BASE_URL`	no	`https://api.saygm.com/v1`	gm gateway base URL

Codex

Add to ~/.codex/config.toml:

[mcp_servers.gm]
command = "npx"
args = ["-y", "goodmorning-mcp"]
env = { "GM_API_KEY" = "sk-...", "GM_BASE_URL" = "https://api.saygm.com/v1" }

Claude Code

Add to .mcp.json:

{
  "mcpServers": {
    "gm": {
      "command": "npx",
      "args": ["-y", "goodmorning-mcp"],
      "env": {
        "GM_API_KEY": "sk-...",
        "GM_BASE_URL": "https://api.saygm.com/v1"
      }
    }
  }
}

Tools

`gm_ask`

Ask a specific gm model a prompt and get back its full response text.

Param	Type	Required	Notes
`model`	string	yes	A gm catalog model id (see `gm_list_models`)
`prompt`	string	yes	The user prompt
`system`	string	no	Optional system prompt
`max_tokens`	integer	no	Max output tokens (default 16384). Raising it increases gm's upfront credit hold; OpenAI-surface models are uncapped when it's unset.

gm_ask auto-routes across the gm gateway's three API surfaces based on the model's api_shapes in the gm catalog, so claude-fable-5, gpt-*, kimi-k3, and gemini-* all work through the same tool:

Surface	Models	Endpoint
OpenAI (`chat.completions`)	e.g. `gpt-*`, `kimi-k3`	`POST {baseUrl}/chat/completions`
Anthropic (`messages`)	e.g. `claude-fable-5`	`POST {baseUrl}/messages`
Gemini (`generateContent`)	e.g. `gemini-*`	`POST {origin}/v1beta/models/{model}:generateContent`

Models whose only surface is unsupported (e.g. responses-only) throw a clear error naming the model and its api_shapes.

Non-streaming: the call blocks until the model finishes, then returns the full text in one shot. If the model returns empty content, the tool throws a clear error naming the model. The client applies a 5-minute timeout to accommodate long-reasoning models.

`gm_list_models`

No params. Returns the ids of models that are currently available and served through a supported surface, as a newline-separated, sorted string, for use as the model argument to gm_ask.

Usage

Once the server is configured, prompt your agent in natural language. It will call gm_list_models to discover valid model ids, then gm_ask to query one. For example:

Use gm to check the last response with kimi-k3.

Ask gm_list_models what's available, then get a second opinion from claude-fable-5, gpt-5.6, and gemini-3.1-pro-preview.

Model ids come and go with the gm catalog, so call gm_list_models rather than hardcoding one.