@pipeworx/ttab

Trademark disputes before the USPTO Trademark Trial and Appeal Board — oppositions, cancellation petitions, extensions of time to oppose, and ex parte appeals, with both parties, the marks at issue, and the full docket.

Part of Pipeworx — an MCP gateway connecting AI agents to 1866+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

• ttab_search(party?, other_party?, mark?, correspondent?, serial_or_registration_number?, query?, status?, match_mode?, page?, limit?) — finds proceedings by party name, mark text, correspondent firm, or application/registration number. Each result carries the board proceeding number, proceeding type, filing date, and both sides with their marks and serial/registration numbers. Answers "is anyone opposing this trademark".
• ttab_proceeding(proceeding_number, type?) — one proceeding in full: status and status date, interlocutory attorney and paralegal, each party's correspondence address and pleaded marks, and the complete prosecution history (every docket entry, its date, and any due date).
• ttab_party_history(party, status?, match_mode?, max_pages?, limit?) — profiles a company across TTAB: how often it appears as plaintiff (opposing) versus defendant (opposed), a breakdown by proceeding type, and every name spelling it has been filed under.

Auth

Keyless.

Data sources

• https://ttabvue.uspto.gov/ttabvue/ — TTABVUE, the Board's inquiry system (v2.8.0). Server-rendered HTML; there is no JSON API and no bot wall.
• v?qt=adv&... is the advanced-search endpoint. Parameters: procstatus (Pending/Terminated/All), pno (proceeding number), propno (application/registration number), qs (all words anywhere), propname + propnameop (mark), pn + pop (party), pn2 + pop2 (other party), cn + cop (correspondent), page (1-based, 25 rows per page). The *op operators take '' (contains all words), beg (starts with), or mat (is exactly).
• v?pno=<number>[&pty=<type>] is the proceeding detail page.

Things worth knowing before you touch this

• An unknown proceeding number returns HTTP 200 with an empty record page, not a 404. The pack detects the blank Number: field and returns {found:false, reason:'proceeding_not_found'}; do not trust the status code.
• Result totals saturate at the literal string "100+" — result_count is a string, not a number, and the pack says so in result_count_note.
• EXT (extension of time to oppose) and EXA (ex parte appeal) are keyed by application serial number, not by an 8-digit board number, so one number can name two different records. pty disambiguates; omitting it lets TTABVUE choose, and asking for the wrong pty yields the empty page above.
• Party names are stored exactly as filed, so one company appears under several spellings. Names are returned raw, and ttab_party_history reports the spellings it saw rather than merging them.
• A proceeding has marks on both sides — the defendant's applications under attack and the plaintiff's pleaded registrations. They are kept in separate party objects, never merged into one mark list.
• Search results are three top-level <td class="p1"> cells per row (proceeding / defendant / plaintiff); nested layout tables use bare <td>, which is what makes the cell split safe.

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

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

What this endpoint actually serves

tools/list at https://gateway.pipeworx.io/ttab/mcp returns the tools in the table above plus the shared Pipeworx meta-tools — ask_pipeworx, discover_tools, search_within, remember/recall and the rest of the gateway-wide set. So the tool co

... View full README on GitHub