CompuMark MCP Server | Documentation

Overview

The server exposes 11 tools in four groups. Use them together: search to find candidate marks, retrieve the records you need, then link out to the CompuMark full text.

Add the server URL above to any MCP-compatible client as a remote server. Your assistant then chooses the right tool from the descriptions below.

Workflows

Find and review marks

1. Search

Find matching trademark IDs. Count first if you expect a large result set.

trademark-knockout-searchtrademark-searchtrademark-count
2. Retrieve

Fetch record details in batches of up to 100 IDs. Add goods and services text when needed.

trademark-contenttrademark-goods
3. Link

Get the CompuMark full-text URL for each mark and use it as the link target.

trademark-fulltext

Example: identical knockout search (illustrative values)

{
  "tool": "trademark-knockout-search",
  "arguments": {
    "trademarkName": "ACMEFLOW",
    "registrationOfficeCodes": ["US", "WO"],
    "classes": ["9", "42"],
    "limitWOresultsToDesignated": true
  }
}

Assess a candidate name with Brand Analyzer

Brand landscape searches run asynchronously. Execute the order, then check the same candidateName until the status is COMPLETED. Only then read the paged results.

Example: sequence of calls

1. brand-analyzer-search-order-execute   { candidateName, classes, goodsAndServices, markets, limitWOresultsToDesignated }
2. brand-analyzer-search-order-info      { candidateName }      // repeat until status is COMPLETED
3. brand-analyzer-search-results         { candidateName, page: 1 }   // 10 results per page

Monitor with Trademark Watch

List your watch orders with trademark-watch-orders, then read the reported trademarks for one order with trademark-watch-results. Pass fromDate to see only newer reports.

Tool reference

All parameters marked required must be supplied on every call.

Search and count

trademark-knockout-search

Identical knockout

Runs an identical (exact) knockout search and returns the IDs of matching trademarks.

Parameter	Type	Required	Notes
trademarkName	string	Yes
registrationOfficeCodes	string[]	Yes	See usage notes for country searches.
classes	string[]	Yes
limitWOresultsToDesignated	boolean	Yes

trademark-search

Custom screening

Flexible search across the trademark databases using a searchFields filter list. Supports phonetics, plurals, cross-references and regional phonetics. Returns a list of matching IDs.

Parameter	Type	Required	Notes
searchFields	string	Yes	JSON array of `{name, operator, value}`
registrationOfficeCodes	string[]	Yes	`"All"` is supported.
activeOnly	boolean	Yes
phonetics	boolean	Yes
plurals	boolean	Yes
crossReferences	boolean	Yes
centralEuropeanPhonetics	boolean	Yes
japanesePhonetics	boolean	Yes
limitWOresultsToDesignated	boolean	Yes

trademark-count

Returns the number of results only, with no IDs. Use it to estimate volume before retrieval.

Takes the same parameters as trademark-search.

Retrieval

trademark-content

Max 100 IDs per call

Retrieves trademark details, excluding goods and services, for up to 100 IDs. Returns registration number, verbal element, status, office, classes, dates, applicants and mark feature.

Parameter	Type	Required	Notes
ids	string[]	Yes	Maximum 100 per call.

trademark-goods

Returns the goods and services text for a single trademark ID. Call it after trademark-content when you need goods detail.

Parameter	Type	Required	Notes
id	string	Yes	One ID per call.

trademark-fulltext

Returns CompuMark full-text URLs for a list of trademark IDs. Present each as a hyperlink labeled "full-text", and use these URLs as the canonical link target rather than third-party registry URLs.

Parameter	Type	Required	Notes
ids	string[]	Yes

Brand Analyzer

Brand landscape searches are asynchronous. Execute an order, then poll with the same candidateName.

brand-analyzer-search-order-execute

Async

Executes a brand landscape search order for a candidate name. Results are available only once the order status is COMPLETED.

Parameter	Type	Required	Notes
candidateName	string	Yes
classes	string[]	Yes	Classes 1 to 45. Must not be empty.
goodsAndServices	string[]	Yes
markets	string[]	Yes	WIPO ST.3 codes. Must not be empty.
limitWOresultsToDesignated	boolean	Yes

brand-analyzer-search-order-info

Returns the search strategy and order information for a candidate's most recent brand landscape search: classes, goods and the total trademark result count.

Parameter	Type	Required	Notes
candidateName	string	Yes

brand-analyzer-search-results

10 per page

Returns paged results for a completed brand landscape order. Filter to high and medium verbal similarity matches, or to results you have selected.

Parameter	Type	Required	Notes
page	integer	Yes	Page size is 10.
candidateName	string	No
highMediumVerbalSimilarity	boolean	No	Returns high and medium verbal similarity matches only.
selected	boolean	No	Returns customer-selected results only.

Trademark Watch

trademark-watch-orders

Returns a list of trademark watch orders for the customer. Filter by client reference, order number or watched trademark name.

Parameter	Type	Required	Notes
page	integer	Yes
clientReference	string	No
orderNumber	string	No
trademarkWatch	string	No	Watched trademark name.

trademark-watch-results

10 per page

Returns paged reported trademarks for a specific watch order. Optionally filter to results reported from a given date.

Parameter	Type	Required	Notes
orderNumber	string	Yes
fromDate	string	No	Format `YYYYMMDD`.
page	integer	No	Page size is 10.

Usage notes

Batch large result sets trademark-content accepts a maximum of 100 IDs per call. Split larger result sets into batches.
Country searches When searching a specific country, also include WO in registrationOfficeCodes with limitWOresultsToDesignated: true. For EU countries, also include EM.
Use CompuMark full-text links Use trademark-fulltext URLs as the canonical link for a mark. Do not substitute third-party registry URLs such as tmdn.org.
Wait for Brand Analyzer to finish brand-analyzer-search-order-execute is asynchronous. Poll brand-analyzer-search-order-info or brand-analyzer-search-results with the same candidateName until the status is COMPLETED before you read results.
Paging brand-analyzer-search-results and trademark-watch-results return 10 results per page.