OneOver MCP server

One key. GPT, Gemini, Grok, and Claude for second opinions, plus image, video, and audio generation, inside Claude Code, Cursor, VS Code, or any MCP client.

• Endpoint: https://api.oneover.com/functions/v1/mcp

• Transport: Streamable HTTP (remote, nothing to install)

• Auth: Authorization: Bearer oo_live_…, or OAuth from Claude.ai and the Anthropic directory. Create a key at the developer dashboard. Calls spend the same credits as the app. Pro is $10/mo.

• Try before a key: initialize and tools/list work without auth. tools/call needs a key.

1. Get a key

1. Sign in at oneover.com, open the developer dashboard, and choose Create key.

2. Copy the oo_live_… value. It is shown once.

3. A new key includes chat, images, video, audio, usage, files, apps, assets, jobs, and webhooks. It does not include billing, so create_topup stays hidden, or code, so Code Studio build tools return a scope error.

4. Store it as an env var: export ONEOVER_API_KEY=oo_live_...

2. Add it to your client

Claude Code

claude mcp add --transport http oneover https://api.oneover.com/functions/v1/mcp \
  --header "Authorization: Bearer $ONEOVER_API_KEY"

Add --scope user to use it in every project. Check with claude mcp list, or /mcp inside a session.

Or install the plugin, which also adds a skill that tells Claude when to use OneOver:

/plugin marketplace add jonruppel/oneover-claude-plugin
/plugin install oneover@oneover

Cursor

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "oneover": {
      "url": "https://api.oneover.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer oo_live_YOUR_KEY" }
    }
  }
}

VS Code

Copilot agent mode reads .vscode/mcp.json:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "oneover-key",
      "description": "OneOver API key",
      "password": true
    }
  ],
  "servers": {
    "oneover": {
      "type": "http",
      "url": "https://api.oneover.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:oneover-key}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "oneover": {
      "serverUrl": "https://api.oneover.com/functions/v1/mcp",
      "headers": { "Authorization": "Bearer oo_live_YOUR_KEY" }
    }
  }
}

Claude Desktop

claude_desktop_config.json only starts local programs. It does not call a remote URL with a bearer header.

Claude.ai and the Anthropic directory use OAuth. Add https://api.oneover.com/functions/v1/mcp. OneOver asks you to sign in, then mints a key that does not include billing or code.

The Desktop config file still needs a bridge. On macOS it is ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "oneover": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.oneover.com/functions/v1/mcp",
        "--header",
        "Authorization:${ONEOVER_AUTH}"
      ],
      "env": { "ONEOVER_AUTH": "Bearer oo_live_YOUR_KEY" }
    }
  }
}

Restart Claude Desktop after saving.

Check that it works

This needs no key. The response lists the tool names (create_topup is absent until the key has billing):

curl -s -X POST https://api.oneover.com/functions/v1/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Then, with a key, ask the client to call list_models. A catalog means the header and the key are working.

3. Tools

Live tools/list returns 18 tools without a billing scope, and 19 with one.

Video is async: call generate_video, then poll check_video or get_job until status is complete or failed. Builds work the same way: build_create, then build_status.

Protocol: the server negotiates 2025-11-25, 2025-06-18, 2025-03-26, and 2024-11-05, and answers with the version the client requested.

4. Prompts to try

• Second opinion: "Use OneOver's list_models, then ask GPT and Gemini via chat to review the plan in PLAN.md. Summarize where they disagree with you."

• Hero image: "Generate a 16:9 hero image for this landing page with OneOver generate_image."

• Video: "Make a 5-second product clip with generate_video, then poll check_video until done and give me the link."

• Voiceover: "Turn the intro paragraph of the README into speech with generate_audio."

• Balance: "What's my OneOver credit balance?" (get_usage)

5. Costs

Calls spend credits from the key's organization. Image and video cost more than chat. $5 buys 500 credits, $10 buys 1,000, and $20 buys 2,000. Pro includes 1,400 credits a month.

6. Common errors

Errors use a JSON envelope with code and request_id. Include the request id when writing to support. See errors.md.

Links

OpenAPI · llms.txt · Server card · MCP Registry: com.oneover/mcp

Markdown