USE THIS TOOL WHEN: You encounter errors or want to verify which APIs
are available and properly configured before starting research.

Returns status of each data source including:
- Configuration status (API keys, credentials)
- Connection availability
- Rate limit information where available

USE THIS TOOL WHEN: You need to understand what technology area a CPC
code represents, or find related classification codes.

Args:
    cpc_code: CPC code to look up (e.g., "G06" for computing, "G06N3/08" for neural networks)

Returns:
    Classification details including section, title, and description.
    For section codes (A-H, Y), returns subsection list.

USE THIS TOOL WHEN: You encounter a status code in application data
and need to understand what examination stage it represents.

Args:
    code: Status code number (e.g., "30" for "Docketed New Case")

Returns:
    Status code description and examination stage.

USE THIS TOOL WHEN: You need full-text search of US patents with daily
updates, or need access to the most recent patent filings.

PREFER OVER patentsview_search WHEN: You need the most current data
(PPUBS updates daily vs PatentsView periodic updates).

Args:
    query: Search query using USPTO BRS syntax. Multi-word terms are
           AND-ed across all fields by default — quote phrases that
           must appear together. Examples:
           - '"machine learning"' - exact phrase, all fields
           - machine learning - both terms anywhere (AND)
           - '"neural network".ti.' - title contains phrase
           - smith.in. AND IBM.as. - inventor Smith, assignee IBM
           - G06N3/08.cpc. - CPC classification
           Field qualifiers are dotted suffixes (.ti., .ab., .in.,
           .as., .cpc., .pn.) — the legacy slash-prefix forms
           (TTL/, IN/, AN/, CPC/) no longer work: they silently
           return 0 results, and TTL/"phrase" returns a server 500.
           Default `sort="date_publ desc"` means broad queries return
           the latest grants first — narrow with field qualifiers
           to get relevant matches.
    offset: Starting position for pagination (default: 0)
    limit: Maximum results to return (default: 100, max: 500)
    sort: Sort order (default: "date_publ desc")

Returns:
    Normalized response with patent results including GUID, title,
    abstract, dates, inventors, and classification codes.

USE THIS TOOL WHEN: You need to search pre-grant published applications
(applications publish 18 months after filing, before grant).

Args:
    query: Search query using USPTO BRS syntax (same as
           ppubs_search_patents). Multi-word terms are AND-ed —
           quote phrases that must appear together (e.g.
           '"machine learning"'). Field qualifiers are dotted
           suffixes (.ti., .ab., .in., .as., .cpc.) — the legacy
           slash-prefix forms (TTL/, IN/) no longer work.
    offset: Starting position for pagination (default: 0)
    limit: Maximum results to return (default: 100, max: 500)
    sort: Sort order (default: "date_publ desc")

Returns:
    Normalized response with application results.

USE THIS TOOL WHEN: You have a document GUID from search results
and need the full patent text including all claims and description.

Args:
    guid: Document GUID (e.g., "US-9876543-B2")
    source_type: Document type - "USPAT" for patents, "US-PGPUB" for applications

Returns:
    Complete document with claims, description, drawings info, and metadata.

USE THIS TOOL WHEN: You know the patent number and need the complete
document including claims, description, and all sections.

Args:
    patent_number: Patent number without commas (e.g., "7123456" or "10000000")

Returns:
    Complete patent document with full text of all sections.

USE THIS TOOL WHEN: You need the official PDF document of a patent.
Note: Claude Desktop may not fully support PDF display.

Args:
    patent_number: Patent number without commas (e.g., "7123456")

Returns:
    Dictionary with base64-encoded PDF data.

USE THIS TOOL WHEN: You need prosecution/file wrapper data for an
application including status, dates, and basic metadata.

Args:
    app_num: Application number without slashes or commas (e.g., "14412875")

Returns:
    Application data including filing date, status, and basic info.

USE THIS TOOL WHEN: You need comprehensive application metadata
including examiner info, art unit, and detailed status.

Args:
    app_num: Application number without slashes (e.g., "14412875")

USE THIS TOOL WHEN: You need to understand the patent family tree -
parent applications, continuations, divisionals, and CIPs.

Args:
    app_num: Application number without slashes (e.g., "14412875")

Returns:
    Continuity data showing parent/child relationships and priority claims.

USE THIS TOOL WHEN: You need to know current and historical owners
of a patent or application.

Args:
    app_num: Application number without slashes (e.g., "14412875")

USE THIS TOOL WHEN: You need to calculate the actual expiration date
of a patent accounting for USPTO delays.

Args:
    app_num: Application number without slashes (e.g., "14412875")

Args:
    app_num: Application number without slashes (e.g., "14412875")

USE THIS TOOL WHEN: You need to find priority claims to foreign
applications that may affect the effective filing date.

Args:
    app_num: Application number without slashes (e.g., "14412875")

USE THIS TOOL WHEN: You need the complete timeline of prosecution
events including office actions, responses, and fee payments.

Args:
    app_num: Application number without slashes (e.g., "14412875")

Args:
    app_num: Application number without slashes (e.g., "14412875")

USE THIS TOOL WHEN: You need to search applications with filtering
by applicant metadata, dates, or other criteria not available in PPUBS.

Supports both free-text queries and structured multi-field filtering.
Typed filters are AND-ed together; pass a Lucene-style string in
`query` for OR or more complex expressions.

