Tillpad

Tillpad MCP

支出上限を超えられないようにしながら、AI エージェントが仕事に必要なすべてを利用できます。

Tillpad は、エージェントに名前空間付きのキー・バリュー・ストレージ、ファイルのアップロードとセマンティック検索、受信専用メール受信箱、予算を考慮した使用量計測、そしてジョブ完了時に署名付きレシートとともに消去されるランキーを提供します。

稼働中のエンドポイント： https://tillpad.dev/mcp

以前のエンドポイント https://tillpad.cnrcode.com/mcp も同じサーバーへの提供を継続するため、既存のクライアント設定は引き続き利用できます。

このリポジトリは、ディレクトリのクローラー向けの公開カタログとスキーマのスタブです。ホストされたサーバーではありません。Tillpad API キーを使って、上記の稼働中 URL に MCP クライアントを接続してください。このリポジトリ内の TypeScript を実行しても、何かが保存されたり検索されたりすることはありません。

エージェントガイド： 検出 URL、認証、MCP 接続スニペットについては AGENTS.md をご覧ください。

API キーを取得する

人の介在なし（エージェント）

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（30 日間で $9.00）を決済すると、レスポンスに 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 Marketplace からワンクリックでインストールするための Cursor プラグインマニフェスト とルートの mcp.json が含まれています。

Tillpad MCP ツールは、名前空間付き KVP、RAG 検索、受信専用メール受信箱、スケジュールされた HTTPS ジョブ、予算の使用量計測、ランキーの消去レシートに対応しています。

1. Marketplace から Tillpad プラグインをインストールします（またはローカルでテストします。手順は以下をご覧ください）。
2. Cursor Settings → Customize → Tillpad を開き、Tillpad API key（bootstrap と machine-pay、またはダッシュボードで取得した tp_…）を設定します。
3. ウィンドウを再読み込みします。Tillpad サーバーの下に MCP ツールが表示されます。

プラグインは Authorization: Bearer ${TILLPAD_API_KEY} を指定して https://tillpad.dev/mcp に接続します。実際のキーをコミットしないでください。

ローカルでプラグインをテストする（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	1か月分の使用状況（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	この run キーに紐づく名前空間を消去し、署名済みの消去レシートを返します
contact_support	Pro アカウントからTillpadサポートに連絡。返信はアカウントのメールアドレスに届きます
manage_inbox	受信専用の受信箱を作成、一覧表示、取得、削除、または監査
read_inbox_message	メタデータの一覧表示、メッセージの取得、生MIMEのダウンロード、または添付ファイルの取得
manage_inbox_webhook	email.received Webhookの配信を登録、一覧表示、無効化、または確認
manage_inbox_blocklist	ブロックする送信者のアドレスまたはドメインを一覧表示、追加、または削除
manage_schedule	HTTPSのインターバルジョブを作成、一覧表示、取得、無効化、または実行一覧を表示

エージェントの一般的なループ

1. create_api_key（またはダッシュボード）で run キーを発行します。専用の名前空間、TTL、任意の操作予算を設定できます。
2. manage_memory / manage_kv および／または index_document を使って作業状態を保存します。
3. manage_memory / manage_kv と search_documents で情報を取得します。
4. finish_run を呼び出して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経由で購入する、エージェント向けプリペイド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 を設定します（hex形式。鍵生成スクリプトは cnrcode-site を参照）。

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

   git tag v0.1.1
   git push origin v0.1.1
   

4. 任意で、https://github.com/CNR-Consulting/tillpad-mcp を mcp.directory/submit から申請します。

Glama

このリポジトリには、Glama がコンテナをビルドしてプロセスを起動し、18 個のツール定義を調査できるようにする stdio カタログスタブ（src/main.ts）が含まれています。ストレージや課金機能は実装していません。クライアントは引き続き上記のホストされたエンドポイントに接続します。

掲載ページ：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 — カタログ、ドキュメント、スキーマスタブのみです。