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

Sign up at saygm.com to get a GM_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.