Get anchor report

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

Hosted MCP registration verified. These schemas describe the development contract; confirm supported inputs with tools/list. Generic CLI/HTTP calls require a matching development server. Configure LINKTRAIL_API_URL; production does not expose these command routes.

Access	Behavior
`watches:read`	Reads saved data

Reading saved data does not start a verification job. Mutations can change saved records or access; the effects below apply.

Example request

Connect through MCP, CLI, or HTTP. Replace example identifiers with records from your workspace.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_anchor_report",
    "arguments": {}
  }
}

linktrail call get_anchor_report --args '{}'

curl "$LINKTRAIL_API_URL/v1/commands/get_anchor_report" \
  -H "Authorization: Bearer $LINKTRAIL_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{}'

Returned result

Illustrative data validated against the documented response schema. IDs and dates are examples, not a live account capture. MCP returns this data in structuredContent and in a text content block; generic HTTP and CLI return the JSON result directly.

{
  "schema_version": 1,
  "workspace_id": "ws_example",
  "project_id": null,
  "status_filter": "all",
  "generated_at": "2026-09-13T12:00:00.000Z",
  "coverage": {
    "denominator": "known_monitored_placements",
    "whole_web_coverage": false,
    "observation_basis": "latest_complete_successful_observation_per_watch",
    "includes_paused": true,
    "project_grant": "all_projects",
    "watch_count": 0,
    "scanned_watch_count": 0,
    "eligible_present_watches_in_scan": 0,
    "excluded_evidence_watches_in_scan": 0,
    "available_occurrences_in_scan": 0,
    "scanned_occurrence_count": 0,
    "included_occurrence_count": 0,
    "invalid_occurrence_count": 0,
    "occurrence_payload_bytes": 0,
    "watch_payload_bytes": 0,
    "watch_scan_limit": 1000,
    "occurrence_scan_limit": 5000,
    "watch_payload_byte_limit": 2097152,
    "occurrence_payload_byte_limit": 1048576,
    "included_observation_oldest_at": null,
    "included_observation_newest_at": null,
    "partial": false,
    "limitations": []
  },
  "analysis_partial": false,
  "freshness": {
    "oldest_last_success_at": null,
    "newest_last_success_at": null,
    "oldest_latest_attempt_at": null,
    "newest_latest_attempt_at": null
  },
  "counting_notes": [
    "Coverage is limited to the monitored placements in this workspace."
  ],
  "evidence_context": {
    "latest_unknown_watches": 0,
    "known_present_after_unknown": 0
  },
  "anchors": {
    "items": [],
    "total_groups": 0,
    "returned_groups": 0,
    "truncated": false
  },
  "terms": {
    "items": [],
    "total_groups": 0,
    "returned_groups": 0,
    "truncated": false
  },
  "tokenization": {
    "version": 2,
    "normalization": "NFKC then Unicode lowercase; curly apostrophe becomes ASCII apostrophe",
    "segmentation": "Unicode letter/number runs, combining marks and internal apostrophes; hyphens split; emoji ignored",
    "address_spans_removed": true,
    "stopwords_removed": false,
    "stemming": false,
    "language_specific_segmentation": false,
    "maximum_token_codepoints": 128,
    "tokens_seen": 0,
    "unique_terms_included": 0,
    "term_dictionary_limit": 20000,
    "omitted_long_token_occurrences": 0,
    "omitted_dictionary_token_occurrences": 0,
    "partial": false
  }
}

Input fields

Omit optional fields when you do not want to supply them. Null is accepted only where listed. Unknown input properties are rejected.

Field	Type	Presence	Meaning and constraints
`projectId`	string	Optional	Identifier of the project returned by its create or list operation. minLength: 1; maxLength: 200
`status`	string	Optional	Lifecycle status filter or requested status; this is separate from observation state. default: “all”; values: “all”, “active”, “paused”
`limit`	integer	Optional	Maximum rows in this page or bounded report; subject to the schema maximum. minimum: 1; maximum: 100; default: 50

Validation and omitted values

Omitting projectId reads the accessible workspace scope rather than selecting a different project. These are bounded reports, not cursor-paginated exports. The report limit bounds returned groups; retained dataset coverage and truncation remain explicit. Omitted projectId includes records allowed by the credential.

Defaults when omitted

Field	Default
`status`	`"all"`
`limit`	`50`

