Destination Health tools

Generated 2026-09-13T03:11:22.248Z from src/tool-registry.js by scripts/export-mint-tool-docs.mjs. 9 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.

list_targets

List explicitly monitored destination URLs. Checks are independent of source-link presence.

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

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 · CURSOR_EXPIRED · IDEMPOTENCY_CONFLICT · INVALID_CADENCE · INVALID_CURSOR · INVALID_IDEMPOTENCY_KEY · INVALID_INPUT · INVALID_LIMIT · INVALID_STATUS · INVALID_TARGET_ID · INVALID_UPDATE · JOB_NOT_FOUND · TARGET_BUSY · TARGET_NOT_FOUND · TARGET_PAUSED · TARGET_QUOTA_EXCEEDED

get_target

Read a destination health watch and its current evidence state.

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

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

monitor_target

Register an exact public destination URL for recurring health checks. Duplicates within a project are reused. Each completed check uses one unit of the shared monthly check allowance.

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

Input	Type	Required	Notes
`projectId`	string	yes	Identifier of the project returned by its create or list operation.
`url`	string/uri	yes	Public HTTPS endpoint or destination URL required by this operation.
`cadenceSeconds`	integer	no	Scheduled check interval in seconds, from 3600 to 2592000.

Side effects: write Error codes: CHECK_COOLDOWN · CURSOR_EXPIRED · IDEMPOTENCY_CONFLICT · INVALID_CADENCE · INVALID_CURSOR · INVALID_IDEMPOTENCY_KEY · INVALID_INPUT · INVALID_LIMIT · INVALID_STATUS · INVALID_TARGET_ID · INVALID_UPDATE · JOB_NOT_FOUND · TARGET_BUSY · TARGET_NOT_FOUND · TARGET_PAUSED · TARGET_QUOTA_EXCEEDED

update_target

Pause/resume a destination check or change its cadence.

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

Input	Type	Required	Notes
`targetId`	string	yes	Identifier of the target 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.

request_target_check

Queue a metered destination health check. Reuse the idempotency key for a retry; blocked results remain unknown.

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

Input	Type	Required	Notes
`targetId`	string	yes	Identifier of the target returned by its create or list operation.
`idempotencyKey`	string	yes	Caller-generated key reused only for retries of the same operation and arguments in this workspace.

Side effects: write; dispatchJobs(jobId) Error codes: CHECK_COOLDOWN · CURSOR_EXPIRED · IDEMPOTENCY_CONFLICT · INVALID_CADENCE · INVALID_CURSOR · INVALID_IDEMPOTENCY_KEY · INVALID_INPUT · INVALID_LIMIT · INVALID_STATUS · INVALID_TARGET_ID · INVALID_UPDATE · JOB_NOT_FOUND · TARGET_BUSY · TARGET_NOT_FOUND · TARGET_PAUSED · TARGET_QUOTA_EXCEEDED

get_target_job

Read progress and usage reservation for an asynchronous destination-health check job.

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

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

get_target_history

List paginated saved destination-health observations, independently of source-link presence.

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

Input	Type	Required	Notes
`targetId`	string	yes	Identifier of the target 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.

get_target_placements

List placements whose configured target URL exactly matches this destination. Other URLs matched by a domain/path watch are not included.

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

Input	Type	Required	Notes
`targetId`	string	yes	Identifier of the target 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.

list_target_events

Read the independent destination-health event feed. Its cursor is separate from link events; a broken destination does not imply that its source backlink disappeared.

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

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.

MCP, REST and access

Research

Monitoring

Webhooks

Destination Health tools

list_targets

get_target

monitor_target

update_target

request_target_check

get_target_job

get_target_history

get_target_placements

list_target_events

​list_targets

​get_target

​monitor_target

​update_target

​request_target_check

​get_target_job

​get_target_history

​get_target_placements

​list_target_events

list_targets

get_target

monitor_target

update_target

request_target_check

get_target_job

get_target_history

get_target_placements

list_target_events