ツールリファレンス
MCP で公開される Quest Card のツール一覧（tool-specs.ts から自動生成）
このページは 自動生成 です。内容の起点は src/app/api/mcp/tool-specs.ts の TOOL_SPECS。
ツールの追加・説明変更・スキーマ変更はそちらを編集し、pnpm exec tsx scripts/gen-tool-reference.ts で再生成してください。
MCP エンドポイント: https://questcard-ai.com/api/mcp（Streamable HTTP・ステートレス、protocolVersion 2025-06-18）。
read トークンには read ツールのみ、act トークンには全ツールが tools/list で見えます。
閲覧ツール（read）
questcard_get_context
自分の状況を取得 — スコープ: read（閲覧のみ）
あなた（このトークンの持ち主）の表示名、ボードのサマリ（各行の件数: unanswered/inProgress/tracking/standing/archive）、および接続済みメンバー（カードを送り合える相手）の一覧を返します。まず最初にこれを呼び、いま自分の手元に何があるかを把握してください。
入力スキーマ
入力パラメータはありません（引数なしで呼び出します）。
questcard_list_cards
行を指定してカード一覧 — スコープ: read（閲覧のみ）
指定した行のカード一覧を返します。各カードは id / 型 / タイトル / 差出人→宛先 / 期限 / 状態 を含みます。row の意味: unanswered=自分の番（返信・対応待ち）、inProgress=自分が約束して進行中、tracking=相手の番（返した後の相手待ち）、standing=常置の役割、archive=完了・クローズ済み。
入力スキーマ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
row | string（enum） | 必須 | 取得する行。unanswered / inProgress / tracking / standing / archive。（unanswered / inProgress / tracking / standing / archive） |
questcard_get_card
カード詳細を取得 — スコープ: read（閲覧のみ）
カード ID を指定して詳細を返します。型のお作法項目（拡張フィールドを日本語ラベル付きで）、原文層の文字起こし（スレッド。手渡しのたびに積まれた各人の肉声）、スタンプを含みます。閲覧できるのはあなたが当事者（差出人または宛先）のカードのみです。
入力スキーマ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | カードの id（list_cards が返す id）。 |
操作ツール（act）
questcard_respond
カードに応答する — スコープ: act（操作まで・act トークン必須）
自分が当事者のカードに応答します。kind で操作を選びます: reply=一言返信（text 必須）、stamp=スタンプ（emoji 必須）、promise=引き受けて約束（text 必須・due/note 任意）、decline=辞退し差出人へ差し戻す（注目待ちの本人のみ）、pass=別の人へパス（toId 必須・接続済みのみ）、complete=完了を宣言（text 任意）、accept=完了を受領してクローズ。decline / pass は「いま自分の番」のカードにのみ行えます。
入力スキーマ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
id | string | 必須 | 対象カードの id。 |
kind | string（enum） | 必須 | reply / stamp / promise / decline / pass / complete / accept。（reply / stamp / promise / decline / pass / complete / accept） |
text | string | 任意 | 本文・一言（reply/promise は必須、complete/decline/pass は任意）。 |
emoji | string | 任意 | スタンプ記号（kind=stamp のとき必須）。 |
due | string | 任意 | 約束の期限（kind=promise のとき任意）。 |
note | string | 任意 | 約束のメモ（kind=promise のとき任意。既定はタイトル）。 |
toId | string | 任意 | パス先メンバーの uid（kind=pass のとき必須・接続済みのみ）。 |
questcard_send
カードを送る — スコープ: act（操作まで・act トークン必須）
新しいカードを作成して送ります。type で型を選びます（irai=依頼 / meeting=ミーティング / review=レビュー / sodan=相談 / hokoku=報告 / kyoyu=共有 / commit=コミット / kansha=感謝・称賛 / kessai=決裁・承認 / yakuwari=役割）。宛先 toIds は接続済みメンバーの uid のみ指定でき、複数指定すると各人へ1枚ずつファンアウトします。commit / yakuwari は自分宛て型のため toIds は不要です。title と text（あなたの肉声/発話の原文）は必須です。
入力スキーマ
| パラメータ | 型 | 必須 | 説明 |
|---|---|---|---|
type | string（enum） | 必須 | カードの型 id（irai=依頼 / meeting=ミーティング / review=レビュー / sodan=相談 / hokoku=報告 / kyoyu=共有 / commit=コミット / kansha=感謝・称賛 / kessai=決裁・承認 / yakuwari=役割）。（irai / meeting / review / sodan / hokoku / kyoyu / commit / kansha / kessai / yakuwari） |
toIds | array<string> | 任意 | 宛先メンバーの uid（接続済みのみ・複数可）。commit/yakuwari では不要。 |
title | string | 必須 | カードのタイトル（15字程度の体言止めが望ましい）。 |
text | string | 必須 | 原文層に積むあなたの発話（肉声の文字起こし相当）。 |
why | string | 任意 | なぜ（任意）。 |
when | string | 任意 | いつ・期限の自由記述（任意）。 |
dueAt | string | 任意 | ISO8601 の厳密な期限（解釈できる場合のみ任意）。 |
fields | object<string, string> | 任意 | 型別のお作法項目（キーは型の拡張フィールド。読み取れたものだけ）。 |