`ptab_search_appeals`

Pack: uspto-ptab · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/ptab_search_appeals for the schema, then POST the same URL with its arguments for the data.

Search USPTO ex parte Appeals decisions — an applicant’s appeal of a patent examiner’s rejection to the Patent Trial and Appeal Board. This is a SEPARATE docket from AIA trials (IPR/PGR/CBM/derivation): an appeal number looks like “2024-001234”, not “IPR2024-00001”. Returns an outcome-count summary first (affirmed / reversed / affirmed-in-part / other), then the matching decision records. Filter by appeal_number, application_number (the rejected application under appeal), free-text query, and/or a decided_after/decided_before date range. Powered by the USPTO Open Data Portal (data.uspto.gov).

Parameters

Name	Type	Required	Description
`appeal_number`	string	no	Optional. Ex parte appeal number, e.g. “2024-001234” (with or without an “Appeal” prefix). This is NOT an AIA trial number.
`application_number`	string	no	Optional. The patent application number under appeal, e.g. “16123456”.
`query`	string	no	Optional free-text keyword search across appeal decision records (e.g. a technology term or applicant name).
`decided_after`	string	no	Optional. Only decisions on/after this date (ISO YYYY-MM-DD).
`decided_before`	string	no	Optional. Only decisions on/before this date (ISO YYYY-MM-DD).
`limit`	number	no	Number of decision records to return (1-100, default 25). Outcome counts are computed over this same page.
`offset`	number	no	Pagination offset (default 0).
`include_raw`	boolean	no	Optional, default false. When true, also return raw_sample: one UNMODIFIED raw record exactly as the upstream API returned it (no field renaming), to verify or correct this tool’s field mapping.
`_apiKey`	string	no	USPTO ODP API key (same key as the patents/uspto-ptab packs). Get free at https://data.uspto.gov/apis/getting-started.

Example call

Arguments

{
  "appeal_number": "2024-001234"
}

curl

curl -X POST https://gateway.pipeworx.io/uspto-ptab/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ptab_search_appeals","arguments":{"appeal_number":"2024-001234"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('ptab_search_appeals', {
  "appeal_number": "2024-001234"
});

More examples

{
  "application_number": "16123456",
  "query": "obviousness",
  "limit": 25
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the uspto-ptab pack

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

See Getting Started for client-specific install steps.

ptab_search_appeals