Skip to Content
supedocs

MCP

Add supe to an AI app that can't run commands, like Claude or ChatGPT, or to any MCP client.

Use MCP when your agent has no shell. If it can run commands, the skill is simpler and does more.

Server URLhttps://service.oex.sh/mcp
TransportStreamable HTTP
Sign-inOAuth in the browser, the first time you use it. Or send an API key as Authorization: Bearer <key>.

Each app that signs in shows up as its own agent on your dashboard's Agents page, with its own spending and limits.

Add it to your app

Pick your app. Each tab has the OAuth way first, then the API key way for when you can't sign in from the app (a server, CI, or a shared machine).

Run this in a terminal:

claude mcp add --transport http supe https://service.oex.sh/mcp

Then type /mcp inside Claude Code, pick supe and sign in. Add --scope user to use it in every project, or --scope project to share it through the repo's .mcp.json.

With an API key instead:

claude mcp add --transport http supe https://service.oex.sh/mcp \
  --header "Authorization: Bearer $SUPE_API_KEY"

Get an API key from the dashboard: Agents → Get an API key → Make a key. You see the key once.

Check it works

Ask your agent: "What's my supe balance?" It should call wallet_balance and tell you the number of credits. Then try something real, like "find a tool that gets exchange rates and get today's euro to dollar rate".

What the agent can do

The agent sees 15 tools: it finds a tool with find_tool, reads its parameters with inspect_tool, and runs it with execute_tool. The server also sends the agent instructions on money, confirmations and long jobs, so you don't need to paste any.

If something's off

  • The app never asks you to sign in. Remove supe and add it again, or use the API key way.
  • The agent says a call was refused. That's one of your limits working. The refusal names the rule; change it on the dashboard if you want the call to go through.
  • "Not signed in" after a while. Sign in again from the app (/mcp in Claude Code, codex mcp login supe in Codex).

On this page