# Submo MCP (submoapp.com)

> Two hosted MCP servers for Submo, the subscription manager at
> https://submoapp.com. Streamable HTTP. One needs no key.

## Endpoints

- Product MCP: `https://api.submoapp.com/mcp` — also `https://mcp.submoapp.com`
- Research MCP, no key: `https://api.submoapp.com/mcp/docs` — also `https://mcp.submoapp.com/docs`
- Server cards: [product](https://submoapp.com/.well-known/mcp/server-card.json) · [research](https://submoapp.com/.well-known/mcp/docs-server-card.json)

Both speak streamable HTTP. Fetch the server card to preview the tool list and
the in-agent views without opening a transport.

## Auth

Public research tools work unauthenticated. Account tools need
`Authorization: Bearer submo_live_…`, from agent checkout (`create_checkout`)
or the OAuth authorization_code + PKCE S256 flow described in
[auth.md](https://submoapp.com/auth.md).

Use the canonical `https://api.submoapp.com/mcp` for authenticated connections. OAuth
metadata — the issuer, and the `resource` in Protected Resource Metadata — is
scoped to `https://api.submoapp.com`, so a client that validates the resource against the
host it connected to should use that one. `https://mcp.submoapp.com` is an alias on the
same server and is fine for key-free research.

## What the tools do

- Research, no key: `list_plans`, `search_cancel_guides`, `get_cancel_guide`, `list_price_indexes`, `get_price_index`, `search_catalog`, `get_submo_skill`.
- Membership: `create_checkout`, `get_checkout_status`.
- Account, paid key: `get_account`, `list_subscriptions`, `upsert_subscription`, `get_upcoming_charges`, `export_subscriptions`, `ask_advisor`.
- Discovery, paid key: `list_connections`, `start_email_connect`, `start_bank_connect`, `upload_statement`, `start_email_scan`, `review_scan`, `import_found_subscriptions`.
- Cancellation: `get_cancel_steps`, `mark_cancelled`. Submo returns steps; the user completes the cancellation with the provider.

## MCP Apps (in-agent UI)

This server implements the MCP Apps extension `io.modelcontextprotocol/ui`.
Views are `ui://` resources served as `text/html;profile=mcp-app`, and the
tools that render them declare `_meta.ui.resourceUri` in `tools/list`:

- `ui://submo/checkout` — `create_checkout`, `get_checkout_status`
- `ui://submo/subscriptions` — `list_subscriptions`
- `ui://submo/cancel-guide` — `get_cancel_guide`, `get_cancel_steps`

## Other surfaces

- [REST + OpenAPI](https://submoapp.com/openapi.json)
- [Developer portal](https://submoapp.com/developers)
- [Docs index](https://submoapp.com/docs/llms.txt)