Super MCP and API

SuperPowers AI Developer Portal

Give Claude, ChatGPT, Codex, and other MCP clients a free Android phone farm, then add credit-backed Mac, iPhone, Meta Display, computer-use cache, persistent project chat, or OpenAI-compatible Super API workflows.

Build a free phone farmOpen the developer dashboard

Free Android phone farm

Install the official Super APK, connect one private Android room, and manage it from any OAuth-capable Streamable HTTP MCP client without spending Super credits.

Connect Claude or OpenAI

For the free-only OpenAI connection, add https://app.getsupers.com/mcp/android, complete OAuth, and request mcp:android. Other MCP clients can use the general endpoint at https://app.getsupers.com/mcp.

Inspect the Android MCP Server Card

Upgrade when needed

super_premium_services explains credit-backed Mac, iPhone Mirroring, Meta Display, computer-use cache, and persistent Super chat. Payment happens in Super; premium device actions charge only after accepted delivery.

View credits and upgrade

Hosted Super MCP

Use Streamable HTTP for the free Android farm, persistent Super project sessions, or commands through premium devices connected by the Super Mac app. Authorization reuses the user's Super login; billing is enforced per premium action.

Connect

Set the MCP server URL to https://app.getsupers.com/mcp. A compatible client discovers OAuth, opens the Super sign-in page, and requests the selected scopes.

Protected Resource Metadata

Continue a project

Call super_chat and retain the returned project_id and chat_id. Later calls continue the same persistent Super session and use normal model credit billing.

Read the complete Super MCP documentation

Automate premium devices

List only devices owned by the signed-in account, inspect command families, then use super_run_device_command for Mac, iPhone, Meta Display, and other premium surfaces. Accepted premium deliveries cost one Super credit; Android commands use the free Android tool.

Add premium credits

Quickstart

Create a key from the authenticated dashboard, list the models available to your account, then send an OpenAI-compatible chat request.

1. Create a key

Sign in to the Super API dashboard. Create a key and copy it immediately; the complete secret is shown once.

2. Discover models

Call GET /v1/models before choosing a model. The response reflects the models and pricing metadata currently available to the authenticated account.

3. Send a completion

Call POST /v1/chat/completions with OpenAI-style messages. Set cache to false when a request must bypass compatible cached work.

curl https://app.getsupers.com/v1/models \
  -H "Authorization: Bearer $SUPER_API_KEY"

curl https://app.getsupers.com/v1/chat/completions \
  -H "Authorization: Bearer $SUPER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID_FROM_V1_MODELS",
    "messages": [{"role": "user", "content": "Explain what this API can do."}]
  }'

Authentication and resources

The Super API accepts either dashboard API keys or OAuth tokens bound to https://app.getsupers.com/v1. MCP OAuth tokens remain separately bound to /mcp, so credentials cannot cross resources.

API credentials

  • Create and revoke API keys from the authenticated dashboard.
  • Or dynamically register an OAuth client and request only api:models, api:chat, api:completions, or commerce:subscribe.
  • Send either credential as an HTTP bearer token to /v1.
  • Read the authentication and registration guide

Resource-bound OAuth

Authorization Code with PKCE, dynamic client registration, token revocation, and named scopes are published for both resources. Users sign in to Super; credits are required only for premium tool execution.

Canonical authorization server metadata

Agent-native subscription payments

Authenticated agents can purchase Super Powers AI Pro for $199 per month through UCP, MPP, or x402 without guessing a product identifier or price.

UCP checkout

Discover /.well-known/ucp, then create a checkout session at POST /ucp/v1/checkout-sessions. The session continues through the existing recurring PayPal plan.

Inspect the UCP profile

MPP Payment authentication

The MPP endpoint returns HTTP 402 with WWW-Authenticate: Payment. After the account owner approves the recurring payment, a verified retry returns Payment-Receipt.

Read the payment protocol guide

x402 USDC

The x402 endpoint requests an exact 199 USDC settlement and grants 30 days of Pro access. It returns HTTP 503 instead of an unfulfillable challenge when the merchant wallet or facilitator is unavailable.

Inspect payment discovery

Start without contacting sales

Developer onboarding is self-serve: create a key, register an OAuth client, use the sandbox, or connect one free Android device. Agents can verify these entry points through the live onboarding status.

Self-serve keys

Sign in and create or revoke Super API keys from the developer dashboard. Complete secrets are shown once.

Browser sandbox

Use the production sandbox below to list the authenticated account's live models and send a test completion without building a client first.

Read the rate-limit response contract

Free MCP device

OAuth sign-in includes one owner-scoped Android device. Setup, device listing, and Android commands use zero Super credits.

Official SuperPowers AI CLI

Install the published superpowers-ai npm package on a Mac, Windows, or Linux computer owned by the signed-in user.

Sign in and start

Run superpowers or supers, sign in or create an account, and start the private desktop streamer. The CLI prints the authenticated control link.

Inspect the npm package

API sandbox

Test the production API from this page. The sandbox loads the account's current model list before enabling a chat request, so it does not guess or hard-code a model identifier.

Request

Enter a key to begin. Requests are sent directly to app.getsupers.com.

Response

The JSON response will appear here.