How to Use the USPTO API MCP in OpenAI Agents SDK

Q: How do I use USPTO API with the OpenAI Agents SDK to search patents?

You simply point your agent at the MCP Server and call searchpatents. The tool takes a keyword, queries the US patent database, and returns a list of matching records. Your agent then uses that list to decide which ones need deeper review.

Q: What if I need to get full details for a specific trademark using USPTO API with the OpenAI Agents SDK?

Just call gettrademarkdetails and pass in the serial number. The agent handles the request, pulls all the metadata, and structures it so you can use it immediately in your application's logic.

Q: Does USPTO API with the OpenAI Agents SDK support listing patent categories?

Yep. Use listpatentclasses to get every available classification code upfront. This is critical for structuring complex searches and ensuring your agent doesn't miss any relevant groups.

Q: Can I use USPTO API with the OpenAI Agents SDK to check if the service is running?

Absolutely. Start every workflow by calling checkapistatus. This tool confirms the operational status of the entire USPTO Open Data API, preventing your agent from failing due to connectivity issues.

Audit intellectual property and automate patent research using the OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect USPTO API MCP to OpenAI Agents SDK

Create your Vinkius account to connect USPTO API to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup USPTO API with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Deep Patent Analysis

Use `get_patent_details` to pull every piece of data associated with a specific US patent number. This gives your agent full context, letting it build detailed reports instantly. Need to know what classes a patent falls under? Run `list_patent_classes` first. Your agent gets the list and then uses that knowledge when searching for patents using `search_patents`.

Trademark Verification

Checking IP rights is simple with this server. The tool `get_trademark_details` retrieves all records for a specific trademark serial number. It’s direct, fast data that your agent needs to validate brand claims. For initial sweeps of the market, run `search_trademarks`. This finds US trademarks based on keywords, giving you immediate starting points for further investigation.

Full IP Lifecycle Auditing

Your agent can handle both patents and marks in one flow. It starts by using `check_api_status` to make sure the data source is up before anything else runs. Then, it executes a full search sequence: use `search_patents` for keyword sweeps, follow up with specific searches via `get_patent_details`, and finish by checking related trademarks with `search_trademarks`. This covers the whole audit process.

Setup guide

Set up USPTO API MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all USPTO API tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives USPTO API tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate USPTO API tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="USPTO API Agent",
            instructions="You have access to USPTO API tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by USPTO API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect USPTO API now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about USPTO API MCP in OpenAI Agents SDK

You simply point your agent at the MCP Server and call `search_patents`. The tool takes a keyword, queries the US patent database, and returns a list of matching records. Your agent then uses that list to decide which ones need deeper review.

Just call `get_trademark_details` and pass in the serial number. The agent handles the request, pulls all the metadata, and structures it so you can use it immediately in your application's logic.

Yep. Use `list_patent_classes` to get every available classification code upfront. This is critical for structuring complex searches and ensuring your agent doesn't miss any relevant groups.

This MCP Server handles patent numbers and trademark serial numbers. Specifically, it deals with the underlying text data associated with patents and trademarks found in the USPTO database.

Absolutely. Start every workflow by calling `check_api_status`. This tool confirms the operational status of the entire USPTO Open Data API, preventing your agent from failing due to connectivity issues.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript