TaskBullet Site Guide

AI エージェントが実際に電話をかけられます。

相手が電話をかけると、エージェントが回答を受け取ります。サーバーは @taskbullet/mcp-server です。

料金

最初の1分は$2.50、以降は1分ごとに$1です。料金は、プリペイドのVA時間ではなく、通話ウォレットから差し引かれます。対象は米国とカナダの電話番号のみです。録音には対応していません。電話がかからずにシステム障害が発生した場合、全額返金されます。

get_balance は balance_cents（保留中の金額を差し引いた利用可能残高）、holds_cents、wallet_cents を表示します。max_minutes のデフォルト値は5です。上記の料金では、5分間で$6.50です。validate_call は、これから送信する本文に対する hold_cents を返しますが、保留は行いません。hold_cents を使用してください。

HTTP 402 payment_required は、ウォレット残高が保留額に満たないことを示します。addFundsUrl で入金してください。この読み取り操作では、Stripe セッションは作成されません。通話料金は従量課金です。トライアルはありません。

プロンプトの例

サーバーをインストールした後、次のいずれかをエージェントにコピーしてください。プロンプトには、実際の米国またはカナダの電話番号を入力してください。パスワード、ワンタイムコード、API キーは入力しないでください。

予約を取る：

Call the dentist and book me the earliest appointment next Tuesday after 1pm. The office is Bright Smile Dental at (801) 555-0148. Ask which times they have, book one, and bring back the time and any confirmation number. Confirm the hold with me before you place the call. Do not record it.

注文を確認するために販売業者に電話する：

Call Northwind Supply at (415) 555-0199 and check order NW-10442. Ask whether it shipped, the carrier, and the tracking number. Confirm the hold with me before you place the call. US number, no recording.

予約を確認する：

Call Harbor Grill at (206) 555-0177 and confirm the reservation for Alex Chen, party of 4, this Friday at 7:00pm. Ask them to say the name, time, and party size back. Confirm the hold with me before you place the call. Do not record it.

インストール

taskbullet.com/dashboard/settings/api-keys でキーを作成してください。キーが表示されるのは一度だけです。以下のボタンでは、プレースホルダー tb_live_your_key_here が設定されます。最初の通話を行う前に、クライアント設定内のプレースホルダーを置き換えてください。実際のキーをチャットに貼り付けないでください。

設定を実行すると、お使いのマシンで npx -y @taskbullet/mcp-server が起動します。npx を実行できないクラウドエージェントでは、Cursor とクラウドエージェントに記載されているホスト URL を使用してください。

Cursor

GitHub では cursor:// リンクを開けません。次の内容をブラウザーにコピーしてください：

cursor://anysphere.cursor-deeplink/mcp/install?name=taskbullet&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0YXNrYnVsbGV0L21jcC1zZXJ2ZXIiXSwiZW52Ijp7IlRBU0tCVUxMRVRfQVBJX0tFWSI6InRiX2xpdmVfeW91cl9rZXlfaGVyZSJ9fQ==

デコード後の設定：

{
  "command": "npx",
  "args": ["-y", "@taskbullet/mcp-server"],
  "env": {
    "TASKBULLET_API_KEY": "tb_live_your_key_here"
  }
}

VS Code

vscode:mcp/install? と vscode-insiders:mcp/install? には、同じ URL エンコード済み JSON が含まれています。name はその JSON 内にあります：

{"name":"taskbullet","command":"npx","args":["-y","@taskbullet/mcp-server"],"env":{"TASKBULLET_API_KEY":"tb_live_your_key_here"}}

Claude Code

claude mcp add taskbullet --env TASKBULLET_API_KEY=tb_live_your_key_here -- npx -y @taskbullet/mcp-server

実行する前に tb_live_your_key_here を置き換えてください。このリポジトリがデフォルトブランチにある状態で、マーケットプレイスから：

/plugin marketplace add GriffMurder/taskbullet-mcp-server

次に taskbullet@taskbullet をインストールしてください。プラグインがキーの入力を求めます。シェルからキーを読み取ることはありません。

JSON

Claude Desktop およびその他の stdio クライアント：

{
  "mcpServers": {
    "taskbullet": {
      "command": "npx",
      "args": ["-y", "@taskbullet/mcp-server"],
      "env": {
        "TASKBULLET_API_KEY": "tb_live_your_key_here"
      }
    }
  }
}

claude_desktop_config.json の保存場所は、MCP quickstart に記載されています。ファイルを保存したら、アプリを再起動してください。

ツール

以下の名前、引数、制限は src/server.ts のコードと一致しています。

