# Superbot MCP endpoint

This URL is a Model Context Protocol endpoint over Streamable HTTP. It answers JSON-RPC on POST, not GET, so there is nothing to read here — the 405 you would otherwise get is the protocol working, not an outage.

No account yet? Follow https://api.superbot.gg/auth.md: it signs the user in with an emailed code and gives you a token for `https://api.superbot.gg/mcp`.

## Install for agent CLIs (no sign-in step)

`curl -fsS -X POST https://api.superbot.gg/mcp/install -d client=claude-code` returns JSON with:
- `add`: the `claude mcp add ... -s user` command that installs this server with its own key.
- `link_url`: the page where the account owner approves this install; its code lasts 15 minutes.
- `replace`: the command that removes an earlier `superbot` entry at user scope first.

Claude Code picks up a newly added server when its next session starts; it works once the owner approves at `link_url`.
Until then its `superbot` tool answers with a fresh `link_url`.
Codex has the same link install: `curl -fsS -X POST https://api.superbot.gg/mcp/install -d client=codex` returns `config_toml`, a `[mcp_servers.superbot]` entry with its own key, and the same `link_url`.
A Codex config with only `url = "https://api.superbot.gg/mcp"` and no key also connects: its first `superbot` call answers with a `link_url`, and the session works once the owner approves it.
Other clients: `client=gemini-cli` (`add`), `client=cursor` or `client=vscode` (`config`).

## Install with OAuth

`claude mcp add --transport http superbot https://api.superbot.gg/mcp -s user`, then sign in from `/mcp` in a new session.
Connector settings in claude.ai, Claude Desktop and ChatGPT use this OAuth path.

The lines a person gives a coding agent to install the server and the `/superbot` skill:

```
install the superbot MCP server globally: https://api.superbot.gg/mcp
install the superbot skill globally: https://api.superbot.gg/skills/superbot/SKILL.md
```

An installed copy of the skill adds the `/superbot <request>` command in Claude Code and Cursor (`$superbot` in Codex); the server install alone does not add that command.

A client that signs in with a browser needs no key. A client that cannot (a headless or CI run) uses a key a signed-in person copies at https://api.superbot.gg/download#mcp, with `copy with key` under "No browser sign-in? Copy a key.", and sends it as `Authorization: Bearer <key>`.

Setup for every supported client, the tool list, and what the server logs: https://api.superbot.gg/llms.txt