SuperPowers AI hosted MCP server

Connect Claude, ChatGPT, Codex, or another compatible client to Super over Streamable HTTP. OAuth keeps every tool owner-scoped. One Android device is free after login; project chat, Mac, iPhone, Meta Display, and computer-use-cache actions use the account's Super credits only when a premium action is accepted.

OAuth 2.0 with PKCEOne free Android devicePersistent project chatOwner-scoped remote devicesStreamable HTTPOAuth 2.0 with PKCEOne free Android devicePersistent project chatOwner-scoped remote devicesStreamable HTTP

Auto-building agents

No source code, Mac app, or local MCP server required.

  1. Install the Super Chrome extension and sign in.
  2. Open the Super dashboard, connect Chrome, choose a model, and keep the dashboard tab open. Refresh it once if already open.
  3. Add the MCP and sign in with the same Super account. Authorize mcp:devices.
codex mcp add super --url https://app.getsupers.com/mcp
codex mcp login super

Paste this into Codex

Use Super MCP to build and run a new agent in my connected Chrome extension. Open https://www.google.com in a dedicated new tab, search for "James Webb Space Telescope latest images", and return the actual results page title, URL, and first three visible search result titles. Use google/gemini-3.8-flash. Discover my browser sessions first, use the exact session ID and a unique request ID, and poll until completion. Inspect the returned result before reporting success. Do not post, purchase, or change any accounts.

Tested example: Google search agent

Codex discovers your connected Chrome session with super_browser_agent_sessions, submits the task through super_build_browser_agent, and follows the returned run_id with super_browser_agent_status. The model writes the script and the Chrome extension runs it; no source code or hand-written script is needed.

The successful test completed eight browser actions and opened James Webb Space Telescope latest images - Google Search. The returned titles matched the actual Chrome page:

  1. Webb Image Galleries (NASA Science)
  2. NASA James Webb Space Telescope latest images
  3. The Cartwheel Galaxy Is the Webb Telescope's Latest Cosmic ... (The New York Times)

Search results vary. An earlier attempt lost its newly opened tab and correctly reported failure; a fresh run completed successfully. Keep the agent's tab and dashboard open while it runs. This records one tested run, not a guarantee that every website or run succeeds.

Build, follow, and stop

super_browser_agent_sessions discovers your browsers. super_build_browser_agent accepts prompt, session_id, and a unique request_id, plus an optional model slug. The example was verified with google/gemini-3.8-flash; omit the model to use your dashboard selection. Provider restrictions still apply: Google Vertex-only cannot serve NVIDIA free models. super_browser_agent_status returns generated code, progress, and the result. super_stop_browser_agent stops that run.

Model usage uses your Super credits. Only completed: true with status completed confirms execution. Keep Chrome and the dashboard open; interrupted scripts are not automatically replayed. Reuse the same request ID on network retries. Your sessions and results are account-private.

Full setup, tool fields, and troubleshooting ยท Official Codex MCP configuration

Canonical endpoint

Use https://app.getsupers.com/mcp. The transport accepts authenticated JSON-RPC requests with POST. The server card advertises supported protocol versions and the canonical Streamable HTTP remote.

Free Android endpoint

Use https://app.getsupers.com/mcp/android for the free-only surface. It exposes setup, listing, and command tools for one Android device connected through the official Super APK.

Authentication discovery

Start at https://app.getsupers.com/.well-known/oauth-protected-resource/mcp. Register a client dynamically, use Authorization Code with PKCE, and request only the scope required by the selected tool.

Connect with least privilege

The server describes its own transport, authentication, scopes, and tools.

Discover the server

The canonical server card is published at /.well-known/mcp/server-card.json. Compatibility aliases are also available at /.well-known/mcp.json and /.well-known/mcp. The transport-specific card is available at https://app.getsupers.com/mcp/server-card.

Request only needed scopes

Use mcp:android for free phone-farm setup and commands, mcp:projects for project state, mcp:chat for persistent Super chat, and mcp:devices for premium remote-device tools. Tokens are resource-bound and cannot be reused against the Super API.

Initialize and list tools

Send an MCP initialize request, then call tools/list. Begin Android setup with super_phone_farm_setup. Clients should read the published input schemas and tool annotations instead of guessing command arguments.

Billing boundary

Login is always required. Android setup, listing, and Android commands for the included device require zero credits. Premium project chat and device delivery check account credits at execution time. The free-only Android endpoint never exposes purchase or upgrade tools.

Connect to Super with a discoverable contract.

Use the published server card, OAuth metadata, and live Streamable HTTP endpoint to build without a sales call.