ツール	呼び出し	備考
get_balance	GET /api/v1/balance	読み取り専用です。時間と通話用の残高を確認できます。支出を提案する前に呼び出してください。
delegate_task	POST /api/v1/delegate	作業概要を登録します。Idempotency-Key が必要です。顧客が Work で作業を開始すると、実際の時間が消費されます。
list_tasks	GET /api/v1/tasks	読み取り専用です。最大 50 件のタスクを取得します。cancelled で絞り込めます。
get_task	GET /api/v1/tasks/{taskId}	読み取り専用です。completed、failed、cancelled になったら停止してください。awaitingCustomerConfirm は、人間に確認を求める状態です。
confirm_task	POST /api/v1/tasks/{taskId}/confirm	納品物を承認し、記録された時間を精算します。Idempotency-Key が必要です。最初に人間に確認してください。
cancel_task	POST /api/v1/tasks/{taskId}/cancel	保留を解除し、記録された時間分のみ請求します。Idempotency-Key が必要です。最初に人間に確認してください。
reopen_task	POST /api/v1/tasks/{taskId}/reopen	納品物を差し戻します。reason が必要です。Idempotency-Key が必要です。最初に人間に確認してください。
place_call	POST /api/v1/calls	人間による通話を 1 件依頼します。米国とカナダのみ対応しています。record_call は false にするか、省略する必要があります。Idempotency-Key が必要です。
validate_call	POST /api/v1/calls/validate	リクエスト本文を検証します。何も作成せず、保留も発生しません。hold_cents を返します。
get_call	GET /api/v1/calls/{id}	読み取り専用です。needs_info または最終結果を含みます。
update_call	PATCH /api/v1/calls/{id}	通話が needs_info の間に、不足しているフィールドを入力します。
cancel_call	POST /api/v1/calls/{id}/cancel	運用担当者にキャンセルを依頼します。運用担当者が確認するまで cancel_pending のままです。発信開始前にキャンセルが確認された場合、保留分は返金されます。発信開始後はエラーが cancel_too_late となり、通常どおり請求されます。
get_transcript	GET /api/v1/calls/{id}/transcript.txt	VA の通話後の要約であり、録音ではありません。source は wrap_up_summary、recorded は false です。空の場合は transcript_not_ready です。発信されていない場合は no transcript: call not placed です。発信開始後にキャンセルされた場合は call_cancelled です。

delegate_task の引数：title（必須、最大 5000）、description（最大 8000）、priority（low | normal | high | urgent、既定値は normal）、dueDate、sourceAgent、webhookUrl（https）、maxHours（既定値は 0.5、最大 8）、idempotencyKey（必須）。同じ値が Idempotency-Key ヘッダーとして送信され、JSON 本文には含まれません。繰り返し送信すると、元のタスクが返されます。

tb_live_ キーは作業概要を登録します。顧客が Work で VA の作業時間を開始します。awaiting_customer_start は、作業がまだ始まっていないことを示します。アシスタントが作業を開始したとは言わないでください。completed、failed、cancelled になるまで get_task をポーリングするか、webhookUrl を指定してください。get_task が awaitingCustomerConfirm を示したら、人間に確認を求めてから confirm_task、cancel_task、または reopen_task を呼び出してください。人間の確認なしに、承認、キャンセル、差し戻しを行わないでください。顧客によるキャンセルは cancelled となり、完了 Webhook は送信されません。誰も承認しない場合、エージェントが作成したタスクは 3 日後に自動承認されます。

maxHours は支出の上限です。請求対象となるのは記録された時間です（15 分単位で丸められます）。HTTP 402 は、利用可能な残高が 0 を超えていないことを意味します。addHoursUrl（新しいトライアルではなく、パッケージのページ）で時間を購入してください。HTTP 422 は、上限が未処理の上限枠に収まらないことを意味します。時間は残っているため、maxHours を capRoom 以下にするか、待ってください。HTTP 503 は、時間を利用できなかったことを意味します。これは時間購入のエラーではありません。

作業概要や通話に、パスワード、OTP コード、復旧キー、Cookie、API キーを絶対に含めないでください。サーバーはそれらをローカルで削除し、API は受け付けません。 人間への電話には、delegate_task ではなく place_call を使用します。必須フィールドは、phone、business_name、purpose（info、scheduling、account_servicing、vendor_opsのいずれか）、goal（最大4000文字）、questions（{id, ask, type?}形式の項目を1～20個、idは最大80文字、askは最大1000文字）、on_behalf_of、deadline（ISO-8601）、consent_attestation（true）、idempotencyKeyです。max_attemptsのデフォルトは3、最大は5です。max_minutesのデフォルトは5、最大は60です。languageにはen、fil、tl、war、cebを指定します。

