How to Use USPTO trademark search in Gemini CLI
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.
Prompts to try with USPTO trademark search in Gemini CLI
Copy an example into Gemini CLI, or ask in your own words.
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 Gemini CLI
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Or add it to ~/.gemini/settings.json yourself:
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start gemini and run:
/mcp auth spiral
- Check it
In Gemini CLI, run /mcp. From your shell:
gemini mcp list
Use the Spiral skill
- Send Gemini CLI this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run USPTO trademark search
One request; the result comes back by polling or a webhook.
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: Gemini CLI finds USPTO trademark search on Spiral, shows the price and runs it.
USPTO trademark search providers and prices
Spiral runs USPTO trademark search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Gemini CLI for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| From | 0 to 9900 | 0 | Zero-based offset; pass the previous page's |
| Size | 1 to 100 | 25 | size |
| Alive | on or off | Older live/dead filter: true is | |
| Match | basic or phrase |
| |
| Status | live, registered, pending, dead, cancelled, or abandoned | Status filter as the site defines it: |
Every API field of USPTO patents, trademarks and assignments · Trademark search is on its tool page: open its card above.
What can you do with USPTO trademark search in Gemini CLI?
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.
More on USPTO trademark search and Gemini CLI
Overview
USPTO trademark search in other agents
Questions about USPTO trademark search in Gemini CLI
Can Gemini CLI use USPTO trademark search?
Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run USPTO trademark search like any built-in tool.
How much does USPTO trademark search cost in Gemini CLI?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.
Do I need an Alexandria account to use USPTO trademark search in Gemini CLI?
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 Gemini CLI?
About two minutes: add the server, then sign in, then check it.
Does Gemini CLI wait while USPTO trademark search runs?
USPTO trademark search runs in the background. Gemini CLI 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.
Start using USPTO trademark search in Gemini CLI
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Gemini CLI:
set up https://spiral.ai/SKILL.md


