goalie-mcp

Trademark MCP Server (USPTO)

Community goalie-mcp
Updated

Search & filter 14M+ USPTO trademark records from an AI agent. This is a trademark MCP server, not a TSDR lookup.

Trademark MCP Server (USPTO)

MCP Badge

A remote Model Context Protocol server that lets an AI agentsearch and filter 14M+ USPTO trademark records — by mark text, owner, goods/services, class,status, and date — then pull any full record by serial number.

Point Claude Code, the Claude API, Cursor, or any MCP client at one URL and your agent can query theUS federal trademark register with no integration code to write.

Get a key and full docs: goalieip.com/mcp ·setup for every client at goalieip.com/docs#mcp

Not another TSDR wrapper

Most "trademark MCP" servers wrap the USPTO's TSDR endpoint, which returns a single record onlywhen you already know its serial or registration number. That's a lookup tool. This serversearches and filters the whole register, so your agent can find the marks it doesn't alreadyhave the numbers for.

Capability TSDR-based MCP Goalie IP MCP
Retrieve a record by serial or registration number
Search by mark text — exact, contains, or fuzzy
Filter by owner, goods/services, and class
Filter by status and filing / registration date
Surface similar marks for clearance-style questions
Search across all 14M+ US federal records at once

See examples/prompts.md for two real sessions — including a ten-nameclearance screen that a lookup-only tool cannot begin, because no serial numbers are known going in.

Quickstart (Claude Code)

Create an API key in your Goalie IP portal, then:

claude mcp add --transport http goalieip \
  https://www.goalieip.com/api/mcp \
  --header "Authorization: Bearer gip_live_your_key_here"

Then just ask — the agent picks the tool and filters on its own:

> Are there any live trademarks similar to "GOALIE" for software in class 9?

  Searching US federal trademarks…
  Found 94 matches. 12 are live in class 9, including:
    GOALIEO   — Goalieo Inc      — Live/Pending  — filed 2026-05-29
    …

The two tools

Tool What it does
search_trademarks Search 14M+ US federal records by mark text (exact, contains, or fuzzy), owner, goods/services, serial or registration number, international class, status code, and filing or registration date ranges. Returns compact summaries with a total match count.
get_trademark Retrieve the complete record for one serial number — full goods/services text, owner details, status history, classifications, and prior registrations.

search_trademarks returns compact summaries (page size defaults to 10, capped at 15) sized to sitin a model's context window; call get_trademark for the full record. Every search must include atleast one narrowing filter (markLiteral, ownerName, serialNumber, registrationNumber,goodsAndServices, or another text filter) — class, status, and date filters alone match too muchof the register to run. When a query is rejected or times out, the tool replies with the specificparameter to change, so the agent can correct itself and retry.

In the MCP Registry

This server is published to the officialMCP Registry as com.goalieip/trademark, under anamespace verified against the goalieip.com domain — so the listing is first-party, not athird-party mirror.

curl "https://registry.modelcontextprotocol.io/v0/servers?search=com.goalieip/trademark"

Clients that read the registry can add the server by name, and will prompt for the Authorizationheader themselves. Clients that don't, use the manual configs below.

Connect from any client

Config files for each client are in examples/. Replace gip_live_your_key_here with akey from your portal.

Claude API (MCP connector)

{
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://www.goalieip.com/api/mcp",
      "name": "goalieip",
      "authorization_token": "gip_live_your_key_here"
    }
  ]
}

Any MCP client / Cursor (generic config)

{
  "mcpServers": {
    "goalieip": {
      "type": "http",
      "url": "https://www.goalieip.com/api/mcp",
      "headers": {
        "Authorization": "Bearer gip_live_your_key_here"
      }
    }
  }
}

Claude Desktop

Claude Desktop's Add connector screen only accepts OAuth, so connect through the smallmcp-remote bridge, which attaches your key for you. Fullstep-by-step (including the "fully quit before editing" gotcha) is atgoalieip.com/docs#mcp.

{
  "mcpServers": {
    "goalieip": {
      "command": "cmd",
      "args": [
        "/c", "npx", "-y", "mcp-remote@latest",
        "https://www.goalieip.com/api/mcp",
        "--header", "Authorization:Bearer ${GOALIE_KEY}"
      ],
      "env": { "GOALIE_KEY": "gip_live_your_key_here" }
    }
  }
}

On macOS, drop the "cmd", "/c", entries so the args start at "npx". The bridge needsNode.js. The header is written Authorization:Bearer with no space after thecolon so argument parsing doesn't split it.

Server details

Registry name com.goalieip/trademark (MCP Registry)
Endpoint https://www.goalieip.com/api/mcp
Transport Streamable HTTP (remote — nothing to install or self-host)
Protocol revisions 2026-07-28 native; 2025-11-25 also answered on the same URL
Authentication Bearer API key, identical to the REST API
Coverage US federal (USPTO) applications and registrations, refreshed daily

Always configure the www host. goalieip.com 301-redirects to www, and many clients drop theAuthorization header across the redirect (→ a 401). More troubleshooting:goalieip.com/docs#mcp.

Pricing

MCP access is included with every Goalie IP API plan at no extra cost — it uses the same key andthe same monthly quota as the REST API. The free tier is 200 calls/month (no credit card).Compare plans at goalieip.com/subscribe#api.

One note on sizing: agents typically make several tool calls to answer one question, so MCP consumesquota faster than a scripted one-request-per-lookup integration. Budget for that when picking a plan.

Scope & safety

  • US federal data only. This is a continuously-refreshed copy of the USPTO trademark register,updated daily and occasionally a day behind. It does not cover US state registrations,unregistered common-law use, or trademark offices outside the United States. Goalie IP is notaffiliated with or endorsed by the USPTO.
  • Record text is third-party input. Mark text, owner names, and goods/services descriptions arewritten by whoever filed the application, and every US filing becomes a public record. Toolresponses fence that content and label it as data — but if you build your own agent on this data,apply your own checks before letting record text drive tool calls or privileged actions.
  • Results are data, not legal advice. These tools return records from the USPTO register. They donot assess registrability, likelihood of confusion, or infringement, and using them creates noattorney-client relationship. For an attorney-led clearance opinion or enforcement work,talk to the Goalie IP team.

Links

License

MIT © Goalie IP Inc. This repository documents how to connect to the hosted Goalie IPtrademark MCP server; the server and the underlying data are operated by Goalie IP.

MCP Server · Populars

MCP Server · New

    laurentvv

    Web Crawler MCP

    Web crawling tool that integrates with AI assistants via the MCP

    Community laurentvv
    anypost

    emailmd

    Render markdown into email-safe HTML

    Community anypost
    dinglebear-ai

    Unraid MCP

    Query, monitor, and manage Unraid servers via GraphQL API through MCP tools. Supports system info, Docker, VMs, array/parity, notifications, plugins, rclone, and live telemetry.

    Community dinglebear-ai
    superbasedapp

    SuperBased Observer

    Local-first control plane for AI coding agents — launch browser terminals, run and remotely control sessions, and track files, tokens & cost across Claude Code, Codex, Cursor, Gemini CLI and 20+ more. 100% local, no telemetry.

    Community superbasedapp
    OpenMarkdown-dev

    OpenMarkdown

    Feather-light. Light-speed.

    Community OpenMarkdown-dev