Args:
    query: Free-text or Lucene-style query (e.g. 'neural network',
           'applicationMetaData.firstInventorName:Smith OR
           applicationMetaData.firstInventorName:Jones')
    application_number: Filter by application number (exact match)
    patent_number: Filter by patent number (exact match)
    inventor_name: Filter by inventor name (matches first inventor)
    assignee_name: Filter by applicant/assignee name (matches first applicant)
    filing_date_from: Filing date range start (YYYY-MM-DD)
    filing_date_to: Filing date range end (YYYY-MM-DD)
    offset: Starting position (default: 0)
    limit: Max results (default: 25)

Returns:
    Normalized response with matching applications.

USE THIS TOOL WHEN: You need to find bulk download datasets
available from USPTO for large-scale analysis.

Args:
    query: Search query for dataset names/descriptions
    offset: Starting position (default: 0)
    limit: Max results (default: 25)

Args:
    product_id: Dataset product identifier

USE THIS TOOL WHEN: You need to find patent validity challenges at
the Patent Trial and Appeal Board. Live via USPTO ODP v3.0.

Trial types:
- IPR: Inter Partes Review (most common, based on patents/publications)
- PGR: Post-Grant Review (broader grounds, within 9 months of grant)
- CBM: Covered Business Method (for financial method patents, sunsetted)
- DER: Derivation proceedings

Args:
    query: Full-text search query
    trial_type: Type of trial (IPR, PGR, CBM, DER)
    patent_number: Patent number being challenged
    party_name: Petitioner or patent owner name
    filing_date_from: Filing date range start (YYYY-MM-DD)
    filing_date_to: Filing date range end (YYYY-MM-DD)
    status: Proceeding status (Pending, Instituted, Terminated, FWD Entered)
    offset: Starting position (default: 0)
    limit: Max results (default: 25)

Returns:
    Normalized response with matching proceedings.

Args:
    proceeding_number: Proceeding number (e.g., "IPR2023-00001")

Returns:
    Proceeding details including parties, patent, status, and dates.

Args:
    proceeding_number: Proceeding number (e.g., "IPR2023-00001")
    document_type: Filter by type (petition, response, declaration, etc.)
    offset: Starting position (default: 0)
    limit: Max results (default: 25)

Args:
    query: Full-text search in decision text
    decision_type: Type (institution, final, termination)
    proceeding_number: Filter by proceeding number
    patent_number: Filter by patent number
    decision_date_from: Date range start (YYYY-MM-DD)
    decision_date_to: Date range end (YYYY-MM-DD)
    offset: Starting position (default: 0)
    limit: Max results (default: 25)

Args:
    decision_id: Decision identifier (trial number, e.g. IPR2022-00001)

Args:
    query: Full-text search query
    application_number: Filter by application number
    patent_number: Filter by patent number
    decision_date_from: Date range start (YYYY-MM-DD)
    decision_date_to: Date range end (YYYY-MM-DD)
    offset: Starting position (default: 0)
    limit: Max results (default: 25)

Args:
    appeal_number: Appeal number

USE THIS TOOL WHEN: You have a trademark serial number or registration
number and need its authoritative live status, mark text, owner,
international classes, filing/registration dates, or prosecution stage.
TSDR is the official USPTO status source (requires API key).

Exactly one of serial_number or registration_number is required.

Args:
    serial_number: 8-digit application serial number (e.g., "78787878")
    registration_number: Registration number (e.g., "3500027")

Returns:
    Normalized response with the trademark status record.

USE THIS TOOL WHEN: You want to see what file-wrapper documents exist
for a trademark application (office actions, responses, specimens,
registration certificates) before downloading anything. Unlike
tsdr_download_trademark_documents, this returns metadata only and is
NOT subject to the 4 req/min PDF rate limit. Use the DocumentTypeCode
values it returns (e.g. "OOA", "SPE") as the document_type filter when
downloading.

Args:
    serial_number: 8-digit application serial number (e.g., "78787878")

Returns:
    Document metadata records (type, description, dates).

USE THIS TOOL WHEN: You need office actions, responses, specimens, or
other file-wrapper documents for a trademark application.

NOTE: TSDR limits PDF downloads to 4 requests per minute per API key,
and unfiltered full wrappers can exceed 10 MB (rejected with
RESPONSE_TOO_LARGE above 4 MB). Call tsdr_list_trademark_documents
first, then filter by document_type and/or date range.

Args:
    serial_number: 8-digit application serial number (e.g., "78787878")
    document_type: Optional document type filter (e.g., "OOA" for
        outgoing office actions, "SPE" for specimens)
    date_from: Optional start date filter (YYYY-MM-DD)
    date_to: Optional end date filter (YYYY-MM-DD)

Returns:
    Dictionary with base64-encoded PDF data.

USE THIS TOOL WHEN: You need the visual representation of a design mark
or stylized word mark.

Args:
    serial_number: 8-digit application serial number (e.g., "78787878")

Returns:
    Dictionary with base64-encoded image data.

USE THIS TOOL WHEN: You need to find trademarks by mark text, owner,
goods/services description, or Nice/international class — e.g.
clearance/knockout searches for a proposed mark, or mapping a company's
trademark portfolio.

NOTE: Backed by the undocumented internal API behind tmsearch.uspto.gov
(the TESS replacement) — same risk profile as PPUBS; may break without
notice. For authoritative status of a specific mark, use
tsdr_get_trademark_status. Federal marks only (no common-law/state marks).

Args:
    query: Raw query string for advanced searches
    mark_text: Word mark text to search (e.g., "ACME")
    owner_name: Owner/applicant name to search
    goods_services: Goods/services description terms (e.g., "athletic
        footwear") — useful for clearance searches across wording
    registration_number: Exact registration number to look up
    international_class: Nice class number 1-45 (e.g., "9" for software;
        use get_trademark_class_info to look up classes)
    status_filter: "live" (active marks), "dead" (abandoned/cancelled/
        expired), or omit for both
    offset: Starting position for pagination (default: 0)
    limit: Maximum results to return (default: 25, max: 100)

Returns:
    Normalized response with matching trademark records.

USE THIS TOOL WHEN: You have a serial number from tm_search_trademarks
results and want the full indexed record. For authoritative live status,
prefer tsdr_get_trademark_status.

Args:
    serial_number: 8-digit application serial number (e.g., "78787878")

Returns:
    Normalized response with the trademark record.

USE THIS TOOL WHEN: You need to trace ownership history of a trademark,
find the current owner, or find marks transferred to/from a company.
Covers recorded assignments from 1955 to present, via the USPTO
Assignment Center public API (no API key required).

At least one filter is required; multiple filters combine (AND).

Args:
    serial_number: Trademark application serial number
    registration_number: Trademark registration number
    assignee_name: Assignee (new owner) name
    assignor_name: Assignor (previous owner) name
    reel_frame: Recordation reel/frame identifier (e.g., "9006/0093")
    offset: Starting position for pagination (default: 0)
    limit: Maximum results to return (default: 25)

Returns:
    Normalized response with assignment records (reel/frame, assignors,
    assignees, conveyance, and affected properties).

USE THIS TOOL WHEN: You need to know what goods (classes 1-34) or
services (classes 35-45) a trademark class covers, or pick the right
classes for a clearance search.

Args:
    class_number: International class number (e.g., "9" for computer
        software, "25" for clothing, "42" for software services)

Returns:
    Class title, type (goods/services), and description.

USE THIS TOOL WHEN: Trademark data contains a numeric status code you
need to interpret (e.g., "700" = Registered, "686" = Published for
opposition).

Args:
    code: Trademark status code (e.g., "700")

Returns:
    Status code description and prosecution stage.

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. Use ppubs_search_patents for full-text patent search.
PatentsView disambiguated data is available as bulk datasets on the
USPTO Open Data Portal (use odp_search_datasets to find them).

Args:
    query: Search terms for patent titles and abstracts
    search_type: Match type ("any", "all", "phrase")
    offset: Starting position (default: 0)
    limit: Max results (default: 100, max: 1000)

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. Use ppubs_get_patent_by_number for patent details.

Args:
    patent_id: Patent ID/number (e.g., "7861317")

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. Use ppubs_search_patents with an assignee name query
(e.g., AN/"company name") as a workaround.

Args:
    name: Assignee/company name (partial match supported)
    limit: Max results (default: 100, max: 1000)

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. No direct replacement exists for disambiguated assignee
lookups. Use odp_search_datasets to find PatentsView bulk datasets.

Args:
    assignee_id: Disambiguated assignee ID from search results

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. Use ppubs_search_patents with an inventor name query
(e.g., IN/"last name") as a workaround.

Args:
    name: Inventor name (last name, or "First Last")
    limit: Max results (default: 100, max: 1000)

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. No direct replacement exists for disambiguated inventor
lookups. Use odp_search_datasets to find PatentsView bulk datasets.

Args:
    inventor_id: Disambiguated inventor ID from search results

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. Use ppubs_get_full_document to retrieve patent text
including claims.

Args:
    patent_id: Patent ID/number (e.g., "7861317")

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. Use ppubs_get_full_document to retrieve the full patent
specification.

Args:
    patent_id: Patent ID/number (e.g., "7861317")

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. Use ppubs_search_patents with a CPC query
(e.g., CPC/"G06N3/08") as a workaround.

Args:
    cpc_code: CPC code (e.g., "G06N3/08" for neural networks)
    limit: Max results (default: 100, max: 1000)

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. Use get_cpc_info for CPC code descriptions.

Args:
    cpc_code: CPC code (class "G06" or group "G06N3/08")

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. Use odp_get_attorney with a specific application number
to look up attorney information per application.

Args:
    name: Attorney or firm name (partial match supported)
    limit: Maximum results to return (default: 100, max: 1000)

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. Use odp_get_attorney with a specific application number
to look up attorney information per application.

Args:
    attorney_id: Attorney ID from search results

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. No direct replacement exists for IPC lookups. Use
odp_search_datasets to find PatentsView bulk datasets containing IPC data.

Args:
    ipc_code: IPC code (e.g., "G06F" for data processing)

IMPORTANT: The PatentsView API (search.patentsview.org) was shut down on
March 20, 2026. Use ppubs_search_patents with an IPC query as a workaround.

Args:
    ipc_code: IPC code (e.g., "G06F" for data processing)
    limit: Maximum results to return (default: 100, max: 1000)

USE THIS TOOL WHEN: You need to read examiner rejections, requirements,
and objections from prosecution.

IMPORTANT: The legacy Office Action text APIs (developer.uspto.gov) were
decommissioned in early 2026 and have NOT yet been migrated to the ODP.
This tool is temporarily unavailable. Use odp_get_documents to list file
wrapper documents (including office actions) and download them instead.

Args:
    application_number: Application number (e.g., "16123456")
    mail_date: Optional filter by mail date (YYYY-MM-DD)

Returns:
    Office action text including rejections and examiner comments.

IMPORTANT: Temporarily unavailable — legacy endpoints decommissioned,
ODP migration pending. Use odp_get_documents or odp_get_transactions instead.

Args:
    query: Full-text search query
    application_number: Filter by application number
    examiner_name: Filter by examiner name
    art_unit: Filter by art unit number
    mail_date_from: Date range start (YYYY-MM-DD)
    mail_date_to: Date range end (YYYY-MM-DD)
    offset: Starting position (default: 0)
    limit: Max results (default: 25)

USE THIS TOOL WHEN: You need to see what references the examiner
cited against an application.

IMPORTANT: Temporarily unavailable — legacy endpoints decommissioned,
ODP migration pending. Use get_enriched_citations as an alternative.

Args:
    application_number: Application number
    mail_date: Optional filter by mail date (YYYY-MM-DD)

Returns:
    Citations from Form PTO-892, PTO-1449, and office action text.

USE THIS TOOL WHEN: You need structured data about claim rejections
including rejection type (102, 103, 112) and affected claims.

IMPORTANT: Temporarily unavailable — legacy endpoints decommissioned,
ODP migration pending. Use odp_get_documents to find office actions.

Args:
    application_number: Application number
    mail_date: Optional filter by mail date (YYYY-MM-DD)

Returns:
    Rejection data with claim-level details.

USE THIS TOOL WHEN: You need citation analysis including forward
citations (who cites this patent) and backward (what this patent cites).

IMPORTANT: The legacy Enriched Citation API (developer.uspto.gov) was
decommissioned in early 2026 and has NOT yet been migrated to the ODP.
This tool is temporarily unavailable. Use patentsview_get_patent for
basic citation data instead.

Args:
    patent_number: Patent number
    include_forward: Include forward citations (default: True)
    include_backward: Include backward citations (default: True)

Returns:
    Enriched citation data with metrics.

IMPORTANT: Temporarily unavailable — legacy endpoints decommissioned,
ODP migration pending. Use patentsview_search_patents instead.

Args:
    citing_patent: Patent that is citing
    cited_patent: Patent being cited
    assignee: Filter by assignee name
    date_from: Date range start (YYYY-MM-DD)
    date_to: Date range end (YYYY-MM-DD)
    offset: Starting position (default: 0)
    limit: Max results (default: 25)

USE THIS TOOL WHEN: You need quantitative citation analysis including
forward/backward counts and citation age metrics.

IMPORTANT: Temporarily unavailable — legacy endpoints decommissioned,
ODP migration pending.

Args:
    patent_number: Patent number

IMPORTANT: The USPTO Patent Litigation API is not available on the Open
Data Portal (api.uspto.gov) and is not listed in the ODP Swagger
catalog. The OCE Patent Litigation dataset is distributed as bulk
downloadable files rather than a live API.

Args:
    query: Full-text search query
    patent_number: Filter by patent number
    plaintiff: Filter by plaintiff name
    defendant: Filter by defendant name
    court: Filter by court/district
    filing_date_from: Date range start (YYYY-MM-DD)
    filing_date_to: Date range end (YYYY-MM-DD)
    offset: Starting position (default: 0)
    limit: Max results (default: 25)

IMPORTANT: The USPTO Patent Litigation API is not available on the Open
Data Portal. See search_litigation for details and workarounds.

Args:
    case_id: Case identifier

IMPORTANT: The USPTO Patent Litigation API is not available on the Open
Data Portal. See search_litigation for details and workarounds.

Args:
    patent_number: Patent number

IMPORTANT: The USPTO Patent Litigation API is not available on the Open
Data Portal. See search_litigation for details and workarounds.

Args:
    party_name: Company or individual name
    role: Filter by role - "plaintiff", "defendant", or None for both
    limit: Max results (default: 25)