tillpad-mcp
Tillpad MCP
面向代理任务的有界存储与搜索。
Tillpad 为代理提供命名空间键值存储、文件上传与语义搜索、预算感知计量,以及运行密钥——任务完成时可用签名回执擦除数据。
实时端点: https://tillpad.cnrcode.com/mcp
本仓库是面向目录爬虫的公开目录与模式存根,并非托管服务器。请将 MCP 客户端指向上述实时 URL,并使用 Tillpad API 密钥。运行本仓库中的 TypeScript 不会存储或搜索任何内容。
代理指南: 参见 AGENTS.md 了解发现 URL、认证和 MCP 连接片段。
获取 API 密钥
零人工(代理)
向
POST https://tillpad.cnrcode.com/api/agents/bootstrap发送{ "email": "agent@example.com" }→ 获得bootstrapToken(无外发邮件)。向
POST https://tillpad.cnrcode.com/api/billing/machine-pay发送请求,携带Authorization: Bearer <bootstrapToken>及可选的{ "sku": "pro_prepaid_30d" }。结算 Stripe MPP($9.00 / 30 天)→ 响应中包含
secret(tp_…)和planPeriodEnd。
参见 scratchpad.txt 和 llms-full.txt。法律条款:条款。
人工路径
打开 tillpad.cnrcode.com 并创建账户。
在定价页面订阅 Tillpad Pro,然后在仪表盘中生成 API 密钥。密钥以
tp_开头。持续访问使用账户密钥;任务需要过期并擦除时使用运行密钥。
切勿提交真实密钥。在配置中使用 tp_… 占位符。
Related MCP server: Agent Memory MCP Server
连接客户端
传输方式为 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_…"
}
}产品主机上的发现清单:
工具
src/server.ts 中的模式与托管服务器一致。
工具 | 功能 |
| 当前周期的用量与配额 |
| 剩余配额、软阈值和结账 URL |
| 在花费前预检 402/429( |
| 代理如何通过 Stripe MPP 解锁预付 Pro 或购买 SKU( |
| 零人工入门:通过邮箱获取引导令牌(无外发邮件) |
| 从账户 |
| 在命名空间/键下存储字符串(响应包含 |
| 读取命名空间值 |
| 删除 KVP 键 |
| 列出命名空间中的键 |
| 上传 UTF-8 文本用于 RAG 索引(prefLights |
| 列出已上传文件 |
| 支持的上传扩展名和 MIME 类型 |
| 对已索引文档进行语义搜索 |
| 命名空间清单(适用时限定于该密钥) |
| 擦除绑定到此运行密钥的命名空间;返回签名擦除回执 |
| 从 Pro 账户联系 Tillpad 支持;回复发送至账户邮箱 |
典型代理循环
在仪表盘中生成运行密钥(专用命名空间、TTL、可选操作预算)。
使用
kvp_put和/或file_upload存储工作状态。使用
kvp_get/kvp_list和rag_search检索。调用
run_finish擦除运行命名空间并保留签名回执。
大型索引任务前使用 budget_estimate。budget_get / usage_get 显示周期内剩余额度。
认证与错误
401 — 缺少或无效的
Authorization: Bearer tp_…402 / 429 — 套餐或配额。JSON 包含
code、status、actions和budgetactions[].type: "checkout"— 面向周期性人工订阅的托管 Stripe Checkout URLactions[].type: "machine_pay"— 代理预付 Pro(30/90 天)或通过 Stripe MPP 充值 SKU;默认 skupro_prepaid_30d,$9.00
这是 Stripe Machine Payments Protocol,而非 ChatGPT Instant Checkout / ACP。
产品文档
OpenAPI:tillpad.cnrcode.com/openapi.json
Tillpad 产品(Worker、计费、存储)为闭源。本目录以 MIT 许可发布,便于目录列出工具和安装片段。
目录列表
注册名称:com.cnrcode/tillpad(通过 cnrcode.com 的域名命名空间)。
确保
https://cnrcode.com/.well-known/mcp-registry-auth已部署(cnrcode-site仓库)。设置 GitHub 仓库密钥
MCP_PRIVATE_KEY(十六进制;参见cnrcode-site密钥生成脚本)。推送版本标签,使 GitHub Actions 将
server.json发布到官方 MCP 注册表:git tag v0.1.1 git push origin v0.1.1可选:在 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 管理页面:
字段 | 值 |
构建步骤 |
|
CMD 参数 |
|
环境变量模式 | 默认(空——无需凭据) |
占位参数 |
|
Glama 根据该表单生成自己的 Dockerfile;仓库中的 Dockerfile 仅用于本地冒烟测试。
评分徽章(用于 awesome-mcp-servers 及类似列表):
[](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 — 仅目录、文档和模式存根。
Available Tools
17 toolsagent_bootstrapAInspect
Start zero-human onboarding: create bootstrap token from email (no outbound mail). Next POST /api/billing/machine-pay with Bearer bootstrapToken.
Inputs: email (required), label.
billing_machine_payAInspect
Describe how to unlock Pro or purchase agent SKUs via Stripe MPP. Optional sku (default pro_prepaid_30d). Returns POST URL and amount; agent must call HTTP with MPP Payment credential.
Inputs: sku.
budget_estimateAInspect
Estimate whether an operation would hit 402/429 before spending. For rag_index you can pass textLength/byteLength instead of amount.
Inputs: kind (required), amount, byteLength, textLength.
budget_getBInspect
Get remaining quotas, soft thresholds, and checkout URL for topping up
Inputs: no named parameters.
files_listCInspect
List uploaded files (optionally filter by namespace)
Inputs: namespace.
files_typesAInspect
List supported RAG upload file types (extensions, MIME types, extract notes)
Inputs: no named parameters.
file_uploadCInspect
Upload a UTF-8 text document for RAG indexing into a namespace. PrefLights rag_index capacity.
Inputs: text (required), filename (required), namespace (required), contentType.
inspect_storageBInspect
Summarize namespaces, key counts, file/vector inventory
Inputs: no named parameters.
keys_createAInspect
Mint a run or sub API key from an account key (REST POST /api/keys). Requires account tp_ key.
Inputs: kind (required), name, tools, opBudget, +3 more.
kvp_deleteCInspect
Delete a KVP key
Inputs: key (required), namespace (required).
kvp_getCInspect
Read a value from namespaced KVP storage
Inputs: key (required), namespace (required).
kvp_putBInspect
Store a string value under a namespace/key. Response includes budget remaining.
Inputs: key (required), value (required), namespace (required), expirationTtl.
rag_searchCInspect
Semantic search over indexed documents
Inputs: query (required), topK, namespace.
run_finishAInspect
Wipe all namespaces bound to this run key and return a signed wipe receipt. Only valid for run keys.
Inputs: no named parameters.
support_contactAInspect
Contact Tillpad support from a Pro account. Delivers your subject and message to the Tillpad team; replies go to the account email. Requires an active Pro subscription.
Inputs: message (required), subject (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 17 tools
Each tool targets a distinct operation within its area—billing, keys, KVP, files/RAG, support—and the descriptions clarify boundaries. usage_get and budget_get both report quota state but with different focuses, and inspect_storage aggregates rather than duplicating the CRUD tools. Overall, misselection risk is low.
Names mix verb-first styles (usage_get, file_upload, inspect_storage) with noun-first styles (keys_create, kvp_put, run_finish) and compound nouns like billing_machine_pay. There is no consistent verb_noun convention, though prefixes like kvp_ and files_ provide some structure.
17 tools is at the high end for a single MCP server and spans several unrelated domains: billing, key management, key-value storage, RAG files, and support. For a multi-purpose platform API the count is defensible, but it is heavier than a focused, well-scoped server should be.
KVP storage has full CRUD and RAG covers upload, listing, and semantic search, but file deletion is missing and key management only supports creation, not listing or revocation. Billing covers usage and budgets but not detailed subscription state or payment history. These gaps are workable but notable for a platform toolkit.
Maintenance
Related MCP Connectors
Persistent cloud memory for AI agents. Store and search key-value memories across sessions.
Persistent memory for AI agents. Search and store durable facts, preferences and decisions.
Persistent memory for AI agents: save, search and connect context across tools and sessions.
Governed local-first memory and continuity for AI agents — signed receipts, optional hosted lane.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides AI agents with persistent, searchable memory that survives across conversations using semantic search, temporal versioning, and smart organization. Enables long-term context retention and cross-session continuity for AI assistants.14-
- AlicenseAqualityDmaintenanceProvides persistent key-value storage with full-text search, tags, and namespaces for AI agents to maintain context across sessions.760 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to automatically capture durable knowledge and retrieve only relevant, token-bounded context from a secure local-first long-term memory, with support for progressive disclosure, snapshots, health diagnostics, and background tasks.Apache 2.0
- AlicenseBqualityBmaintenanceEnables agents and apps to verify end-user identity through company API keys, human login links with multi-channel notifications, OIDC client registration, and budget-aware billing.131MIT