​

NanoGPT MCP Server

​

Installation

npx @nanogpt/mcp

​

Claude Code

claude mcp add nanogpt --scope user \
  --env NANOGPT_API_KEY=YOUR_API_KEY \
  -- npx -y @nanogpt/mcp

claude mcp add nanogpt --scope user --env NANOGPT_API_KEY=YOUR_API_KEY -- cmd /c "C:\Program Files\nodejs\npx.cmd" -y @nanogpt/mcp

​

Codex

codex mcp add nanogpt --env NANOGPT_API_KEY=YOUR_API_KEY -- npx -y @nanogpt/mcp

​

IDE Integration

{
  "mcpServers": {
    "nanogpt": {
      "command": "npx",
      "args": ["-y", "@nanogpt/mcp"],
      "env": {
        "NANOGPT_API_KEY": "your_api_key_here"
      }
    }
  }
}

​

Configuration

​

Available Tools

​

Video and 3D Generation

• operation: "submit_and_poll" submits the job and waits up to timeout_ms (default 50 seconds) for the result. A finished job returns the video or GLB URL. The wait includes the submit request, but a submission that is still in progress is never cut short (aborting it could lose a job that was already accepted), so an unusually slow submission can take longer than timeout_ms.
• If the job is still running, the result contains its runId. Call the tool again with operation: "poll" and that runId to keep waiting, or operation: "status" for a single check.
• operation: "submit" only submits the job.

​

Resources

• nanogpt://raw/{id}: Access the raw JSON response from a previous API call.
• nanogpt://image/{id}: Access an image generated during the session.
• nanogpt://media/{id}: Access generated audio or other media from the session.

​

Cost & Billing

• Paid tools deduct from your NanoGPT account balance.
• Model listing operations are complimentary.
• Video and 3D jobs are charged when submitted; use poll to keep waiting instead of submitting again.

​

Troubleshooting

​

API key validation

• Ensure NANOGPT_API_KEY is set in your MCP client configuration.
• Verify the key in your NanoGPT API dashboard and remove any extra spaces.
• If Claude Code fails immediately with Invalid API key, verify the MCP launcher command too, especially on native Windows where npx should run via cmd /c "C:\Program Files\nodejs\npx.cmd".

​

Timeouts for long operations

{
  "mcpServers": {
    "nanogpt": {
      "command": "npx",
      "args": ["-y", "@nanogpt/mcp"],
      "env": {
        "NANOGPT_API_KEY": "your_api_key_here",
        "NANOGPT_TIMEOUT_MS": "900000"
      }
    }
  }
}

​

Node.js version compatibility

node --version

​

MCP client connection checks

• Re-add the server configuration if your client can’t connect.
• Review your MCP client logs for connection errors.

​

Getting Started

1. Get your API key from the NanoGPT API dashboard.
2. Configure your MCP client (like Claude Desktop) with the server settings.
3. Start chatting with your agent and ask it to “Search the web for…”, “Generate an image of…”, “Make a 5 second video of…” or “Create a 3D model of…”.