tools/list) with full input schemas — you rarely need to call a tool by name. This page is the map of what’s available and the scope each requires.
Most tools are org-scoped to your authenticated session. Org context comes
from your token or API key — never from a tool argument — so an agent can’t read
or change another organization’s data. Reference-data tools (offices,
jurisdictions, classifications, rules) are global public data — they aren’t
org-scoped, but still require the
trademarks:read scope like other reads. Read
tools need a read, search, or trademarks:read scope; account/usage tools
need billing:read; watch writes need portfolios:manage. See
Authentication & security.Search
| Tool | What it does | Scope | Read/Write |
|---|---|---|---|
search_trademarks | Search global registrations by name, owner, Nice class, jurisdiction, or status. Exact, phonetic, fuzzy, and prefix matching across 21 offices. | read | Read |
suggest | Quick typeahead across trademarks, owners, attorneys, and firms — compact results for disambiguation. | read | Read |
Trademarks
| Tool | What it does | Scope | Read/Write |
|---|---|---|---|
get_trademark | Full detail for one mark by ID — owners, attorneys, classifications, events, media. | read | Read |
list_trademarks | List marks with filtering and sorting (use search_trademarks for text search). | read | Read |
get_trademark_history | Prosecution event timeline for a mark (filings, publications, registrations, status changes). | read | Read |
get_trademark_changes | Version-level field diffs — what changed between ingested versions, and when. | read | Read |
get_trademark_related | Mark-to-mark relationships: Madrid designations, divisionals, seniority claims, transformations. | read | Read |
get_trademark_proceedings | Proceedings involving a mark (oppositions, cancellations), each with its parties. | read | Read |
get_trademark_coverage | Jurisdictional coverage — Madrid designation territories and protection status. | read | Read |
get_trademark_source | Raw-record provenance: source office, observation date, and source format. | read | Read |
batch_get_trademarks | Fetch full detail for up to 100 marks by ID in one call, with a not_found list. | read | Read |
Owners & entities
| Tool | What it does | Scope | Read/Write |
|---|---|---|---|
get_owner | Owner (applicant/registrant) detail with portfolio statistics. | read | Read |
list_owners | Search and list owners — find companies or individuals who hold marks. | read | Read |
get_owner_trademarks | An owner’s trademarks (summary tier) with filtering and sorting. | read | Read |
get_owner_related | Owners related via the GLEIF corporate hierarchy (parent/child). | read | Read |
get_entity | A resolved entity: the cross-office identity over per-office owner clusters, with link evidence and public-company facts. | read | Read |
list_entities | Search resolved entities (one company across all offices), filterable by public-company facts. | read | Read |
get_entity_trademarks | A resolved entity’s trademarks fanned across all member owners. | read | Read |
get_entity_family | A resolved entity’s direct GLEIF corporate family (parent + direct subsidiaries). | read | Read |
Attorneys & firms
| Tool | What it does | Scope | Read/Write |
|---|---|---|---|
get_attorney | Detail for an attorney/representative of record. | read | Read |
list_attorneys | Search and list attorneys/representatives. | read | Read |
get_attorney_trademarks | An attorney’s trademarks (summary tier) with filtering and sorting. | read | Read |
get_attorney_clients | Owners an attorney represents, each with a shared-mark count. | read | Read |
get_firm | Law-firm detail, including portfolio and attorneys. | read | Read |
list_firms | Search and list law firms, ranked by portfolio size or attorney count. | read | Read |
get_firm_attorneys | A firm’s attorneys, each with portfolio stats. | read | Read |
get_firm_trademarks | Trademarks handled by a firm’s attorneys (summary tier). | read | Read |
Proceedings
| Tool | What it does | Scope | Read/Write |
|---|---|---|---|
get_proceeding | Detail for one proceeding (opposition, cancellation, etc.) by ID. | read | Read |
list_proceedings | List TTAB oppositions, cancellations, and other proceedings with filtering. | read | Read |
Reference data
Global, public reference data — not org-scoped, but requires thetrademarks:read scope like other reads. These tools are logged but not billed.
| Tool | What it does | Scope | Read/Write |
|---|---|---|---|
list_offices | Supported trademark offices (live connectors) with jurisdiction and update cadence. | trademarks:read | Read |
get_office | A single office by its lowercase office code (e.g. uspto, euipo, wipo). | trademarks:read | Read |
list_jurisdictions | Supported jurisdictions (ISO-2 plus regional/WIPO codes), with Madrid membership and live-office coverage. | trademarks:read | Read |
get_jurisdiction | A single jurisdiction by code, including Madrid membership and member jurisdictions. | trademarks:read | Read |
get_deadline_rules | Maintenance/renewal deadline rules with statutory citations; optionally per jurisdiction. | trademarks:read | Read |
get_opposition_rules | Opposition window rules with citations, duration, and time zone; optionally per jurisdiction. | trademarks:read | Read |
list_classifications | Nice classification classes (the 45-class WIPO standard), filterable by category or keyword. | trademarks:read | Read |
suggest_classifications | Suggest Nice classes for a natural-language description, ranked with confidence and rationale. | read | Read |
list_goods_services | Browse/search the curated goods & services term catalog. | trademarks:read | Read |
suggest_goods_services | Draft filing-ready goods/services wording per Nice class from a description. | read | Read |
list_design_codes | Vienna classification design codes (figurative-element taxonomy for logos/devices). | trademarks:read | Read |
get_design_code | A single Vienna design code with notes and its child codes. | trademarks:read | Read |
list_event_types | Per-office event-type mappings (raw office codes → canonical Signa event types). | trademarks:read | Read |
Account & usage
Utility tools for your own org’s account and consumption. They require thebilling:read scope and are neither billed nor counted against quota.
| Tool | What it does | Scope | Read/Write |
|---|---|---|---|
get_usage | Current billing-period usage plus the per-endpoint-type quota and rate-limit matrix. | billing:read | Read |
get_usage_summary | Daily usage breakdown (requests, billed units, errors, avg latency) from rollups. | billing:read | Read |
get_account | Org identity (id/name, plan, key scopes + rate-limit tier) with the plan quota breakdown. | billing:read | Read |
Monitoring
Watch and alert reads are read-only. Creating or changing watches — and the watch-scoped diagnostics, preview, and alert lookups — requires theportfolios:manage scope.
| Tool | What it does | Scope | Read/Write |
|---|---|---|---|
signa_watches_list | List monitoring watches for your org (cursor-paginated). | read | Read |
signa_watches_retrieve | Retrieve a single watch by ID. | read | Read |
signa_watches_create | Create a watch (same validation as POST /v1/watches). | portfolios:manage | Write |
signa_watches_update | Update a watch (PATCH semantics — omitted fields unchanged). | portfolios:manage | Write |
signa_watches_delete | Soft-delete a watch (sets deleted_at; row retained). | portfolios:manage | Write |
pause_watch | Pause a watch (stops new alerts). | portfolios:manage | Write |
resume_watch | Resume a paused watch. | portfolios:manage | Write |
preview_watch | Dry-run a watch query: estimate matches and preview marks. No watch is created. | portfolios:manage | Read |
get_watch_diagnostics | Audit-mode provenance trace for one (watch, trademark) pair. | portfolios:manage | Read |
signa_alerts_list | List monitoring alerts for your org. | read | Read |
signa_alerts_retrieve | Retrieve a single alert by ID. | read | Read |
list_alerts_for_watch | List alerts emitted by a single watch (cursor-paginated). | portfolios:manage | Read |
lookup_alert | Bulk-fetch up to 100 alerts by ID (polling pattern). | portfolios:manage | Read |
signa_webhooks_list | List webhook endpoints (secrets are never returned). | read | Read |
signa_webhooks_retrieve | Retrieve one webhook endpoint (secret redacted). | read | Read |
Webhook secrets are never exposed through MCP —
signa_webhooks_* tools
always redact them. Manage secrets via the REST API.