Output fields

Fields inside optional or nullable parents apply only when that parent exists. Common schema conventions explain evidence states, empty lists and extensions.

Field	Type	Presence	Meaning and constraints
`schema_version`	number	Required	schema version recorded for this result.
`workspace_id`	string	Required	Workspace that owns this record.
`project_id`	string / null	Required	Project that owns this record.
`status_filter`	string	Required	status filter recorded for this result.
`generated_at`	string	Required	generated at recorded for this result.
`coverage`	object	Required	Dataset scope and completeness, including limits on what these results establish.
`coverage.denominator`	string	Required	denominator recorded for this result.
`coverage.whole_web_coverage`	boolean	Required	False: these results do not measure the whole web. must equal false
`coverage.observation_basis`	string	Required	observation basis recorded for this result.
`coverage.includes_paused`	boolean	Required	includes paused recorded for this result.
`coverage.project_grant`	string	Required	project grant recorded for this result.
`coverage.watch_count`	number	Required	watch count recorded for this result.
`coverage.scanned_watch_count`	number	Required	scanned watch count recorded for this result.
`coverage.eligible_present_watches_in_scan`	number	Required	eligible present watches in scan recorded for this result.
`coverage.excluded_evidence_watches_in_scan`	number	Required	excluded evidence watches in scan recorded for this result.
`coverage.available_occurrences_in_scan`	number	Required	available occurrences in scan recorded for this result.
`coverage.scanned_occurrence_count`	number	Required	scanned occurrence count recorded for this result.
`coverage.included_occurrence_count`	number	Required	included occurrence count recorded for this result.
`coverage.invalid_occurrence_count`	number	Required	invalid occurrence count recorded for this result.
`coverage.occurrence_payload_bytes`	number	Required	occurrence payload bytes recorded for this result.
`coverage.watch_payload_bytes`	number	Required	watch payload bytes recorded for this result.
`coverage.watch_scan_limit`	number	Required	watch scan limit recorded for this result.
`coverage.occurrence_scan_limit`	number	Required	occurrence scan limit recorded for this result.
`coverage.watch_payload_byte_limit`	number	Required	watch payload byte limit recorded for this result.
`coverage.occurrence_payload_byte_limit`	number	Required	occurrence payload byte limit recorded for this result.
`coverage.included_observation_oldest_at`	string / null	Required	included observation oldest at recorded for this result.
`coverage.included_observation_newest_at`	string / null	Required	included observation newest at recorded for this result.
`coverage.partial`	boolean	Required	partial recorded for this result.
`coverage.limitations`	array	Required	limitations recorded for this result.
`analysis_partial`	boolean	Required	analysis partial recorded for this result.
`freshness`	object	Required	freshness recorded for this result.
`freshness.oldest_last_success_at`	string / null	Required	oldest last success at recorded for this result.
`freshness.newest_last_success_at`	string / null	Required	newest last success at recorded for this result.
`freshness.oldest_latest_attempt_at`	string / null	Required	oldest latest attempt at recorded for this result.
`freshness.newest_latest_attempt_at`	string / null	Required	newest latest attempt at recorded for this result.
`counting_notes`	array	Required	counting notes recorded for this result.
`evidence_context`	object	Required	evidence context recorded for this result.
`evidence_context.latest_unknown_watches`	number	Required	latest unknown watches recorded for this result.
`evidence_context.known_present_after_unknown`	number	Required	known present after unknown recorded for this result.
`anchors`	object	Required	anchors recorded for this result.
`anchors.items`	array	Required	Records in this bounded page.
`anchors.items[].distinct_watch_count`	number	Required	distinct watch count recorded for this result.
`anchors.items[].example_watch_ids`	array	Required	example watch ids recorded for this result.
`anchors.items[].occurrence_count`	number	Optional	occurrence count recorded for this result.
`anchors.items[].watch_count`	number	Optional	watch count recorded for this result.
`anchors.items[].token_occurrence_count`	number	Optional	token occurrence count recorded for this result.
`anchors.items[].link_occurrence_count`	number	Optional	link occurrence count recorded for this result.
`anchors.items[].hostname`	string	Optional	hostname recorded for this result.
`anchors.items[].target_url`	string	Optional	Destination URL recorded in this evidence.
`anchors.items[].target_scope`	string	Optional	target scope recorded for this result.
`anchors.items[].anchor`	string	Optional	anchor recorded for this result.
`anchors.items[].empty_anchor`	boolean	Optional	empty anchor recorded for this result.
`anchors.items[].token`	string	Optional	Invitation token returned only at creation. The accepting account must have the matching verified email.
`anchors.items[].term`	string	Optional	term recorded for this result.
`anchors.items[].tokens`	array	Optional	tokens recorded for this result.
`anchors.total_groups`	number	Required	total groups recorded for this result.
`anchors.returned_groups`	number	Required	returned groups recorded for this result.
`anchors.truncated`	boolean	Required	truncated recorded for this result.
`terms`	object	Required	terms recorded for this result.
`terms.items`	array	Required	Records in this bounded page.
`terms.items[].distinct_watch_count`	number	Required	distinct watch count recorded for this result.
`terms.items[].example_watch_ids`	array	Required	example watch ids recorded for this result.
`terms.items[].occurrence_count`	number	Optional	occurrence count recorded for this result.
`terms.items[].watch_count`	number	Optional	watch count recorded for this result.
`terms.items[].token_occurrence_count`	number	Optional	token occurrence count recorded for this result.
`terms.items[].link_occurrence_count`	number	Optional	link occurrence count recorded for this result.
`terms.items[].hostname`	string	Optional	hostname recorded for this result.
`terms.items[].target_url`	string	Optional	Destination URL recorded in this evidence.
`terms.items[].target_scope`	string	Optional	target scope recorded for this result.
`terms.items[].anchor`	string	Optional	anchor recorded for this result.
`terms.items[].empty_anchor`	boolean	Optional	empty anchor recorded for this result.
`terms.items[].token`	string	Optional	Invitation token returned only at creation. The accepting account must have the matching verified email.
`terms.items[].term`	string	Optional	term recorded for this result.
`terms.items[].tokens`	array	Optional	tokens recorded for this result.
`terms.total_groups`	number	Required	total groups recorded for this result.
`terms.returned_groups`	number	Required	returned groups recorded for this result.
`terms.truncated`	boolean	Required	truncated recorded for this result.
`tokenization`	object	Required	tokenization recorded for this result.
`tokenization.version`	number	Required	version recorded for this result.
`tokenization.normalization`	string	Required	normalization recorded for this result.
`tokenization.segmentation`	string	Required	segmentation recorded for this result.
`tokenization.address_spans_removed`	boolean	Required	address spans removed recorded for this result.
`tokenization.stopwords_removed`	boolean	Required	stopwords removed recorded for this result.
`tokenization.stemming`	boolean	Required	stemming recorded for this result.
`tokenization.language_specific_segmentation`	boolean	Required	language specific segmentation recorded for this result.
`tokenization.maximum_token_codepoints`	number	Required	maximum token codepoints recorded for this result.
`tokenization.tokens_seen`	number	Required	tokens seen recorded for this result.
`tokenization.unique_terms_included`	number	Required	unique terms included recorded for this result.
`tokenization.term_dictionary_limit`	number	Required	term dictionary limit recorded for this result.
`tokenization.omitted_long_token_occurrences`	number	Required	omitted long token occurrences recorded for this result.
`tokenization.omitted_dictionary_token_occurrences`	number	Required	omitted dictionary token occurrences recorded for this result.
`tokenization.partial`	boolean	Required	partial recorded for this result.

Download input schema · Download output schema

Errors and retries

The command is annotated idempotent. Reuse an accepted idempotency key when the input provides one; changing the payload under a reused key can conflict. See error recovery for status, scope, cooldown, cursor and retry handling. Unknown observations are result data and do not establish loss.

HTTP resource routes

These existing resource routes share the operation’s domain behavior. Their parameter placement, status and response envelope can differ from generic invocation. See HTTP route details.

Method and route	Success	Details
`GET /v1/reports/anchors`	200	Remaining read arguments go in query parameters.

Continue

export_link_watches Follow the related workflow, inspect capability status, or return to the command index.

Overview

Cloud operations

Repository tools

HTTP and events

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue

​Example request

​Returned result

​Input fields

​Validation and omitted values

​Defaults when omitted

​Output fields

​Errors and retries

​HTTP resource routes

​Continue

Example request

Returned result

Input fields

Validation and omitted values

Defaults when omitted

Output fields

Errors and retries

HTTP resource routes

Continue