get_trademark_documents

Pack: trademarks · Endpoint: https://gateway.pipeworx.io/trademarks/mcp

Get the prosecution history (office actions, responses, etc.) for a trademark by serial number. Requires USPTO API key.

Parameters

NameTypeRequiredDescription
serial_numberstringyesUSPTO serial number
api_keystringnoUSPTO API key

Example call

Arguments

{
  "serial_number": "97123456",
  "api_key": "your-trademarks-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/trademarks/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_trademark_documents","arguments":{"serial_number":"97123456","api_key":"your-trademarks-api-key"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('get_trademark_documents', {
  "serial_number": "97123456",
  "api_key": "your-trademarks-api-key"
});

More examples

{
  "serial_number": "90876543"
}

Response shape

FieldTypeDescription
serial_numberstring | nullUSPTO serial number
registration_numberstring | nullTrademark registration number
mark_textstring | nullText or verbal element of the mark
statusstring | nullCurrent status of the trademark
status_datestring | nullDate of the current status
filing_datestring | nullApplication filing date
registration_datestring | nullTrademark registration date
owner_namestring | nullOwner/applicant name
attorneystring | nullAttorney name if applicable
goods_servicesstring | nullGoods and services description
international_classstring | nullInternational classification number
raw_availablebooleanWhether raw XML data was available
Full JSON Schema
{
  "type": "object",
  "properties": {
    "serial_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "USPTO serial number"
    },
    "registration_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "Trademark registration number"
    },
    "mark_text": {
      "type": [
        "string",
        "null"
      ],
      "description": "Text or verbal element of the mark"
    },
    "status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Current status of the trademark"
    },
    "status_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Date of the current status"
    },
    "filing_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Application filing date"
    },
    "registration_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Trademark registration date"
    },
    "owner_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Owner/applicant name"
    },
    "attorney": {
      "type": [
        "string",
        "null"
      ],
      "description": "Attorney name if applicable"
    },
    "goods_services": {
      "type": [
        "string",
        "null"
      ],
      "description": "Goods and services description"
    },
    "international_class": {
      "type": [
        "string",
        "null"
      ],
      "description": "International classification number"
    },
    "raw_available": {
      "type": "boolean",
      "description": "Whether raw XML data was available"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

Regenerated from source · build May 9, 2026