Kordi

Kordi MCP Server

通过任意 AI Agent 跟踪、分析并管理流媒体和 SaaS 订阅。

Kordi 是一个订阅智能平台。这个 Model Context Protocol 服务让任何支持 MCP 的 AI 客户端——Claude Desktop、Cursor、Raycast 或你自己的 Agent——都能读取用户跟踪的订阅、评估其账单状况、发现省钱机会、生成取消／暂停链接，并添加新发现的订阅。

这是一个托管式远程 MCP 服务。无需安装或在本地运行任何内容——只需使用令牌连接到一个 URL。

• 端点： https://kordiapp.com/mcp
• 传输方式： Streamable HTTP
• 身份验证： Authorization: Bearer <token>
• 注册表： 官方 MCP Registry 上的 com.kordiapp/kordi-mcp-server
• 文档： kordiapp.com/developers

快速开始

1. 获取令牌

登录 kordiapp.com，并在 kordiapp.com/token 生成 API 令牌。令牌有效期为 90 天，仅对你自己的订阅授予读写权限。

2. 连接客户端

Claude Desktop——将以下内容添加到你的 claude_desktop_config.json（参见 examples/）：

{
  "mcpServers": {
    "kordi": {
      "type": "streamable-http",
      "url": "https://kordiapp.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

任意客户端／原始 HTTP——将令牌作为 Bearer 标头传递（首选方式——令牌不会出现在日志、Referer 或历史记录中）：

# List the available tools
curl -X POST "https://kordiapp.com/mcp" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

为兼容旧版，也接受 ?token=<token> 这一旧式查询字符串形式，但建议使用标头。

3. 开始提问

“我每个月都在为哪些服务付费？” “暂停哪些订阅可以省钱？” “最近有没有涨价或即将结束的试用？” “我刚订阅了 Apple TV+，每月 $9.99——帮我记录一下。”

工具

此外还有一个资源：

此外还有一个平台分析工具（kordi_get_analytics），但仅限管理员使用。

工具详情

{
  "subscriptions": [ { "id": "netflix", "name": "Netflix", "price": 15.99, "billingDate": 12, "state": "ACTIVE" } ],
  "count": 1,
  "total_count": 1,
  "offset": 0,
  "limit": 50,
  "has_more": false,
  "total_monthly": 15.99
}

身份验证与身份模型

• 你的令牌会在服务端解析为你的 Kordi 账户。每次工具调用都限定在你的账户范围内——你只能查看和操作自己的订阅。
• 身份在每个会话开始时于边缘节点绑定；会话在进行过程中不能重新绑定到其他用户。
• 敏感的卡片字段（PAN、CVV、有效期、原始令牌）会从每个响应中剔除，绝不会离开服务器。
• 令牌的有效期为中短期（90 天）。请将其视为机密。你可以随时在 kordiapp.com/token 轮换令牌。

限制

• **速率限制：**每个会话每 60 秒最多调用 20 次工具。超出限制时，工具会返回退避提示，而不会访问数据库——你的 Agent 应等待，而不是循环重试。
• **响应大小：**大型列表响应的上限约为 25k 个字符；账户数据较多时，请使用 offset/limit 分页。
• 暂停／取消链接已签名，有效期为 7 天。

面向集成合作伙伴

发现来源（电子邮件情报 Agent、屏幕检测管道等）可以通过 kordi_ingest_subscription 将订阅推送到用户的 Kordi 账户，也可以通过公开的 POST /api/guest-ingest 端点为全新用户创建账户。有关合作伙伴配置流程、来源归因和 x-partner-key 模型，请参阅 kordiapp.com/developers。

链接

• Web 应用：kordiapp.com
• 开发者文档：kordiapp.com/developers
• 获取令牌：kordiapp.com/token
• MCP Registry 条目：com.kordiapp/kordi-mcp-server
• Model Context Protocol：modelcontextprotocol.io

许可证

本仓库中的文档和 Registry 清单以 MIT License 发布。Kordi 服务、品牌和后端为专有内容；本仓库不包含服务端源代码。