発信できるのは米国とカナダの電話番号のみです。record_callはfalseにするか、省略する必要があります。trueはローカルで拒否され、何も送信されません。保留額は通話全体の料金です。最初の1分はティアの最低料金で、その後は1分ごとの料金が加算されます。デフォルトの5分でティア1の通話を行う場合、6.50ドルが保留されます。validate_callにはidempotencyKeyを除いた同じ本文を指定し、信頼すべき金額はそのhold_centsです。ウォレット残高が不足していても、validはtrueのままです。その場合、warningsにはinsufficient_balanceが含まれます。place_callは通話ウォレットからの従量課金です。get_callをポーリングするか、httpsのcallback_urlを渡してください。相手のタイムゾーンで平日09:00～17:00以外に発信する場合、顧客の確認後にallow_outside_business_hours: trueが必要です。その場合、deadlineには60分以上の時間を確保する必要があります。

update_callにはcall_idと、同じ本文フィールドのいずれかを指定します。get_call、cancel_call、get_transcriptにはcall_idを指定します。

TaskBullet Hub

TaskBullet Hubは、人間によるバックアップ付きの、エージェント向け単一MCP接続です。

サーバーは2つあります。

サーバー	URL	認証	実行できる内容
エージェント（このパッケージとホスト型リモート）	https://taskbullet.com/api/agent-mcp	x-api-key: tb_live_…	get_balance、delegate_task、list_tasks、get_task、confirm_task、cancel_task、reopen_task、place_call、validate_call、get_call、update_call、cancel_call、get_transcript
公開サイトガイド	https://taskbullet.com/api/mcp	なし	読み取り専用のマーケティング情報：サービス、料金、雇用者と求職者の振り分け

公開サイトのサーバーが顧客アカウント、メール、職歴、社内文書を参照することはありません。タスクの委任はエージェントサーバーでのみ行えます。

Cursorとクラウドエージェント

Cursor cloud、Grok、ホスト型Claudeなどのクラウドエージェントは、ホスト型エージェントURLを使用してください。npxは実行できません。

{
  "mcpServers": {
    "taskbullet": {
      "url": "https://taskbullet.com/api/agent-mcp",
      "headers": {
        "x-api-key": "tb_live_your_key_here"
      }
    }
  }
}

OpenClaw

ロブスターはアカウントを作成したり、キーを発行したりできません。人間に次の順番で案内してください。

1. アカウントがない場合 → https://taskbullet.com/get-started?source=openclaw（10時間、カード不要）
2. https://taskbullet.com/dashboard/settings/api-keys でtb_live_…を発行する（表示されるのは一度だけ）
3. Gatewayの環境変数TASKBULLET_API_KEYに貼り付け、Agent MCPの接続先をhttps://taskbullet.com/api/agent-mcpに設定し、ヘッダーにx-api-keyを指定する。再起動してください。キーをチャットに貼り付けてはいけません。

openclaw skills install @griffmurder/taskbulletでスキルをインストールします。人間への単発の電話には、通話ウォレットのplace_callを使用します。その他の未完了の作業では、get_balanceで残高を確認し、支出を承認してからdelegate_taskを使用します。キーがない場合は、上記のトライアルURLを案内してください。キーを指定した状態で時間分のHTTP 402が返された場合は、パッケージページを案内します。2回目のトライアルではありません。通話でキーを指定した状態でHTTP 402が返された場合は、トライアルではなくチャージが必要です。

ローカルのGatewayから、このパッケージをTASKBULLET_API_KEYを環境変数に設定したうえで、stdio経由（npx -y @taskbullet/mcp-server）で起動することもできます。

公開サイトガイド（キー不要）

読み取り専用です。エージェントサーバーと併せて安全に追加できます。

{
  "mcpServers": {
    "taskbullet-site": {
      "url": "https://taskbullet.com/api/mcp"
    }
  }
}

understand_siteを呼び出してから、match_intentを呼び出してください。求職者を採用のコンバージョンとして扱わないでください。

ローカルのストリーミング可能な HTTP

デフォルトは Stdio です。--http を指定すると、ループバック上でストリーミング可能な HTTPを提供します。

export TASKBULLET_API_KEY="tb_live_your_key_here"
npx -y @taskbullet/mcp-server --http

エンドポイント：http://127.0.0.1:3000/mcp。キーはこのプロセス内に保持されます。同じマシン上のクライアントからキーを送信する必要はありません。

プロセスは 127.0.0.1 のみでバインドします。ブラウザのページが DNS リバインディングを使ってキーを利用できないよう、Host と Origin をチェックします。ほかのアドレスでリッスンするには、TASKBULLET_HTTP_TOKEN が必要です。このトークンは Authorization: Bearer … として送信してください。TaskBullet API キーではありません。

