Link Monitoring tools

Generated 2026-09-13T03:11:22.248Z from src/tool-registry.js by scripts/export-mint-tool-docs.mjs. 10 of 62 registered tools. Authenticated cloud tools have REST endpoints under /v1/. The anonymous verify_link_free tool uses POST /free/check and /free/mcp.

locate_link

Read link occurrences from one saved observation ID. Does not search URLs or fetch the publisher page.

State: Registered and locally tested.
Access: read · scope: watches:read · defined at src/tool-registry.js:50

Input	Type	Required	Notes
`observationId`	string	yes	ID of a saved observation; this does not fetch a new publisher page.

Error codes: CHECK_COOLDOWN · CHECK_QUOTA_EXCEEDED · CURSOR_EXPIRED · IDEMPOTENCY_CONFLICT · INVALID_CURSOR · INVALID_GRANT · INVALID_INPUT · INVALID_LIMIT · INVALID_URL · JOB_NOT_FOUND · OBSERVATION_NOT_FOUND · OBSERVATION_UNREADABLE · PROJECT_GRANT_RESTRICTED · PROJECT_NOT_FOUND · READ_ONLY_MEMBER · UNAUTHORIZED · WATCH_BUSY · WATCH_NOT_FOUND · WATCH_PAUSED · WATCH_QUOTA_EXCEEDED · WORKSPACE_ACCESS_DENIED

list_link_watches

List monitored placements with last known state and latest attempt.

State: Registered.
Access: read · scope: watches:read · defined at src/tool-registry.js:79

Input	Type	Required	Notes
`cursor`	string	no	Opaque continuation returned by this same listing; omit for the first page.
`limit`	integer	no	Maximum rows in this page or bounded report; subject to the schema maximum.
`projectId`	string	no	Identifier of the project returned by its create or list operation.
`q`	string	no	Text filter applied to saved records; does not start discovery.
`state`	string	no	Requested resource state or saved-observation filter, as enumerated here.
`status`	string	no	Lifecycle status filter or requested status; this is separate from observation state.; one of: active, paused

Error codes: CHECK_COOLDOWN · CHECK_QUOTA_EXCEEDED · CURSOR_EXPIRED · IDEMPOTENCY_CONFLICT · INVALID_CURSOR · INVALID_GRANT · INVALID_INPUT · INVALID_LIMIT · INVALID_URL · JOB_NOT_FOUND · PROJECT_GRANT_RESTRICTED · PROJECT_NOT_FOUND · READ_ONLY_MEMBER · UNAUTHORIZED · WATCH_BUSY · WATCH_NOT_FOUND · WATCH_PAUSED · WATCH_QUOTA_EXCEEDED · WORKSPACE_ACCESS_DENIED

get_link_watch

Inspect a monitored placement and its expectations.

State: Registered.
Access: read · scope: watches:read · defined at src/tool-registry.js:80

Input	Type	Required	Notes
`watchId`	string	yes	Identifier of the watch returned by its create or list operation.

Error codes: CHECK_COOLDOWN · CHECK_QUOTA_EXCEEDED · CURSOR_EXPIRED · IDEMPOTENCY_CONFLICT · INVALID_CURSOR · INVALID_GRANT · INVALID_INPUT · INVALID_LIMIT · INVALID_URL · JOB_NOT_FOUND · PROJECT_GRANT_RESTRICTED · PROJECT_NOT_FOUND · READ_ONLY_MEMBER · UNAUTHORIZED · WATCH_BUSY · WATCH_NOT_FOUND · WATCH_PAUSED · WATCH_QUOTA_EXCEEDED · WORKSPACE_ACCESS_DENIED

monitor_link

Monitor a known source page and target. Identical placements are deduplicated.

State: Registered and locally tested.
Access: write · scope: watches:write · defined at src/tool-registry.js:81

Input	Type	Required	Notes
`projectId`	string	yes	Identifier of the project returned by its create or list operation.
`sourceUrl`	string/uri	yes	Public publisher page URL containing the placement to inspect.
`targetUrl`	string/uri	yes	Public destination URL expected in the placement.
`targetScope`	string	no	URL matching rule: exact URL, domain, subdomain, or path prefix.; one of: exact, domain, subdomain, path
`cadenceSeconds`	integer	no	Scheduled check interval in seconds, from 3600 to 2592000.
`expectedAnchor`	string\|null	no	Expected link anchor text; null clears the expectation.
`expectedRel`	array\|null	no	Expected rel tokens; null clears the expectation.
`localReference`	string	no	Customer-owned reference to associate this record with a local ledger entry.

Side effects: write Error codes: CHECK_COOLDOWN · CHECK_QUOTA_EXCEEDED · CURSOR_EXPIRED · IDEMPOTENCY_CONFLICT · INVALID_CURSOR · INVALID_GRANT · INVALID_INPUT · INVALID_LIMIT · INVALID_URL · JOB_NOT_FOUND · PROJECT_GRANT_RESTRICTED · PROJECT_NOT_FOUND · READ_ONLY_MEMBER · UNAUTHORIZED · WATCH_BUSY · WATCH_NOT_FOUND · WATCH_PAUSED · WATCH_QUOTA_EXCEEDED · WORKSPACE_ACCESS_DENIED

update_link_watch

Pause/resume a placement or update cadence and expectations.

State: Registered.
Access: write · scope: watches:write · defined at src/tool-registry.js:83

Input	Type	Required	Notes
`watchId`	string	yes	Identifier of the watch returned by its create or list operation.
`status`	string	no	Lifecycle status filter or requested status; this is separate from observation state.; one of: active, paused
`cadenceSeconds`	integer	no	Scheduled check interval in seconds, from 3600 to 2592000.
`expectedAnchor`	string\|null	no	Expected link anchor text; null clears the expectation.
`expectedRel`	array\|null	no	Expected rel tokens; null clears the expectation.
`localReference`	string	no	Customer-owned reference to associate this record with a local ledger entry.

