# 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.

## Discovery

- Canonical Streamable HTTP endpoint: https://app.getsupers.com/mcp
- MCP Server Card: https://getsupers.com/.well-known/mcp/server-card.json
- Server Card compatibility alias: https://getsupers.com/.well-known/mcp.json
- Transport-specific Server Card: https://app.getsupers.com/mcp/server-card
- OAuth Protected Resource Metadata: https://app.getsupers.com/.well-known/oauth-protected-resource/mcp
- OAuth Authorization Server Metadata: https://app.getsupers.com/.well-known/oauth-authorization-server

## Free Android endpoint

Use `https://app.getsupers.com/mcp/android` for the free-only surface. Login is required and one Android device connected through the official Super APK is included. The endpoint exposes only setup, device listing, and Android command tools, and those tools require zero Super credits.

- Android Server Card: https://getsupers.com/.well-known/mcp/android/server-card.json
- Android OAuth metadata: https://app.getsupers.com/.well-known/oauth-protected-resource/mcp/android
- APK: https://getsupers.com/downloads/super-phone-farm.apk
- Setup guide: https://getsupers.com/developers/android-mcp.md

## OAuth scopes

- `mcp:android`: set up, list, and control the included Android device.
- `mcp:projects`: create and read owner-scoped Super project state.
- `mcp:chat`: continue persistent Super project chat using account credits.
- `mcp:devices`: list and control eligible owner-scoped premium devices.

Tokens are resource-bound. An MCP token cannot be used with `https://app.getsupers.com/v1`, and a Super API token cannot be used with the MCP resource.

## Connection sequence

1. Read the Server Card and OAuth Protected Resource Metadata.
2. Dynamically register the MCP client if it does not already have a client identifier.
3. Complete Authorization Code with PKCE and request only the scopes needed for the task.
4. Send `initialize` to the Streamable HTTP endpoint.
5. Call `tools/list` and use the published tool input schemas and annotations.
6. Begin Android setup with `super_phone_farm_setup` when using the included free device.

## 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.