# Submo docs (submoapp.com)

> Every machine-readable document Submo publishes, with what each one answers.
> Submo is the subscription manager at https://submoapp.com — it finds recurring
> charges, tracks renewals, and returns cancellation steps the user completes
> with the provider.

## Start here

- [Submo developer portal](https://submoapp.com/developers) — the human page: surfaces, auth, quickstart.
- [Submo developer llms.txt](https://submoapp.com/developers/llms.txt) — the same thing without the HTML.
- [Submo MCP llms.txt](https://submoapp.com/mcp/llms.txt) — MCP endpoints, tools, and in-agent views.
- MCP endpoint: `https://mcp.submoapp.com` (canonical: `https://api.submoapp.com/mcp`)

## API reference

- [OpenAPI 3.1 description](https://submoapp.com/openapi.json) — every /v1 path, schema, and error shape.
- API base: `https://api.submoapp.com/v1` (also proxied at `https://submoapp.com/v1`)
- No-key example: `GET https://api.submoapp.com/v1/plans`
- Errors: every 4xx/5xx is `{ "error": { "code", "message", "hint", "docs_url" } }`. Branch on `code`.
- Webhooks: Submo publishes none. Long-running work is polled — `POST /v1/scans/email` or `POST /v1/scans/statement` returns 202, then `GET /v1/scans/{id}` until `status` is `complete`.

## Authentication

- [auth.md](https://submoapp.com/auth.md) — prose walkthrough: discover, register, claim, use, revoke.
- [Protected Resource Metadata](https://api.submoapp.com/.well-known/oauth-protected-resource)
- [Authorization Server Metadata](https://api.submoapp.com/.well-known/oauth-authorization-server)
- Public research needs no key. Account tools need `Authorization: Bearer submo_live_…`.

## Agent contracts

- [SKILL.md](https://submoapp.com/SKILL.md) — the workflow contract: which tool, in what order.
- [AGENTS.md](https://submoapp.com/AGENTS.md) — house rules for agents operating Submo.
- [A2A agent card](https://submoapp.com/.well-known/agent-card.json)
- [AI Catalog (ARD)](https://submoapp.com/.well-known/ai-catalog.json) — one manifest listing all of the above.

## Product and research

- [Product brief](https://submoapp.com/llms.txt) — what Submo does, pricing, FAQ.
- [Price research](https://submoapp.com/data/llms.txt) — sourced US subscription price histories and CSVs.
- [Source](https://github.com/selimhancakir/submo)

The API and MCP never cancel at the provider — they return steps. Submo's paid done-for-you notice service is a website flow, not an API surface.