サーバーから開始する SSE ストリームはありません。GET は 405 を返します。レスポンスは JSON です。クライアントアドレスごとのリクエスト数は毎分 60 件に制限され、上流への呼び出しには Agent API の毎分 60 件という上限が適用されます。32 KiB を超える本文は拒否されます。

プラグイン

Cursor：plugins/taskbullet には、この MCP サーバー、rules/delegate-call-or-task.mdc、および skills/place-call-or-delegate/SKILL.md が含まれています。これらは、エージェントが place_call と delegate_task のどちらを使うべきかを示します。リポジトリのマーケットプレイスは .cursor-plugin/marketplace.json です。Cursor Marketplace への申請は、引き続き cursor.com/marketplace/publish で手動で行います。

Claude Code：.claude-plugin/marketplace.json には同じプラグインが記載されています。ユーザーは /plugin marketplace add GriffMurder/taskbullet-mcp-server で追加します。Claude Code はスキルを読み込みますが、Cursor のルールは読み込みません。Claude は node と ${CLAUDE_PLUGIN_ROOT}/server/index.js を使って、同梱されたサーバーを起動します。プロンプトから API キーとローカル HTTP トークンが渡され、同梱されたサーバーはそれらの値のみを読み取ります。Cursor では引き続き npx を使用します。

環境

変数	必須	デフォルト	用途
TASKBULLET_API_KEY	はい	—	tb_live_… キーです。npm と Cursor は環境から読み取ります。Claude プラグインはプロンプトの値のみを読み取ります。ログに記録されたり、ツールの結果にコピーされたりすることはありません。
TASKBULLET_API_BASE	いいえ	https://taskbullet.com/api/v1	ステージング環境用の上書き
TASKBULLET_SOURCE_AGENT	いいえ	mcp-client	各ブリーフに保存される監査ラベル
TASKBULLET_TRANSPORT	いいえ	stdio	ストリーミング可能な HTTP を提供するには http を設定します
TASKBULLET_HTTP_HOST	いいえ	127.0.0.1	バインドアドレス。ループバック以外ではトークンが必要です
TASKBULLET_HTTP_PORT	いいえ	3000	HTTP ポート
TASKBULLET_HTTP_TOKEN	外部公開する場合	—	npm と Cursor 用のローカル HTTP 認証です。Claude プラグインはプロンプトの値のみを読み取ります。TaskBullet API キーではありません
TASKBULLET_HTTP_ALLOWED_ORIGINS	いいえ	ループバックのオリジン	追加のブラウザ Origin 値をカンマ区切りで指定します

完了

1. ポーリング — status が completed、failed、または cancelled になるまで get_task をポーリングします。awaitingCustomerConfirm が true の場合は、人間に確認してから confirm_task、cancel_task、または reopen_task を呼び出します。
2. Webhook — https の webhookUrl を渡します。顧客がジョブを完了すると、TaskBullet は署名付き本文を POST します。納品物の確認待ちの場合は task.awaiting_confirmation を POST します。顧客がキャンセルしても task.completed は送信されません。Webhook のドキュメントを参照してください。
3. 通話 — 通話が終了するまで get_call をポーリングするか、https の callback_url を渡します。通話の文字起こしがある場合は get_transcript を読み取ります。

delegate_task、confirm_task、cancel_task、reopen_task、および place_call には idempotencyKey が必要です。このパッケージはその値を Idempotency-Key ヘッダーとして送信し、JSON 本文には含めません。同じアカウントとキーを使うと、元の結果が返されます。

TaskBullet の時間料金

• 時間は前払いのバケット単位です。有効期間は 90 日で、未使用分は繰り越されます。
• 委任されたタスクは、アカウント上のバーチャルアシスタントに振り分けられます。
• API 呼び出しは無料です。時間はブリーフの提出時ではなく、作業時間が記録された時点で差し引かれます。
• 電話はその時間を消費しません。通話ウォレットの残高を消費します。

ドキュメント：Agent API · OpenAPI · サイト

レジストリ

このリリースの mcpName は io.github.GriffMurder/taskbullet です。これが現在のレジストリ掲載名です。0.2.1 を公開すると更新されます。優先名の com.taskbullet/mcp を使用するには、DNS TXT レコードまたは taskbullet.com での HTTP による証明が必要です。その証明はまだ公開されていないため、このパッケージでは名前を切り替えません。コマンド、TXT レコード、ディレクトリへの提出については、PUBLISHING.md をご覧ください。

ライセンス

MIT — LICENSE をご覧ください。