Ttab

@pipeworx/ttab

USPTO 商標審判・不服審査委員会（TTAB）での商標紛争――異議申立て、取消請求、異議申立て期間の延長申請、査定系審判を扱います。双方の当事者、対象となる商標、完全な事件記録を確認できます。

Pipeworx の一部です。AI エージェントを 1684 以上の稼働中データソースに接続する MCP ゲートウェイです。

ツール

• ttab_search(party?, other_party?, mark?, correspondent?, serial_or_registration_number?, query?, status?, match_mode?, page?, limit?) — 当事者名、商標のテキスト、代理人事務所、または出願番号・登録番号から審判手続を検索します。各結果には、審判手続番号、手続の種類、出願日、双方の当事者とそれぞれの商標および出願番号・登録番号が含まれます。「この商標に異議を申し立てている人はいますか」という質問に答えます。
• ttab_proceeding(proceeding_number, type?) — 1件の審判手続の全情報を取得します。ステータスとステータスの日付、審理担当弁護士とパラリーガル、各当事者の連絡先住所と主張対象の商標、さらに手続の全履歴（各記録項目、その日付、期限がある場合はその期限）を確認できます。
• ttab_party_history(party, status?, match_mode?, max_pages?, limit?) — TTAB での企業の記録をまとめます。原告（異議申立人）と被告（異議を申し立てられた側）としての登場回数、手続の種類ごとの内訳、届出に使われたすべての名称表記を確認できます。

認証

キーは不要です。

データソース

• https://ttabvue.uspto.gov/ttabvue/ — 委員会の照会システムである TTABVUE（v2.8.0）。サーバー側で HTML を生成します。JSON API はなく、ボット対策による遮断もありません。
• v?qt=adv&... は詳細検索エンドポイントです。パラメーター：procstatus （Pending／Terminated／All）、pno（審判手続番号）、propno （出願番号・登録番号）、qs（任意の箇所にあるすべての単語）、propname と propnameop（商標）、pn と pop（当事者）、pn2 と pop2（相手方）、 cn と cop（代理人）、page（1 始まり、1 ページあたり 25 件）。*op 演算子には、''（すべての単語を含む）、beg（〜で始まる）、mat （完全一致）を指定します。
• v?pno=<number>[&pty=<type>] は審判手続の詳細ページです。

事前に知っておくべきこと

• 不明な審判手続番号を指定しても、404 ではなく、空の記録ページと HTTP 200 が返されます。 パックは空欄の Number: フィールドを検出し、{found:false, reason:'proceeding_not_found'} を返します。ステータスコードを信用しないでください。
• 結果の合計数は文字列 "100+" で上限に達します。 result_count は数値ではなく文字列で、その旨はパックの result_count_note に記載されています。
• EXT（異議申立て期間の延長申請）と EXA（査定系審判）は、8 桁の審判手続番号ではなく、出願番号をキーとして使います。そのため、1 つの番号が異なる 2 件の記録を指す場合があります。 pty で区別できます。省略すると TTABVUE が選択し、誤った pty を指定すると上記の空のページが返されます。
• 当事者名は届出時の表記のまま保存されています。 そのため、同じ企業が複数の表記で登録されている場合があります。名前は加工せずに返され、ttab_party_history は表記を統合せず、確認された表記を報告します。
• 審判手続では、双方に商標があります。被告が攻撃を受けている出願と、原告が根拠として主張する登録商標です。これらは別々の当事者オブジェクトに保持され、1 つの商標リストにまとめられることはありません。
• 検索結果では、各行にトップレベルの <td class="p1"> セルが 3 つあります（審判手続／被告／原告）。入れ子のレイアウトテーブルでは <td> のみが使われるため、セルを安全に分割できます。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "ttab": {
      "url": "https://gateway.pipeworx.io/ttab/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/ttab/mcp の tools/list は、上記の表にあるツールに加えて、共有 Pipeworx メタツールである ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツールも返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、そのパック固有のツールとともに、共有ツールがおよそ30個表示されます。接続時の initialize 応答に正確な対象範囲が示されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックで扱っていない質問にも、カタログ全体を横断してルーティングする ask_pipeworx 経由で回答できます。MCP サーバーをもう1つ追加する必要はありません。現時点では、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマにかかるコンテキストコストがルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1684以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合は、HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/ttab_search \
  -H 'Content-Type: application/json' \
  -d '{"party":"Nike, Inc.","limit":5}'

最初の呼び出しにアカウントは必要ありません。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/ttab_search を使用します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使用します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も必要ありません。

{
  "mcpServers": {
    "ttab": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-ttab"]
    }
  }
}

または、起動を確認するために直接実行します。

npx -y @pipeworx/mcp-ttab

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは、上記のパックエンドポイントでもフルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Ttab data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細情報

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT