create_watch

Creates a persistent monitoring rule that periodically checks for changes and emits events. Supports three watch types: status changes on a specific mark, new filings similar to a monitored mark, and approaching deadlines (opposition, renewal, expiration).

Parameters

Parameter	Type	Required	Description
name	string	Yes	Human-readable label for this watch (max 200 chars)
type	string	Yes	status_change, similar_filing, or deadline_approaching
trademarkId	string	Conditional	Trademark ID (e.g., “US-87654321”). Required for status_change and deadline_approaching.
markName	string	Conditional	Mark name to monitor. Required for similar_filing.
jurisdictions	string[]	No	Jurisdictions to monitor (default: all configured). Options: US, EU, AU, NZ, WIPO, GB, CA, JP, CN.
niceClasses	number[]	No	Nice classes to narrow similarity searches (default: [])
similarityThreshold	number	No	Minimum similarity score for alerts, 0-1 (default: 0.7)
deadlineDaysAhead	number	No	Days before deadline to alert (default: 30, max: 365)
webhookUrl	string	No	Webhook URL for event delivery

Example

Request

{
  "name": "create_watch",
  "arguments": {
    "name": "Monitor NEXTERA registration status",
    "type": "status_change",
    "trademarkId": "EU-018734521",
    "webhookUrl": "https://hooks.example.com/ipkit/nextera"
  }
}

Response

{
  "watch": {
    "id": "w_abc123def456",
    "name": "Monitor NEXTERA registration status",
    "type": "status_change",
    "enabled": true,
    "trademarkId": "EU-018734521",
    "jurisdictions": [],
    "niceClasses": [],
    "similarityThreshold": 0.7,
    "deadlineDaysAhead": 30,
    "webhookUrl": "https://hooks.example.com/ipkit/nextera",
    "createdAt": "2024-03-04T10:30:00.000Z"
  },
  "message": "Watch \"Monitor NEXTERA registration status\" created successfully. It will start monitoring on the next poll cycle."
}

Notes

• Accepts both colon (US:87654321) and hyphen (US-87654321) format for trademark IDs, normalizing to hyphen format.
• Status change watches fire when a mark transitions (e.g., “pending” to “registered” or “registered” to “expired”).
• Similar filing watches use the same ensemble similarity algorithms as trademark_clearance.
• Deadline watches alert before opposition periods, renewal deadlines, and expiration dates.

Related Tools

• list_watches — view all configured watches
• manage_watch — pause, resume, or delete a watch
• get_watch_events — retrieve events generated by watches