tillpad-mcp
Tillpad MCP
エージェントジョブ向けの境界付きストレージと検索。
Tillpadは、エージェントに名前空間付きキーバリューストレージ、ファイルアップロード+セマンティック検索、予算対応メータリング、そしてジョブ完了時に署名付きレシートとともに消去されるランキーを提供します。
ライブエンドポイント: https://tillpad.cnrcode.com/mcp
このリポジトリは、ディレクトリクローラー向けの公開カタログ兼スキーマスタブです。ホスト型サーバーではありません。MCPクライアントには、Tillpad APIキーを指定して上記のライブURLを設定してください。このリポジトリ内のTypeScriptを実行しても、ストレージや検索は一切行われません。
エージェントガイド: ディスカバリURL、認証、MCP接続スニペットについては、AGENTS.md を参照してください。
APIキーを取得する
ゼロヒューマン(エージェント)
POST https://tillpad.cnrcode.com/api/agents/bootstrapを{ "email": "agent@example.com" }とともに呼び出すとbootstrapTokenが返ります(外部メールは送信されません)。Authorization: Bearer <bootstrapToken>と任意の{ "sku": "pro_prepaid_30d" }を指定してPOST https://tillpad.cnrcode.com/api/billing/machine-payを呼び出します。Stripe MPP($9.00 / 30日)で決済すると、レスポンスに
secret(tp_…)とplanPeriodEndが含まれます。
scratchpad.txt と llms-full.txt を参照してください。法的情報: 利用規約。
ヒューマン向けの手順
tillpad.cnrcode.com を開いてアカウントを作成します。
Pricing で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 内のスキーマはホスト型サーバーと一致しています。
Tool | 説明 |
| 現在の期間の使用量とクォータ |
| 残りのクォータ、ソフトしきい値、チェックアウトURL |
| 消費前に402/429を事前確認( |
| エージェントがStripe MPP経由でプリペイドProを有効化、またはSKUを購入する方法( |
| ゼロヒューマンオンボーディング: メールからブートストラップトークンを取得(外部メールは送信されません) |
| アカウントの |
| 名前空間/キーに文字列を保存(レスポンスに |
| 名前空間付きの値を読み取る |
| KVPキーを削除 |
| 名前空間内のキーを一覧表示 |
| RAGインデックス用にUTF-8テキストをアップロード( |
| アップロード済みファイルを一覧表示 |
| 対応するアップロード拡張子と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、budgetが含まれますactions[].type: "checkout"— 定期のヒューマン向けサブスクリプション用のホスト型Stripe Checkout URLactions[].type: "machine_pay"— Stripe MPP経由のエージェント向けプリペイドPro(30/90日)またはチャージアップ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 によるドメイン名前空間)。
https://cnrcode.com/.well-known/mcp-registry-authがデプロイされていることを確認します(cnrcode-siteリポジトリ)。GitHubリポジトリのシークレット
MCP_PRIVATE_KEYを設定します(16進数。cnrcode-siteの鍵生成スクリプトを参照)。バージョンタグをプッシュすると、GitHub Actions が
server.jsonを公式MCPレジストリに公開します:git tag v0.1.1 git push origin v0.1.1任意で https://github.com/number1101/tillpad-mcp を mcp.directory/submit に提出します。
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