get_link_history

List paginated saved observations for one monitored placement, including evidence references and retention limits.

State: Registered.
Access: read · scope: watches:read · defined at src/tool-registry.js:86

Input	Type	Required	Notes
`watchId`	string	yes	Identifier of the watch returned by its create or list operation.
`cursor`	string	no	Opaque continuation returned by this same listing; omit for the first page.
`limit`	integer	no	Maximum rows in this page or bounded report; subject to the schema maximum.

Error codes: CHECK_COOLDOWN · CHECK_QUOTA_EXCEEDED · CURSOR_EXPIRED · IDEMPOTENCY_CONFLICT · INVALID_CURSOR · INVALID_GRANT · INVALID_INPUT · INVALID_LIMIT · INVALID_URL · JOB_NOT_FOUND · PROJECT_GRANT_RESTRICTED · PROJECT_NOT_FOUND · READ_ONLY_MEMBER · UNAUTHORIZED · WATCH_BUSY · WATCH_NOT_FOUND · WATCH_PAUSED · WATCH_QUOTA_EXCEEDED · WORKSPACE_ACCESS_DENIED

list_link_events

Read change events using an opaque cursor. Apply a full page locally before saving next_cursor.

State: Registered.
Access: read · scope: events:read · defined at src/tool-registry.js:88

Input	Type	Required	Notes
`cursor`	string	no	Opaque continuation returned by this same listing; omit for the first page.
`limit`	integer	no	Maximum rows in this page or bounded report; subject to the schema maximum.
`projectId`	string	no	Identifier of the project returned by its create or list operation.

Error codes: CHECK_COOLDOWN · CHECK_QUOTA_EXCEEDED · CURSOR_EXPIRED · IDEMPOTENCY_CONFLICT · INVALID_CURSOR · INVALID_GRANT · INVALID_INPUT · INVALID_LIMIT · INVALID_URL · JOB_NOT_FOUND · PROJECT_GRANT_RESTRICTED · PROJECT_NOT_FOUND · READ_ONLY_MEMBER · UNAUTHORIZED · WATCH_BUSY · WATCH_NOT_FOUND · WATCH_PAUSED · WATCH_QUOTA_EXCEEDED · WORKSPACE_ACCESS_DENIED

export_link_watches

Export monitored placements with pagination for local CRM recovery.

State: Registered.
Access: read · scope: exports:create · defined at src/tool-registry.js:89

Input	Type	Required	Notes
`cursor`	string	no	Opaque continuation returned by this same listing; omit for the first page.
`limit`	integer	no	Maximum rows in this page or bounded report; subject to the schema maximum.
`projectId`	string	no	Identifier of the project returned by its create or list operation.
`q`	string	no	Text filter applied to saved records; does not start discovery.
`state`	string	no	Requested resource state or saved-observation filter, as enumerated here.
`status`	string	no	Lifecycle status filter or requested status; this is separate from observation state.; one of: active, paused

Error codes: CHECK_COOLDOWN · CHECK_QUOTA_EXCEEDED · CURSOR_EXPIRED · IDEMPOTENCY_CONFLICT · INVALID_CURSOR · INVALID_GRANT · INVALID_INPUT · INVALID_LIMIT · INVALID_URL · JOB_NOT_FOUND · PROJECT_GRANT_RESTRICTED · PROJECT_NOT_FOUND · READ_ONLY_MEMBER · UNAUTHORIZED · WATCH_BUSY · WATCH_NOT_FOUND · WATCH_PAUSED · WATCH_QUOTA_EXCEEDED · WORKSPACE_ACCESS_DENIED

get_link_profile

Summarize monitored placements, source hosts, destinations and observed rel attributes. Read coverage: this is your tracked dataset, not the whole web.

State: Registered and locally tested.
Access: read · scope: watches:read · defined at src/tool-registry.js:90

Input	Type	Required	Notes
`projectId`	string	no	Identifier of the project returned by its create or list operation.
`status`	string	no	Lifecycle status filter or requested status; this is separate from observation state.; one of: all, active, paused
`limit`	integer	no	Maximum rows in this page or bounded report; subject to the schema maximum.

Error codes: CURSOR_NOT_SUPPORTED · INVALID_INPUT · INVALID_LIMIT

get_anchor_report

Analyze exact anchors and Unicode terms from saved successful observations. Counts include explicit coverage and stale-evidence indicators.

State: Registered and locally tested.
Access: read · scope: watches:read · defined at src/tool-registry.js:91

Input	Type	Required	Notes
`projectId`	string	no	Identifier of the project returned by its create or list operation.
`status`	string	no	Lifecycle status filter or requested status; this is separate from observation state.; one of: all, active, paused
`limit`	integer	no	Maximum rows in this page or bounded report; subject to the schema maximum.

Error codes: CURSOR_NOT_SUPPORTED · INVALID_INPUT · INVALID_LIMIT

MCP, REST and access

Research

Monitoring

Webhooks

locate_link

list_link_watches

get_link_watch

monitor_link

update_link_watch

get_link_history

list_link_events

export_link_watches

get_link_profile

get_anchor_report

​locate_link

​list_link_watches

​get_link_watch

​monitor_link

​update_link_watch

​get_link_history

​list_link_events

​export_link_watches

​get_link_profile

​get_anchor_report

locate_link

list_link_watches

get_link_watch

monitor_link

update_link_watch

get_link_history

list_link_events

export_link_watches

get_link_profile

get_anchor_report