Skip to main content
Glama

Tillpad MCP

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

Remote MCP Transport Auth License: MIT

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: 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 中的模式与托管服务器一致。

工具

功能

usage_get

当前周期的用量与配额

budget_get

剩余配额、软阈值和结账 URL

budget_estimate

在花费前预检 402/429(rag_index 使用 textLength / byteLength)

billing_machine_pay

代理如何通过 Stripe MPP 解锁预付 Pro 或购买 SKU(sku 可选)

agent_bootstrap

零人工入门:通过邮箱获取引导令牌(无外发邮件)

keys_create

从账户 tp_ 密钥生成运行/子密钥

kvp_put

在命名空间/键下存储字符串(响应包含 budget)

kvp_get

读取命名空间值

kvp_delete

删除 KVP 键

kvp_list

列出命名空间中的键

file_upload

上传 UTF-8 文本用于 RAG 索引(prefLights rag_index)

files_list

列出已上传文件

files_types

支持的上传扩展名和 MIME 类型

rag_search

对已索引文档进行语义搜索

inspect_storage

命名空间清单(适用时限定于该密钥)

run_finish

擦除绑定到此运行密钥的命名空间;返回签名擦除回执

support_contact

从 Pro 账户联系 Tillpad 支持;回复发送至账户邮箱

典型代理循环

  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 产品(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 管理页面:

字段

值

构建步骤

["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 — 仅目录、文档和模式存根。

Available Tools

17 tools
agent_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_listCInspect

List keys in a KVP namespace

Inputs: namespace (required), limit, cursor.

kvp_putBInspect

Store a string value under a namespace/key. Response includes budget remaining.

Inputs: key (required), value (required), namespace (required), expirationTtl.

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).

usage_getAInspect

Get current period usage and quotas for the authenticated account

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 17 tools

    Disambiguation4/5

    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.

    Naming Consistency2/5

    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.

    Tool Count3/5

    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.

    Completeness3/5

    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

    ActivityActive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      13
      1
      MIT