Tillpad

Tillpad MCP

为 AI Agent 提供工作所需的一切，并设置不可超出的支出上限。

Tillpad 为 Agent 提供命名空间键值存储、文件上传和语义搜索、仅接收邮件的收件箱、预算感知计量，以及任务完成后可清除数据并附带签名回执的运行密钥。

在线端点： https://tillpad.dev/mcp

之前的端点 https://tillpad.cnrcode.com/mcp 仍提供相同的服务，因此现有客户端配置继续有效。

此仓库是供目录爬虫使用的公开目录和架构存根，不是托管服务。请使用 Tillpad API 密钥，让 MCP 客户端连接到上方的在线 URL。在此仓库中运行 TypeScript 不会存储或搜索任何内容。

Agent 指南： 请参阅 AGENTS.md，了解发现 URL、身份验证和 MCP 连接示例。

获取 API 密钥

无需人工介入（Agent）

1. 使用 { "email": "[email protected]" } 向 POST https://tillpad.dev/api/agents/bootstrap 发送请求 → 获得 bootstrapToken（不会发送外发邮件）。
2. 使用 Authorization: Bearer <bootstrapToken> 和可选的 { "sku": "pro_prepaid_30d" } 向 POST https://tillpad.dev/api/billing/machine-pay 发送请求。
3. 完成 Stripe MPP 结算（9.00 美元 / 30 天）→ 响应中包含 secret（tp_…）和 planPeriodEnd。

请参阅 scratchpad.txt 和 llms-full.txt。法律条款：Terms。

人工操作

1. 打开 tillpad.dev 并创建账户。
2. 在 Pricing 订阅 Tillpad Pro，然后在控制面板中生成 API 密钥。密钥以 tp_ 开头。
3. 持续访问时使用账户密钥；需要在任务结束时过期并清除数据时，使用运行密钥。

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

连接客户端

传输方式为 Streamable HTTP。每次请求都要发送 Authorization: Bearer tp_…。

Cursor

通过 Cursor Marketplace 安装（插件）

此仓库包含一个 Cursor 插件清单 和根目录中的 mcp.json，可从 Cursor Marketplace 一键安装。

Tillpad MCP 工具涵盖命名空间 KVP、RAG 搜索、仅接收邮件的收件箱、定时 HTTPS 任务、预算计量，以及运行密钥清除回执。

1. 从 Marketplace 安装 Tillpad 插件（或在本地测试——见下文）。
2. 打开 Cursor Settings → Customize → Tillpad，设置 Tillpad API key（通过 bootstrap + machine-pay 获取，或从控制面板获取 tp_…）。
3. 重新加载窗口。MCP 工具应会出现在 Tillpad 服务下。

该插件指向 https://tillpad.dev/mcp，并使用 Authorization: Bearer ${TILLPAD_API_KEY}。切勿提交真实密钥。

本地测试插件（提交到 Marketplace 之前）：

# Copy catalog repo into Cursor local plugins folder
$dest = "$env:USERPROFILE\.cursor\plugins\local\tillpad"
New-Item -ItemType Directory -Force -Path $dest | Out-Null
Copy-Item -Recurse -Force "C:\dev\tillpad\tillpad-mcp\*" $dest
# Then: Cursor Customize → Tillpad → set TILLPAD_API_KEY → Developer: Reload Window

准备就绪后，请在 cursor.com/marketplace/publish 提交公开仓库。

手动 MCP 配置

用户或项目的 MCP 配置：

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

Claude Desktop / Claude Code

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

通用远程 MCP

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

产品主机上的发现清单：

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

工具

src/server.ts 中的架构与托管服务一致。

工具	功能
get_usage	查询一个月的用量（view=summary）、分页历史记录（view=periods）或剩余配额（view=budget）
estimate_usage	在计量扣费前预估是否会触发 402/429（rag_index 使用 textLength / byteLength）
manage_billing	MPP 机器付费说明（action=machine_pay）、Stripe 门户 URL 或购买记录
bootstrap_agent	无需人工参与的入门流程：通过电子邮件获取引导令牌（不会发送外发邮件）
create_api_key	使用账户 tp_ 密钥生成运行密钥或子密钥
manage_kv	写入、获取、删除或列出命名空间字符串
manage_memory	写入或获取 prefs / facts / run 记忆范围
search_documents	对已索引文档或记忆范围进行语义搜索
index_document	索引命名的 UTF-8 文件（kind=file）或简短笔记（kind=note）
list_files	列出上传文件（view=files）或受支持的类型（view=supported_types）
get_storage_summary	命名空间清单（适用时按密钥范围筛选）
finish_run	清除绑定到此运行密钥的命名空间；返回已签名的清除回执
contact_support	联系 Pro 账户的 Tillpad 支持团队；回复将发送至账户邮箱
manage_inbox	创建、列出、获取、删除或审计仅接收型收件箱
read_inbox_message	列出元数据、获取单封邮件、下载原始 MIME，或获取附件
manage_inbox_webhook	注册、列出、停用或检查 email.received webhook 投递记录
manage_inbox_blocklist	列出、添加或移除被屏蔽的发件人地址或域名
manage_schedule	创建、列出、获取、停用 HTTPS 间隔任务，或列出其运行记录

典型 Agent 循环

1. 使用 create_api_key（或控制面板）生成运行密钥：专用命名空间、TTL，以及可选的操作预算。
2. 使用 manage_memory / manage_kv 和／或 index_document 存储工作状态。
3. 使用 manage_memory / manage_kv 和 search_documents 检索数据。
4. 调用 finish_run 清除运行命名空间并保留已签名的回执。

大型索引任务前请使用 estimate_usage。get_usage 可显示当前周期的剩余用量。

身份验证与错误

• 401 — 缺少或无效的 Authorization: Bearer tp_…
• 402 / 429 — 套餐或配额限制。JSON 包含 code、status、actions 和 budget
  • actions[].type: "checkout" — 面向定期人工订阅的托管式 Stripe Checkout URL
  • actions[].type: "machine_pay" — 通过 Stripe MPP 购买 Agent 预付 Pro（30/90 天）或充值 SKU；默认 SKU pro_prepaid_30d，价格为 $9.00

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

产品文档

• 应用：tillpad.dev
• 文档：tillpad.dev/docs
• 便笺：tillpad.dev/docs/scratchpad
• OpenAPI：tillpad.dev/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 Registry：

   git tag v0.1.1
   git push origin v0.1.1
   

4. 也可以在 mcp.directory/submit 提交 https://github.com/CNR-Consulting/tillpad-mcp。

Glama

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

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

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

字段	值
构建步骤	["npm ci", "npm run build"]
CMD 参数	["node", "dist/main.js"]
环境变量架构	默认（空——无需凭据）
占位参数	{}

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 — 仅包含目录、文档和架构存根。