Ttab

@pipeworx/ttab

USPTO 商标审判与上诉委员会（TTAB）的商标争议——异议、撤销申请、提出异议的延期申请及单方上诉，包含双方当事人、涉案商标和完整案卷。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 1684+ 个实时数据源的 MCP 网关。

工具

• ttab_search(party?, other_party?, mark?, correspondent?, serial_or_registration_number?, query?, status?, match_mode?, page?, limit?) — 按当事人名称、商标文本、联系人律所或申请号／注册号查找案件。每条结果都包含委员会案件编号、案件类型、申请日期，以及双方当事人及其商标和申请号／注册号。可回答“是否有人对这个商标提出异议”。
• ttab_proceeding(proceeding_number, type?) — 单个案件的完整信息：状态和状态日期、负责案件程序的律师及律师助理、各方的通信地址和主张的商标，以及完整的申请历史（每条案卷记录、日期和任何截止日期）。
• 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 开始，每页 25 行）。*op 运算符接受 ''（包含所有词）、beg（以……开头）或 mat（完全匹配）。
• v?pno=<number>[&pty=<type>] 是案件详情页。

使用前须知

• 未知案件编号会返回 HTTP 200 和空白记录页， 而不是 404。该工具包会检测空白的 Number: 字段并返回 {found:false, reason:'proceeding_not_found}；请勿相信状态码。
• 结果总数会饱和到字面字符串 "100+"——result_count 是 字符串，而非数字，工具包会在 result_count_note 中说明这一点。
• EXT（提出异议的延期申请）和 EXA（单方上诉）使用申请序列号作为键， 而非 8 位委员会案件编号，因此同一个编号可能对应两条不同记录。pty 可用于区分；省略它时，TTABVUE 会自行选择，而指定错误的 pty 会返回上述空白页。
• 当事人名称会按提交时的原样保存，因此同一家公司可能以多种拼写出现。返回的名称未经处理，ttab_party_history 会报告其发现的各种拼写，而不会将它们合并。
• 案件双方都可能涉及商标——被告遭质疑的申请，以及原告主张的注册商标。它们分别保存在各自的当事人对象中，不会合并到同一个商标列表。
• 每行搜索结果包含三个顶层 <td class="p1"> 单元格 （案件编号／被告／原告）；嵌套布局表格使用不带类名的 <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 服务。目前无法在不包含这些元工具的情况下挂载工具包端点；如果额外的 schema 消耗的上下文超过了路由带来的价值，请改为连接一次完整网关，而不是连接多个工具包端点。

你也可以连接完整的 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":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 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