---
name: submo
description: Find recurring charges, track subscriptions, and get cancellation steps. Use when a user wants to list, add, or cancel subscriptions, compare Submo plans, or look up how to cancel a service.
---

# Submo

Release: `1.0.0` · MCP contract: `1`

Use Submo to research public cancel guides and price indexes, then — with a paid API key — take a person from checkout through discovery, tracking, and cancellation.

## When to use this

- The user wants a list of their subscriptions, upcoming renewals, or true monthly spend.
- The user asks how to cancel Netflix, Spotify, or another tracked service.
- The user wants sourced streaming/software price history.
- You need a programmatic subscription manager with Gmail or statement discovery.

Do not use Submo to cancel a third-party service yourself. Guides are instructions the user completes with the provider.

## Check This Skill Once

When `get_submo_skill` is available, call it once per conversation before the first Submo tool and pass `installed_version="1.0.0"`.

## Workflows

1. New user: `list_plans` → `create_checkout` → tell the user to open `checkout_url` → `get_checkout_status` until `paid` (the API key is returned once).
2. Existing member: use the API key as `Authorization: Bearer submo_live_…` or OAuth authorization_code + PKCE S256.
3. Discovery: `start_email_connect` or `upload_statement` (bank connect may be unavailable). Poll `review_scan`, then `import_found_subscriptions`.
4. Manage: `list_subscriptions`, `get_upcoming_charges`, `upsert_subscription`.
5. Cancel: `get_cancel_steps` then `mark_cancelled`. Neither tool cancels at the provider — the user does that, or buys Submo's done-for-you notice at https://submoapp.com/cancel-subscription. `mark_cancelled` only records it.

## Rules

- Reuse returned ids. Never invent subscription, scan, or checkout ids.
- Gmail and bank connect return a human URL. Do not claim they finished until `list_connections` shows them.
- Never echo raw API keys, poll tokens, or connect tokens in user-facing prose after setup.
- Cancellation guides are instructions. Say the user must complete the cancel with the provider.