---
title: SuperPowers AI Developer Portal | Free Phone Farm MCP and Super API
description: Official Super Phone Farm MCP and Super API resources, Android APK, Claude and OpenAI connection details, scoped OAuth, premium device upgrades, OpenAPI documentation, and a browser sandbox.
canonical: https://getsupers.com/developers/
---

# SuperPowers AI Developer Portal

Build agent workflows with **Super**, the AI assistant from **SuperPowers AI**. The Super API provides OpenAI-compatible model discovery, chat completions, and legacy text completions using a Super account and either a bearer API key or resource-bound OAuth access token.

- Production API base URL: `https://app.getsupers.com/v1`
- [Create and manage API keys](https://app.getsupers.com/developer/api-dashboard)
- [OpenAPI 3.1 specification](https://getsupers.com/openapi.json)
- [RFC 9727 API catalog](https://getsupers.com/.well-known/api-catalog)
- [Agent authentication guide](https://getsupers.com/auth.md)
- [Super API OAuth Protected Resource Metadata](https://getsupers.com/.well-known/oauth-protected-resource)
- [OAuth Authorization Server Metadata](https://getsupers.com/.well-known/oauth-authorization-server)
- [Super API Agent Skill](https://getsupers.com/.well-known/agent-skills/super-api/SKILL.md)
- [Agentic Resource Discovery catalog](https://getsupers.com/.well-known/ai-catalog.json)
- [Super hosted MCP Server Card](https://getsupers.com/.well-known/mcp/server-card.json)
- [Complete SuperPowers AI product documentation](https://app.getsupers.com/docs#super-api)
- [Interactive browser sandbox](https://getsupers.com/developers/#sandbox)
- [Super API versioning and deprecation policy](https://getsupers.com/developers/api-lifecycle)
- [UCP, MPP, and x402 agent payment guide](https://getsupers.com/developers/payments)
- [Universal Commerce Protocol profile](https://getsupers.com/.well-known/ucp)
- [Official `superpowers-ai` CLI on npm](https://www.npmjs.com/package/superpowers-ai)
- [Official SuperPowers AI CLI documentation](https://getsupers.com/developers/cli)
- [Hosted Super MCP documentation](https://getsupers.com/developers/mcp)
- [Super API rate-limit response headers](https://getsupers.com/developers/rate-limits)
- [Live self-serve onboarding status](https://app.getsupers.com/developer/onboarding)

## Start without contacting sales

SuperPowers AI developer onboarding is self-serve. A signed-in user can create and revoke a Super API key from the dashboard, use the Browser sandbox on this page, dynamically register a public OAuth client, or connect the free Android MCP tier without a sales call. The free Android tier includes one owner-scoped Android device and charges zero Super credits for setup, listing, and Android commands. Model-completion availability and premium services depend on the authenticated account's current credits.

Agents can verify the current signup, API-key, sandbox, and free-tier entry points at `https://app.getsupers.com/developer/onboarding`.

## Quickstart

### 1. Create a Super API key

Sign in to the [Super API dashboard](https://app.getsupers.com/developer/api-dashboard), create a key, and copy it immediately. The complete secret is shown once.

### 2. Discover available models

Do not guess or hard-code a model identifier. List the models currently available to the authenticated account:

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

### 3. Send an OpenAI-compatible chat completion

Use a model ID returned by `/v1/models`:

```bash
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

Send the API key in the HTTP `Authorization` header:

```http
Authorization: Bearer sk-supers-...
```

Keep keys server-side in production. Never expose a Super API key in public HTML, browser bundles, logs, screenshots, or source repositories. Create and revoke keys from the authenticated dashboard.

Agents that cannot use dashboard API keys can dynamically register a public OAuth client at `https://app.getsupers.com/oauth/register`, complete Authorization Code with PKCE, and request the least scope needed:

- `api:models` lists models and account credit metadata.
- `api:chat` creates chat completions.
- `api:completions` creates legacy text completions.
- `commerce:subscribe` purchases or renews the authenticated account's Super Powers AI Pro subscription.

Discover the API resource at `https://app.getsupers.com/.well-known/oauth-protected-resource/v1`. OAuth access tokens are audience-bound to `https://app.getsupers.com/v1` and cannot access MCP. MCP tokens remain bound to `https://app.getsupers.com/mcp` and cannot access the API.

## Published endpoints

- `GET /v1/models` lists working model IDs and account-specific metadata.
- `POST /v1/chat/completions` accepts OpenAI-style chat messages.
- `POST /v1/completions` accepts legacy prompt completions.
- `GET /commerce/products/super-pro` publishes the current $199 monthly plan and payment routes.
- `POST /ucp/v1/checkout-sessions` creates a UCP checkout session.
- `POST /commerce/subscriptions/super-pro/mpp` implements MPP Payment authentication with verified recurring PayPal approval.
- `POST /commerce/subscriptions/super-pro/x402` accepts an exact USDC x402 payment for 30 days of Pro access when the merchant wallet and facilitator are configured.

The [OpenAPI specification](https://getsupers.com/openapi.json) is the machine-readable source of truth for request schemas, response schemas, authentication, error responses, streaming, and cache metadata.

Every API response publishes the active `RateLimit-Policy` and `RateLimit` fields plus compatibility `RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset` fields. HTTP 429 adds `Retry-After`. Read the [Super API rate-limit policy](https://getsupers.com/developers/rate-limits) before implementing automated retries.

## API sandbox

The [browser sandbox](https://getsupers.com/developers/#sandbox) sends requests directly to `app.getsupers.com`. It loads the authenticated account's current model list before enabling a completion request. The portal does not persist the entered key.

## Free Android phone farm over MCP

The hosted Super MCP includes an Android phone-farm tier that does not require credits. It is designed for remote MCP clients including Claude, ChatGPT, Codex, and other clients that support OAuth-protected Streamable HTTP.

1. Connect the MCP client to `https://app.getsupers.com/mcp` and request `mcp:android`.
2. Call `super_phone_farm_setup` to receive the current setup contract and the [official Android APK](https://getsupers.com/downloads/super-phone-farm.apk).
3. Install the APK on each Android phone and sign in with the same Super phone number or email.
4. Open a private-device room in Super for each phone.
5. Call `super_list_android_devices`, then `super_run_android_command` for one phone or the whole owned farm.

The free tier includes one owner-scoped private Android room. Android commands use zero Super credits. They can still change apps or public state, so MCP clients must honor the tool's write and destructive annotations and confirm consequential actions.

### Premium upgrades

Call `super_premium_services` to discover the current balance, upgrade URL, and paid capabilities:

- Super Mac app, window, pointer, keyboard, terminal, Chrome, and Codex automation.
- iPhone automation through iPhone Mirroring.
- Meta Display smart-glasses access to private streams.
- Computer-use cache for compatible repeated agent workflows.
- Persistent Super project chat with model, memory, and tool use.

Users add credits from the authenticated [Super API and MCP dashboard](https://app.getsupers.com/developer/api-dashboard). Premium device actions charge only after delivery is accepted; free Android phone-farm commands remain uncharged.

## Hosted MCP status

The hosted Super MCP server is available at `https://app.getsupers.com/mcp` over Streamable HTTP. It exposes free Android phone-farm tools, persistent Super project/chat sessions, and owner-scoped premium remote-device automation through Super WebRTC rooms.

### Connect an MCP client

1. Point the MCP client at `https://app.getsupers.com/mcp`.
2. Follow the OAuth sign-in prompt and log in with the same phone or email used by Super.
3. Approve `mcp:android` for the free Android phone farm; no credits are required to connect or run Android commands.
4. Approve only the additional chat, project, or premium device scopes the client needs.
5. Reuse the `project_id` and `chat_id` returned by `super_chat` to continue one persistent session.

MCP clients can discover OAuth through [Protected Resource Metadata](https://app.getsupers.com/.well-known/oauth-protected-resource/mcp) and discover identity and transport details through the [Super MCP Server Card](https://getsupers.com/.well-known/mcp/server-card.json). Device tools can list only rooms owned by the signed-in account. The generic `super_run_device_command` tool forwards the complete command surface implemented by the connected Super Mac app, including newer commands without requiring a new MCP tool schema.

The [complete hosted MCP documentation](https://getsupers.com/developers/mcp) publishes the canonical transport, compatibility discovery URLs, OAuth scopes, connection sequence, free tier, and billing boundary.

Super Humans separately provides a local stdio MCP package installed with `npx -y super-humans mcp`; its [installation manifest](https://app.getsupers.com/humans/mcp.json) is not the hosted Super MCP endpoint.

## Agent discovery

Agents can discover the API through the [RFC 9727 API catalog](https://getsupers.com/.well-known/api-catalog), install the [Super API Agent Skill](https://getsupers.com/.well-known/agent-skills/super-api/SKILL.md), and enumerate machine-readable resources through the [Agentic Resource Discovery catalog](https://getsupers.com/.well-known/ai-catalog.json). The [authentication guide](https://getsupers.com/auth.md) documents API-key provisioning, OAuth dynamic client registration, named API scopes, token revocation, and the hosted MCP OAuth flow.

## Official desktop streamer CLI

The official CLI is published on npm as [`superpowers-ai`](https://www.npmjs.com/package/superpowers-ai). Install it with `npm install -g superpowers-ai`, then run either `superpowers` or `supers`. The CLI supports account creation or sign-in, starts the private desktop streamer, and prints the authenticated control link. It is intended for Mac, Windows, or Linux computers owned by the signed-in user.

The [official SuperPowers AI CLI documentation](https://getsupers.com/developers/cli) provides the package record, platform requirements, install command, sign-in flow, and guidance for agents.

## API lifecycle

The Super API uses major URL versioning. The current stable resource is `https://app.getsupers.com/v1`; no v1 sunset is scheduled. Read the [versioning and deprecation policy](https://getsupers.com/developers/api-lifecycle) for compatible-change rules, RFC 9745 `Deprecation` signaling, RFC 8594 `Sunset` signaling, and migration notice expectations.

## Support

- [SuperPowers AI Discord](https://discord.gg/supers)
- [SuperPowers AI homepage](https://getsupers.com/)
- [About SuperPowers AI](https://getsupers.com/about)
- [Contact SuperPowers AI](https://getsupers.com/contact)
- [SuperPowers AI Privacy Policy](https://getsupers.com/privacy)
- [Agent-readable product guide](https://getsupers.com/llms.txt)