kordi_list_subscriptions — read

\n\n**Args**\n- `include_paused` (boolean, default `false`) — include paused subscriptions\n- `offset` (number, default `0`) — pagination start\n- `limit` (number, 1–100, default `50`) — page size\n\n**Returns**\n```json\n{\n \"subscriptions\": [ { \"id\": \"netflix\", \"name\": \"Netflix\", \"price\": 15.99, \"billingDate\": 12, \"state\": \"ACTIVE\" } ],\n \"count\": 1,\n \"total_count\": 1,\n \"offset\": 0,\n \"limit\": 50,\n \"has_more\": false,\n \"total_monthly\": 15.99\n}\n```\n

\n\n

kordi_analyze_billing_health — read

\n\nTakes no arguments. Returns total monthly spend, active/paused counts, `price_hikes`, `unused_services`, `savings_potential`, `top_savings_candidate`, `billing_clusters`, and a `health_score` (0–100, higher is healthier).\n

\n\n

kordi_get_cancellation_route — action

\n\n**Args**\n- `service_id` (string, required) — the exact `id` from `kordi_list_subscriptions`\n- `reason` (`too_expensive` | `not_using` | `switching_service` | `finished_content`, optional)\n\nReturns `{ \"success\": true, \"service\": \"Netflix\", \"cancellation_url\": \"https://…\" }`. Call only when the user explicitly asks to cancel or pause.\n

\n\n

kordi_ingest_subscription — write

\n\n**Args**\n- `name` (string, required) — e.g. `\"Disney+\"`\n- `amount` (number, required) — monthly amount in USD\n- `bill_date` (number 1–31, or ISO date string) — billing day or date\n- `source` (`qira` | `screenpipe` | `manual`, optional) — discovery-source attribution\n\nDedupes by name (re-calling updates amount/bill date). Returns `{ status, subscription, pause_link, dashboard_url }`.\n

\n\n

kordi_get_top_shows — read

\n\n**Args**\n- `limit` (number, 1–50, default `10`)\n- `sort_by` (`swipes` | `likes` | `like_rate`, default `swipes`)\n\nReturns a cross-user popularity leaderboard. Aggregate only — no per-user data.\n

\n\n---\n\n## Auth & identity model\n\n- Your token resolves server-side to your Kordi account. Every tool call is **scoped to your account** — you can only ever see and act on your own subscriptions.\n- Identity is bound once per session at the edge; a session cannot be re-bound to a different user mid-stream.\n- Sensitive card fields (PAN, CVV, expiry, raw token) are **stripped** from every response — they never leave the server.\n- Tokens are short-to-medium-lived (90 days). Treat them as secrets. You can rotate at [kordiapp.com/token](https://kordiapp.com/token?ref=github) at any time.\n\n## Limits\n\n- **Rate limit:** 20 tool calls per 60 seconds per session. Over the limit, tools return a back-off message instead of hitting the database — your agent should wait, not retry-loop.\n- **Response size:** large list responses are capped (~25k chars); page with `offset`/`limit` for big accounts.\n- **Pause/cancel links** are signed and expire after 7 days.\n\n---\n\n## For integration partners\n\nDiscovery sources (email-intelligence agents, on-screen detection pipes, etc.) can push subscriptions into a user's Kordi account via `kordi_ingest_subscription`, or provision brand-new users via the public `POST /api/guest-ingest` endpoint. See [kordiapp.com/developers](https://kordiapp.com/developers) for the partner provisioning flow, source attribution, and the `x-partner-key` model.\n\n## Links\n\n- **Web app:** [kordiapp.com](https://kordiapp.com)\n- **Developer docs:** [kordiapp.com/developers](https://kordiapp.com/developers)\n- **Get a token:** [kordiapp.com/token](https://kordiapp.com/token?ref=github)\n- **MCP Registry listing:** [`com.kordiapp/kordi-mcp-server`](https://registry.modelcontextprotocol.io/v0/servers?search=kordi)\n- **Model Context Protocol:** [modelcontextprotocol.io](https://modelcontextprotocol.io)\n\n## License\n\nDocumentation and the registry manifest in this repository are released under the [MIT License](https://github.com/kordi-labs/kordi-mcp-server/blob/main/LICENSE). The Kordi server, brand, and backend are proprietary; this repo does not contain server source code.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","categoryDisplayName","AI Agents","upstream",{"_94":95,"_96":97,"_98":-5,"_99":100,"_101":102},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_92":57,"_93":57},"ratingAvg","reviewCount","topics",[],"license","MIT","language","registryName","com.kordiapp/kordi-mcp-server","homepage","https://kordiapp.com/developers","ENV",{"_105":106,"_107":108,"_109":110},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

Kordi — Subscription Intelligence