Skip to main content
Glama

Tillpad MCP

エージェントジョブ向けの境界付きストレージと検索。

Remote MCP Transport Auth License: MIT

Tillpadは、エージェントに名前空間付きキーバリューストレージ、ファイルアップロード+セマンティック検索、予算対応メータリング、そしてジョブ完了時に署名付きレシートとともに消去されるランキーを提供します。

ライブエンドポイント: https://tillpad.cnrcode.com/mcp

このリポジトリは、ディレクトリクローラー向けの公開カタログ兼スキーマスタブです。ホスト型サーバーではありません。MCPクライアントには、Tillpad APIキーを指定して上記のライブURLを設定してください。このリポジトリ内のTypeScriptを実行しても、ストレージや検索は一切行われません。

エージェントガイド: ディスカバリURL、認証、MCP接続スニペットについては、AGENTS.md を参照してください。

APIキーを取得する

ゼロヒューマン(エージェント)

  1. POST https://tillpad.cnrcode.com/api/agents/bootstrap を { "email": "agent@example.com" } とともに呼び出すと bootstrapToken が返ります(外部メールは送信されません)。

  2. Authorization: Bearer <bootstrapToken> と任意の { "sku": "pro_prepaid_30d" } を指定して POST https://tillpad.cnrcode.com/api/billing/machine-pay を呼び出します。

  3. Stripe MPP($9.00 / 30日)で決済すると、レスポンスに secret(tp_…)と planPeriodEnd が含まれます。

scratchpad.txt と llms-full.txt を参照してください。法的情報: 利用規約。

ヒューマン向けの手順

  1. tillpad.cnrcode.com を開いてアカウントを作成します。

  2. Pricing で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 内のスキーマはホスト型サーバーと一致しています。

Tool

説明

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

RAGインデックス用にUTF-8テキストをアップロード(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" — Stripe MPP経由のエージェント向けプリペイドPro(30/90日)またはチャージアップ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 を設定します(16進数。cnrcode-site の鍵生成スクリプトを参照)。

  3. バージョンタグをプッシュすると、GitHub Actions が server.json を公式MCPレジストリに公開します:

    git tag v0.1.1
    git push origin v0.1.1
  4. 任意で 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管理ページを設定します:

フィールド

値

ビルド手順

["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