[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [USPTO trademark search](https://spiral.ai/integrations/codex/uspto-trademark-search)

# How to Use USPTO trademark search in Codex

Finds federal trademark applications and registrations by wording, returning owners, status, goods and services, classes, and identifying numbers. Use it to discover relevant marks before checking a specific application.

|  |  |
| --- | --- |
| Model | USPTO trademark search |
| Available through | Alexandria |
| Category | Lead Gen |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with USPTO trademark search in Codex

- Use USPTO trademark search to find federal marks containing NIKE. Save the first ten results with owner names, serial numbers, status, classes, and goods and services in research/nike-marks.json.
- Use USPTO trademark search to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from USPTO trademark search and tell me what changed since last week.
- Check USPTO trademark search and summarize what you find in three bullet points.
- Pull the newest data from USPTO trademark search and give me the result as a table.

## How to set up USPTO trademark search in Codex

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run USPTO trademark search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "uspto-gov/intellectual-property/trademark_search",
    "input": {
      "text": "<text>"
    }
  }'
```

Then paste one of the prompts above: Codex finds USPTO trademark search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## USPTO trademark search tools and prices

- [USPTO patents, trademarks and assignments · Trademark search](https://spiral.ai/tools/alexandria/uspto-gov/intellectual-property/trademark_search) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| from | 0 to 9900 | 0 | Zero-based offset; pass the previous page's `next_from`. |
| size | 1 to 100 | 25 | size |
| alive |  | — | Older live/dead filter: true is `status: live`, false is `status: dead`. Prefer `status`; when both are given they must agree. |
| match | basic, phrase | — | `basic`: the site's basic word-mark search (phrase or any word in the mark, phrase in the pseudo mark). `phrase`: only marks whose word mark or pseudo mark contains the text as a phrase, e.g. `galaxy sports` finds GALAXY SPORTS but not SPORTS GALAXY. Default: `phrase` for a quoted text, else `basic`. |
| owner |  | — | Owner (applicant or registrant) name phrase, matched with up to two words between terms as the site's owner search does, e.g. `samsung electronics`. |
| status | live, registered, pending, dead, cancelled, abandoned | — | Status filter as the site defines it: `live` (registered or pending), `registered` (live with a registration number), `pending` (live application without one), `dead` (cancelled or abandoned), `cancelled` (dead with a cancellation date), `abandoned` (dead with an abandonment date). Omitted: all. |

## What can you do with USPTO trademark search in Codex?

Build a company IP research file from USPTO patent, trademark, or recorded assignment records. A coding agent can organize publication numbers, classifications, trademark status, and transaction references in your project.

### Acquisition research

Prepare a company's US IP inventory with patent titles and abstracts, trademark goods and services, application status, and recorded transfers for identified assets.

### Competitor portfolio briefing

Compare named companies using published inventions, patent classifications, federal trademark records, prosecution events, and recorded assignment transactions.

### Licensing candidate research

Build a research brief around a company's published technology and registered brands, including patent references, trademark goods and services, and recorded transaction parties.

### Company portfolio review

Review a named company's patent publications, detailed invention records, trademark applications, prosecution history, and recorded assignments in one research report.

### Federal brand screening

Find matching federal marks and compare their owners, status, international classes, and goods and services before deciding which records need closer review.

### Trademark transaction review

Find a company's marks, inspect their application or registration records, and assemble recorded assignment transactions with dates and reel/frame references.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## USPTO trademark search in other agents

- [Amp](https://spiral.ai/integrations/amp/uspto-trademark-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/uspto-trademark-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/uspto-trademark-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/uspto-trademark-search)
- [Cline](https://spiral.ai/integrations/cline/uspto-trademark-search)
- [Cursor](https://spiral.ai/integrations/cursor/uspto-trademark-search)
- [Devin](https://spiral.ai/integrations/devin/uspto-trademark-search)
- [dots](https://spiral.ai/integrations/dots/uspto-trademark-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/uspto-trademark-search)
- [Gemini](https://spiral.ai/integrations/gemini/uspto-trademark-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/uspto-trademark-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/uspto-trademark-search)
- [goose](https://spiral.ai/integrations/goose/uspto-trademark-search)
- [Grok](https://spiral.ai/integrations/grok/uspto-trademark-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/uspto-trademark-search)
- [Hermes](https://spiral.ai/integrations/hermes/uspto-trademark-search)
- [Instinct](https://spiral.ai/integrations/instinct/uspto-trademark-search)
- [Manus](https://spiral.ai/integrations/manus/uspto-trademark-search)
- [Muse](https://spiral.ai/integrations/muse/uspto-trademark-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/uspto-trademark-search)
- [n8n](https://spiral.ai/integrations/n8n/uspto-trademark-search)
- [Notion](https://spiral.ai/integrations/notion/uspto-trademark-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/uspto-trademark-search)
- [opencode](https://spiral.ai/integrations/opencode/uspto-trademark-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/uspto-trademark-search)
- [Raycast](https://spiral.ai/integrations/raycast/uspto-trademark-search)
- [VS Code](https://spiral.ai/integrations/vscode/uspto-trademark-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/uspto-trademark-search)
- [Zapier](https://spiral.ai/integrations/zapier/uspto-trademark-search)

## More Codex guides

- [USPTO patent search](https://spiral.ai/integrations/codex/uspto-patent-search)
- [USPTO trademark status](https://spiral.ai/integrations/codex/uspto-trademark-status)
- [USPTO patent document](https://spiral.ai/integrations/codex/uspto-patent-document)
- [Ukraine EDR register XML schema](https://spiral.ai/integrations/codex/ukraine-edr-register-xml-schema)
- [USPTO patent and trademark assignments](https://spiral.ai/integrations/codex/uspto-patent-and-trademark-assignments)
- [Ukraine EDR register publication status](https://spiral.ai/integrations/codex/ukraine-edr-register-publication-status)

## Questions about USPTO trademark search in Codex

**Can Codex use USPTO trademark search?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run USPTO trademark search like any built-in tool.

**How much does USPTO trademark search cost in Codex?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.

**Do I need an Alexandria account to use USPTO trademark search in Codex?**

No. Spiral runs USPTO trademark search on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up USPTO trademark search in Codex?**

About two minutes: add the hosted server, then sign in.

**Does Codex wait while USPTO trademark search runs?**

USPTO trademark search runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.

**Does USPTO data cover intellectual property worldwide?**

These tools cover US patent, federal trademark, and recorded assignment records. They do not provide a worldwide patent or trademark register.

**Does a search include every trademark a company uses?**

No. The USPTO database includes federal trademark applications and registrations, but excludes marks protected only through unregistered common-law use.

**Are abandoned and inactive trademark records included?**

Yes. The USPTO trademark database contains active and inactive applications and registrations, so a result does not by itself mean a mark remains active.

**How far back do the patent records go?**

Patent Public Search has limited information back to 1790 and full text for most granted patents from 1971 onward. Its pre-grant publication collection starts in March 2001.

**What is the difference between a trademark record and an assignment record?**

TSDR provides a trademark application's or registration's status and prosecution history. Assignment Center provides recorded transactions, including the parties, conveyance description, dates, and reel/frame reference.

