Tillpad MCP

面向代理任务的有界存储与搜索。

Tillpad 为代理提供命名空间键值存储、文件上传与语义搜索、预算感知计量，以及运行密钥——任务完成时可用签名回执擦除数据。

实时端点： https://tillpad.cnrcode.com/mcp

本仓库是面向目录爬虫的公开目录与模式存根，并非托管服务器。请将 MCP 客户端指向上述实时 URL，并使用 Tillpad API 密钥。运行本仓库中的 TypeScript 不会存储或搜索任何内容。

代理指南： 参见 AGENTS.md 了解发现 URL、认证和 MCP 连接片段。

获取 API 密钥

零人工（代理）

1. 向 POST https://tillpad.cnrcode.com/api/agents/bootstrap 发送 { "email": "agent@example.com" } → 获得 bootstrapToken（无外发邮件）。

2. 向 POST https://tillpad.cnrcode.com/api/billing/machine-pay 发送请求，携带 Authorization: Bearer <bootstrapToken> 及可选的 { "sku": "pro_prepaid_30d" }。

3. 结算 Stripe MPP（$9.00 / 30 天）→ 响应中包含 secret（tp_…）和 planPeriodEnd。

参见 scratchpad.txt 和 llms-full.txt。法律条款：条款。

人工路径

1. 打开 tillpad.cnrcode.com 并创建账户。

2. 在定价页面订阅 Tillpad Pro，然后在仪表盘中生成 API 密钥。密钥以 tp_ 开头。

3. 持续访问使用账户密钥；任务需要过期并擦除时使用运行密钥。

切勿提交真实密钥。在配置中使用 tp_… 占位符。

Related MCP server: ContextKeep

连接客户端

传输方式为 Streamable HTTP。每个请求都需携带 Authorization: Bearer tp_…。

Cursor

用户或项目 MCP 配置：

{
  "mcpServers": {
    "tillpad": {
      "url": "https://tillpad.cnrcode.com/mcp",
      "headers": {
        "Authorization": "Bearer tp_…"
      }
    }
  }
}

Claude Desktop / Claude Code

{
  "mcpServers": {
    "tillpad": {
      "command": "npx",
      "args": ["mcp-remote", "https://tillpad.cnrcode.com/mcp", "--header", "Authorization: Bearer tp_…"]
    }
  }
}

通用远程 MCP

{
  "url": "https://tillpad.cnrcode.com/mcp",
  "headers": {
    "Authorization": "Bearer tp_…"
  }
}

产品主机上的发现清单：

• /.well-known/mcp.json

• /.well-known/mcp/server.json

• /llms.txt

工具

src/server.ts 中的模式与托管服务器一致。

典型代理循环

1. 在仪表盘中生成运行密钥（专用命名空间、TTL、可选操作预算）。

2. 使用 kvp_put 和/或 file_upload 存储工作状态。

3. 使用 kvp_get / kvp_list 和 rag_search 检索。

4. 调用 run_finish 擦除运行命名空间并保留签名回执。

大型索引任务前使用 budget_estimate。budget_get / usage_get 显示周期内剩余额度。

认证与错误

• 401 — 缺少或无效的 Authorization: Bearer tp_…

• 402 / 429 — 套餐或配额。JSON 包含 code、status、actions 和 budget

  • actions[].type: "checkout" — 面向周期性人工订阅的托管 Stripe Checkout URL

  • actions[].type: "machine_pay" — 代理预付 Pro（30/90 天）或通过 Stripe MPP 充值 SKU；默认 sku pro_prepaid_30d，$9.00

这是 Stripe Machine Payments Protocol，而非 ChatGPT Instant Checkout / ACP。

产品文档

• 应用：tillpad.cnrcode.com

• 文档：tillpad.cnrcode.com/docs

• 草稿本：tillpad.cnrcode.com/docs/scratchpad

• OpenAPI：tillpad.cnrcode.com/openapi.json

Tillpad 产品（Worker、计费、存储）为闭源。本目录以 MIT 许可发布，便于目录列出工具和安装片段。

目录列表

注册名称：com.cnrcode/tillpad（通过 cnrcode.com 的域名命名空间）。

1. 确保 https://cnrcode.com/.well-known/mcp-registry-auth 已部署（cnrcode-site 仓库）。

2. 设置 GitHub 仓库密钥 MCP_PRIVATE_KEY（十六进制；参见 cnrcode-site 密钥生成脚本）。

3. 推送版本标签，使 GitHub Actions 将 server.json 发布到官方 MCP 注册表：

   git tag v0.1.1
   git push origin v0.1.1

4. 可选：在 mcp.directory/submit 提交 https://github.com/number1101/tillpad-mcp。

Glama

本仓库包含一个 stdio 目录存根（src/main.ts），使 Glama 能够构建容器、启动进程并检查 17 个工具定义。它不实现存储或计费——客户端仍连接上述托管端点。

列表：glama.ai/mcp/servers/number1101/tillpad-mcp

通过 glama.json 认领后，配置 Dockerfile 管理页面：

Glama 根据该表单生成自己的 Dockerfile；仓库中的 Dockerfile 仅用于本地冒烟测试。

评分徽章（用于 awesome-mcp-servers 及类似列表）：

[![number1101/tillpad-mcp MCP server](https://glama.ai/mcp/servers/number1101/tillpad-mcp/badges/score.svg)](https://glama.ai/mcp/servers/number1101/tillpad-mcp)

本地验证：

npm ci && npm run build && npm start   # hangs on stdio — expected
docker build -t tillpad-mcp-stub . && docker run -i tillpad-mcp-stub

完整分步指南（认领、管理 Dockerfile、发布、awesome-mcp PR）：docs/glama-release.md。

许可证

MIT — 仅目录、文档和模式存根。