# AgentLinkOps

> Task guides and shared MCP, CLI and HTTP command contracts. Read operation availability before executing a request.

## Guides

- [AgentLinkOps documentation](https://docs.agentlinkops.com/introduction.md): Connect an agent, run the local CLI, or use HTTP to inspect backlink evidence and keep campaign decisions in your repository.
- [Get your first backlink result](https://docs.agentlinkops.com/guides/first-result.md): Check one public source and target locally without an account, read uncertainty correctly, and optionally save the observation to a repository ledger.
- [Start using AgentLinkOps](https://docs.agentlinkops.com/quickstart.md): Choose a local first check or connect to the hosted pilot, then follow the guide for your first backlink result.
- [What you can use today](https://docs.agentlinkops.com/capability-status.md): See which AgentLinkOps campaign, research, monitoring and local toolkit capabilities are available in the private pilot and which still need release acceptance.
- [Connect your agent through MCP](https://docs.agentlinkops.com/guides/connect-mcp.md): Authorize the hosted MCP connection, confirm workspace and project access, and distinguish product tools from local context and documentation search.
- [Use the Linktrail CLI](https://docs.agentlinkops.com/guides/connect-cli.md): Run local checks from an authorized checkout, connect a ledger to its hosted project, and inspect the shared cloud command catalog.
- [Call AgentLinkOps over HTTP](https://docs.agentlinkops.com/guides/connect-http.md): Authenticate with a scoped API credential, select a workspace, and send requests using the shared command and resource endpoints.
- [From publisher research to a campaign brief](https://docs.agentlinkops.com/campaign-workflows.md): Use imports, public contact evidence, mention and citation research, and local briefs to help your agent prepare a backlink campaign with a clear next action.
- [Check a supplied placement](https://docs.agentlinkops.com/guides/check-placement.md): Create a watch, request an asynchronous link check, and inspect the completed observation and retained evidence through your chosen client.
- [Import and verify backlink candidates](https://docs.agentlinkops.com/guides/import-and-verify.md): Preserve an export as candidates, select up to fifty rows for an asynchronous batch, and explicitly enroll completed present results for monitoring.
- [Monitor placements and inspect changes](https://docs.agentlinkops.com/guides/monitor-changes.md): Follow source and destination checks, interpret event feeds, pause recurring work, and review usage without confusing unknown attempts with loss.
- [Compare competitor inventories](https://docs.agentlinkops.com/guides/competitor-research.md): Build an approved competitor set, freeze dated inventory evidence, and compare dataset-qualified gaps without claiming whole-web coverage.
- [Receive events and recover missed delivery](https://docs.agentlinkops.com/guides/webhooks.md): Configure signed webhook delivery, deduplicate attempts, inspect failures, and recover retained event history through authenticated feeds.
- [Sync history and export your records](https://docs.agentlinkops.com/guides/sync-and-export.md): Preview expectation uploads, pull independently cursored feeds, recover expired history, and export monitored records without changing local campaign notes.
- [Give your agent repository context](https://docs.agentlinkops.com/guides/local-context.md): Run the separate local MCP host for manual site inputs, imported Search Console rows and cited site facts inside a fixed repository boundary.
- [How records, checks and usage fit together](https://docs.agentlinkops.com/guides/concepts.md): Understand candidates, watches, observations, local intent, asynchronous jobs, frozen pagination and shared check budgets before building a workflow.
- [Keep campaign intent and evidence in your repository](https://docs.agentlinkops.com/ledger.md): Use the Linktrail ledger to record wanted and expected backlinks, import candidates, review observations and sync cloud history while keeping local ownership.
- [Read evidence without turning uncertainty into loss](https://docs.agentlinkops.com/evidence.md): Understand present, absent and unknown backlink observations, repeated-loss confirmation, destination health and the limits of contact and discovery evidence.
- [Recover failed connections and interrupted work](https://docs.agentlinkops.com/guides/troubleshooting.md): Resolve authentication and scope errors, pending or unknown checks, expired evidence and cursors, local sync conflicts and webhook failures.

## Reference

- [Command reference](https://docs.agentlinkops.com/reference.md): Find a command by task, exact name, interface and availability.
- [Read these docs with an agent](https://docs.agentlinkops.com/reference/agents.md): Find task guidance, retrieve a specific operation as Markdown, and distinguish documentation search from product commands.
- [Errors and recovery](https://docs.agentlinkops.com/reference/errors.md): Read shared error codes, distinguish retries from access or configuration changes, and recover queued work, expired cursors and missing evidence.
- [Common records and response conventions](https://docs.agentlinkops.com/reference/schemas.md): Understand shared identifiers, optional fields, pagination, jobs, observations, usage reservations and candidate batch results across the command reference.
- [List invitations](https://docs.agentlinkops.com/reference/commands/list_invitations.md): List open, accepted and revoked invitations.
- [List members](https://docs.agentlinkops.com/reference/commands/list_members.md): List this workspace's members with their role and, when narrowed, the exact projects they can see.
- [List projects](https://docs.agentlinkops.com/reference/commands/list_projects.md): List projects available to this agent.
- [List workspace events](https://docs.agentlinkops.com/reference/commands/list_workspace_events.md): Read workspace limit changes with before/after values and a separate stable cursor.
- [Get project](https://docs.agentlinkops.com/reference/commands/get_project.md): Read one project available to this credential.
- [Get usage](https://docs.agentlinkops.com/reference/commands/get_usage.md): Read workspace usage, allowance and billing availability for one UTC month.
- [Get workspace](https://docs.agentlinkops.com/reference/commands/get_workspace.md): Read workspace limits, usage and membership.
- [Create project](https://docs.agentlinkops.com/reference/commands/create_project.md): Create a project for the product domain.
- [Invite member](https://docs.agentlinkops.com/reference/commands/invite_member.md): Invite one email address as admin, member or viewer, optionally scoped to specific projects.
- [Set member access](https://docs.agentlinkops.com/reference/commands/set_member_access.md): Change one member's role, their project grant, or both.
- [Preview resource deletion](https://docs.agentlinkops.com/reference/commands/preview_resource_deletion.md): Preview permanent removal of an unused watch, target or project.
- [Revoke invitation](https://docs.agentlinkops.com/reference/commands/revoke_invitation.md): Revoke an open invitation so its token can no longer be used.
- [Delete resource](https://docs.agentlinkops.com/reference/commands/delete_resource.md): Permanently remove an unused watch, target or project after preview_resource_deletion.
- [Remove member](https://docs.agentlinkops.com/reference/commands/remove_member.md): Remove a member from this workspace.
- [List discovery candidates](https://docs.agentlinkops.com/reference/commands/list_discovery_candidates.md): Read up to 100 candidates from an existing saved or imported run, including when new discovery admission is disabled.
- [List discovery runs](https://docs.agentlinkops.com/reference/commands/list_discovery_runs.md): Browse stored discovery runs newest first with optional project filtering and bounded cursor pagination.
- [Get discovery run](https://docs.agentlinkops.com/reference/commands/get_discovery_run.md): Read an existing saved or imported run, including when new discovery admission is disabled: status, query coverage and separate discovery usage.
- [Get domain overview](https://docs.agentlinkops.com/reference/commands/get_domain_overview.md): Requires an existing overview runId from a previously admitted request.
- [Import backlinks](https://docs.agentlinkops.com/reference/commands/import_backlinks.md): Store a backlink export the user already owns, from Ahrefs, Search Console, Semrush, Majestic, Moz, DataForSEO, Linkody or a generic CSV, as discovery candidates.
- [Request domain overview](https://docs.agentlinkops.com/reference/commands/request_domain_overview.md): Request a separately metered supplier summary for a domain or subdomain.
- [Discover backlinks](https://docs.agentlinkops.com/reference/commands/discover_backlinks.md): Query a configured owned corpus for bounded candidates with dated evidence.
- [Get candidate verification](https://docs.agentlinkops.com/reference/commands/get_candidate_verification.md): Read a selected candidate check, immutable job observation, source-check usage and local-reference lineage.
- [Get candidate verification batch](https://docs.agentlinkops.com/reference/commands/get_candidate_verification_batch.md): Read batch progress, individual job observations and reserved, consumed and released check units.
- [Monitor discovery candidate](https://docs.agentlinkops.com/reference/commands/monitor_discovery_candidate.md): Explicitly enroll the watch from a completed present candidate verification.
- [Verify discovery candidate](https://docs.agentlinkops.com/reference/commands/verify_discovery_candidate.md): Request an asynchronous check of one saved discovery candidate.
- [Verify discovery candidates](https://docs.agentlinkops.com/reference/commands/verify_discovery_candidates.md): Queue checks for 1 to 50 selected stored candidates under one workspace budget reservation.
- [List competitor inventories](https://docs.agentlinkops.com/reference/commands/list_competitor_inventories.md): List dated inventory summaries for one approved set revision.
- [List competitor inventory rows](https://docs.agentlinkops.com/reference/commands/list_competitor_inventory_rows.md): Requires an inventoryId from list_competitor_inventories; saved inventories remain readable when new admission is disabled.
- [List competitor sets](https://docs.agentlinkops.com/reference/commands/list_competitor_sets.md): List approved competitor sets in one accessible project, including retired sets.
- [Get competitor exclusions](https://docs.agentlinkops.com/reference/commands/get_competitor_exclusions.md): Read current or historical saved source exclusion rules for an accessible competitor set.
- [Get competitor gap report](https://docs.agentlinkops.com/reference/commands/get_competitor_gap_report.md): Compare selected frozen inventories by exact page or source host.
- [Get competitor refresh](https://docs.agentlinkops.com/reference/commands/get_competitor_refresh.md): Read a competitor refresh schedule and the latest cycle counts.
- [Get competitor set](https://docs.agentlinkops.com/reference/commands/get_competitor_set.md): Read an approved competitor revision; historical revisions stay immutable.
- [Get domain mix report](https://docs.agentlinkops.com/reference/commands/get_domain_mix_report.md): Requires a saved competitor set; frozen inventories are optional comparisons.
- [Create competitor set](https://docs.agentlinkops.com/reference/commands/create_competitor_set.md): Explicitly approve one customer and up to ten competitors.
- [Configure competitor refresh](https://docs.agentlinkops.com/reference/commands/configure_competitor_refresh.md): Schedule inventory lookups from the stored corpus for an approved competitor revision.
- [Request competitor inventory](https://docs.agentlinkops.com/reference/commands/request_competitor_inventory.md): Request an inventory lookup for one approved member and revision from the configured owned corpus.
- [Capture competitor inventory](https://docs.agentlinkops.com/reference/commands/capture_competitor_inventory.md): Freeze one terminal, previously bound discovery run into an immutable inventory.
- [Update competitor set](https://docs.agentlinkops.com/reference/commands/update_competitor_set.md): Approve a complete new member revision with optimistic concurrency.
- [Save competitor exclusions](https://docs.agentlinkops.com/reference/commands/save_competitor_exclusions.md): Save a complete replacement of up to 100 exact page/host exclusion rules with expectedRevision.
- [Set competitor refresh paused](https://docs.agentlinkops.com/reference/commands/set_competitor_refresh_paused.md): Pause or resume a competitor refresh schedule against the current approved revision.
- [Preview competitor exclusions](https://docs.agentlinkops.com/reference/commands/preview_competitor_exclusions.md): Dry-run exact source exclusion rules against selected frozen inventories.
- [Retire competitor set](https://docs.agentlinkops.com/reference/commands/retire_competitor_set.md): Retire a competitor set to stop new inventory requests; preserve approved revisions and dated evidence.
- [List check jobs](https://docs.agentlinkops.com/reference/commands/list_check_jobs.md): List source-link check jobs with optional project filtering and cursor pagination.
- [List link events](https://docs.agentlinkops.com/reference/commands/list_link_events.md): Read change events using an opaque cursor.
- [List link watches](https://docs.agentlinkops.com/reference/commands/list_link_watches.md): List monitored placements with compact state and attempt summaries.
- [Get check job](https://docs.agentlinkops.com/reference/commands/get_check_job.md): Read progress and usage reservation for an asynchronous source-link check job.
- [Get link evidence](https://docs.agentlinkops.com/reference/commands/get_link_evidence.md): Read the retained JSON snapshot for one source-link observation.
- [Get link history](https://docs.agentlinkops.com/reference/commands/get_link_history.md): List paginated saved observations for one monitored placement, including evidence references and retention limits.
- [Get link watch](https://docs.agentlinkops.com/reference/commands/get_link_watch.md): Inspect a monitored placement and its expectations.
- [Get public contacts](https://docs.agentlinkops.com/reference/commands/get_public_contacts.md): Extract explicitly published emails and contact-page candidates from the latest saved public HTML.
- [Monitor link](https://docs.agentlinkops.com/reference/commands/monitor_link.md): Monitor a known source page and target.
- [Import link watches](https://docs.agentlinkops.com/reference/commands/import_link_watches.md): Import up to 100 known backlinks.
- [Request link check](https://docs.agentlinkops.com/reference/commands/request_link_check.md): Queue metered verification.
- [Locate link](https://docs.agentlinkops.com/reference/commands/locate_link.md): Read link occurrences from one saved observation ID.
- [Update link watch](https://docs.agentlinkops.com/reference/commands/update_link_watch.md): Pause/resume a placement or update cadence and expectations.
- [List target events](https://docs.agentlinkops.com/reference/commands/list_target_events.md): Read the independent destination-health event feed.
- [List targets](https://docs.agentlinkops.com/reference/commands/list_targets.md): List explicitly monitored destination URLs.
- [Get target](https://docs.agentlinkops.com/reference/commands/get_target.md): Read a destination health watch and its current evidence state.
- [Get target evidence](https://docs.agentlinkops.com/reference/commands/get_target_evidence.md): Read the retained JSON snapshot for one destination observation.
- [Get target history](https://docs.agentlinkops.com/reference/commands/get_target_history.md): List paginated saved destination-health observations, independently of source-link presence.
- [Get target job](https://docs.agentlinkops.com/reference/commands/get_target_job.md): Read progress and usage reservation for an asynchronous destination-health check job.
- [Get target placements](https://docs.agentlinkops.com/reference/commands/get_target_placements.md): List placements whose configured target URL exactly matches this destination.
- [Monitor target](https://docs.agentlinkops.com/reference/commands/monitor_target.md): Register an exact public destination URL for recurring health checks.
- [Request target check](https://docs.agentlinkops.com/reference/commands/request_target_check.md): Queue a metered destination health check.
- [Update target](https://docs.agentlinkops.com/reference/commands/update_target.md): Pause/resume a destination check or change its cadence.
- [Get anchor report](https://docs.agentlinkops.com/reference/commands/get_anchor_report.md): Analyze exact anchors and Unicode terms from saved successful observations.
- [Get link profile](https://docs.agentlinkops.com/reference/commands/get_link_profile.md): Summarize monitored placements, source hosts, destinations and observed rel attributes.
- [Get link reports](https://docs.agentlinkops.com/reference/commands/get_link_reports.md): Read profile and anchor reports from one saved dataset snapshot.
- [Export link watches](https://docs.agentlinkops.com/reference/commands/export_link_watches.md): Export monitored placements with pagination for local CRM recovery.
- [List webhook deliveries](https://docs.agentlinkops.com/reference/commands/list_webhook_deliveries.md): Read recent delivery attempts for one endpoint: state, attempt count, last HTTP status and error.
- [List webhooks](https://docs.agentlinkops.com/reference/commands/list_webhooks.md): List this workspace's webhook endpoints with their state, subscribed feeds and types, consecutive failure count and why any was disabled.
- [Create webhook](https://docs.agentlinkops.com/reference/commands/create_webhook.md): Subscribe an HTTPS receiver to source or destination events, or periodic digests.
- [Set webhook state](https://docs.agentlinkops.com/reference/commands/set_webhook_state.md): Activate or disable one endpoint.
- [Rotate webhook secret](https://docs.agentlinkops.com/reference/commands/rotate_webhook_secret.md): Add a second active signing secret, or retire the older one.
- [Delete webhook](https://docs.agentlinkops.com/reference/commands/delete_webhook.md): Delete one webhook endpoint and its delivery configuration.
- [Check a link for free](https://docs.agentlinkops.com/reference/commands/verify_link_free.md): One free placement check with evidence and honest uncertainty.
- [Local CLI reference](https://docs.agentlinkops.com/reference/local.md): Every local CLI command, its inputs, file effects and exit status.
- [CLI configuration and files](https://docs.agentlinkops.com/reference/local/configuration.md): Configure the ledger, environment credentials, output formats and local file ownership.
- [Local file contracts](https://docs.agentlinkops.com/reference/local/artifacts.md): Ledger rows, portable checks, observation mirrors and action receipt inputs.
- [linktrail help](https://docs.agentlinkops.com/reference/local/help.md): Print the command summary.
- [linktrail setup](https://docs.agentlinkops.com/reference/local/setup.md): Print a read-only setup plan for a selected task.
- [linktrail init](https://docs.agentlinkops.com/reference/local/init.md): Create a ledger in the current directory.
- [linktrail add](https://docs.agentlinkops.com/reference/local/add.md): Add a placement intention to the ledger.
- [linktrail import](https://docs.agentlinkops.com/reference/local/import.md): Preview a supplier or CSV import.
- [linktrail adopt](https://docs.agentlinkops.com/reference/local/adopt.md): Preview conversion of the local SQLite CRM.
- [linktrail adopt-result](https://docs.agentlinkops.com/reference/local/adopt-result.md): Save a prior single-check result to the ledger.
- [linktrail check](https://docs.agentlinkops.com/reference/local/check.md): Check due ledger entries.
- [Check one page](https://docs.agentlinkops.com/reference/local/check-single.md): Check one supplied page without a ledger.
- [linktrail status](https://docs.agentlinkops.com/reference/local/status.md): Compare local intentions with recorded observations.
- [linktrail diff](https://docs.agentlinkops.com/reference/local/diff.md): Read recorded observation transitions.
- [linktrail fmt](https://docs.agentlinkops.com/reference/local/fmt.md): Format the ledger consistently.
- [linktrail compact](https://docs.agentlinkops.com/reference/local/compact.md): Preview repeated-observation compaction.
- [linktrail report](https://docs.agentlinkops.com/reference/local/report.md): Render a local HTML backlink report.
- [linktrail fleet](https://docs.agentlinkops.com/reference/local/fleet.md): Read multiple explicitly named ledgers.
- [linktrail platforms](https://docs.agentlinkops.com/reference/local/platforms.md): Summarize observed platform behavior.
- [linktrail mix](https://docs.agentlinkops.com/reference/local/mix.md): Report referring-domain mix from the current ledger.
- [linktrail doctor](https://docs.agentlinkops.com/reference/local/doctor.md): Check the local install and configured cloud connection.
- [linktrail connect](https://docs.agentlinkops.com/reference/local/connect.md): Verify and save a cloud connection.
- [linktrail tools](https://docs.agentlinkops.com/reference/local/tools.md): Read the authenticated cloud command catalog.
- [linktrail call](https://docs.agentlinkops.com/reference/local/call.md): Run a named cloud operation.
- [linktrail sync](https://docs.agentlinkops.com/reference/local/sync.md): Push selected intentions and pull cloud history.
- [linktrail receive](https://docs.agentlinkops.com/reference/local/receive.md): Use a signed event notification to trigger authenticated pull.
- [linktrail receipt add](https://docs.agentlinkops.com/reference/local/receipt-add.md): Record a local action claim.
- [linktrail receipt history](https://docs.agentlinkops.com/reference/local/receipt-history.md): Read claims alongside local verification history.
- [linktrail context status](https://docs.agentlinkops.com/reference/local/context-status.md): Read context connection and file status.
- [linktrail context manual](https://docs.agentlinkops.com/reference/local/context-manual.md): Read the editable manual context.
- [linktrail context focus](https://docs.agentlinkops.com/reference/local/context-focus.md): Select focus pages from local context.
- [linktrail context gsc refresh](https://docs.agentlinkops.com/reference/local/context-gsc-refresh.md): Refresh search context from Google.
- [linktrail context gsc page](https://docs.agentlinkops.com/reference/local/context-gsc-page.md): Read search context for a supplied page.
- [linktrail context gsc import](https://docs.agentlinkops.com/reference/local/context-gsc-import.md): Import a GSC connector handoff.
- [linktrail context gsc forget](https://docs.agentlinkops.com/reference/local/context-gsc-forget.md): Remove tool-owned context.
- [linktrail context profile build](https://docs.agentlinkops.com/reference/local/context-profile-build.md): Collect bounded public site facts.
- [linktrail context profile render](https://docs.agentlinkops.com/reference/local/context-profile-render.md): Write an editable site profile from collected facts.
- [linktrail context profile check](https://docs.agentlinkops.com/reference/local/context-profile-check.md): Check citations in the local site profile.
- [linktrail context ga4 refresh](https://docs.agentlinkops.com/reference/local/context-ga4-refresh.md): Refresh optional GA4 context.
- [linktrail context ga4 page](https://docs.agentlinkops.com/reference/local/context-ga4-page.md): Read local landing-page business context.
- [linktrail context ga4 key-events](https://docs.agentlinkops.com/reference/local/context-ga4-key-events.md): Read configured GA4 event totals.
- [linktrail context ga4 import](https://docs.agentlinkops.com/reference/local/context-ga4-import.md): Import a GA4 connector handoff.
- [linktrail context ga4 forget](https://docs.agentlinkops.com/reference/local/context-ga4-forget.md): Remove tool-owned GA4 context.
- [linktrail context business](https://docs.agentlinkops.com/reference/local/context-business.md): Read search and business context side by side.
- [linktrail context help](https://docs.agentlinkops.com/reference/local/context-help.md): Print the context subcommand summary.
- [Local context result conventions](https://docs.agentlinkops.com/reference/context/results.md): Read repository context results, keep manual judgments separate from saved facts, and handle partial refreshes, missing files and unresolved citations.
- [context status](https://docs.agentlinkops.com/reference/context/context_status.md): Read this repository's first-party context state: connection grant state (booleans, property names, permission levels and dates only ,  never a token), GSC fact-row count, site-fact count, availability floors and manual-input presence.
- [context manual](https://docs.agentlinkops.com/reference/context/context_manual.md): Read the human/agent-owned manual inputs (target pages, site or niche description, offering, known assets, competitors) that form the no-Google floor of the context.
- [context focus](https://docs.agentlinkops.com/reference/context/context_focus.md): Choose focus pages from manual targets first, then GSC clicks.
- [context gsc page](https://docs.agentlinkops.com/reference/context/context_gsc_page.md): Read page/query context for one supplied page entirely from repository fact rows ,  no Google connection is consulted and no query is spent; a connector handoff with no grant from us at all is a complete configuration.
- [context gsc refresh](https://docs.agentlinkops.com/reference/context/context_gsc_refresh.md): Refresh GSC rows with read-only webmasters.readonly access.
- [context gsc import](https://docs.agentlinkops.com/reference/context/context_gsc_import.md): Import an existing-agent handoff snapshot (JSON lines or a Markdown table) in the gsc.jsonl row shape, instead of granting anything.
- [context profile build](https://docs.agentlinkops.com/reference/context/context_profile_build.md): Build the bounded public site-profile facts: robots.txt, at most 3 sitemap documents and at most 10 selected pages per run, fetched on the verifier's public fetch boundary with the CLI's courtesy pacing, with every limit the run hit reported as a count.
- [context profile check](https://docs.agentlinkops.com/reference/context/context_profile_check.md): Check that every [fact:…] and [manual:…] citation in the human/agent-owned site-profile.md resolves to a fact row or manual entry.
- [HTTP conventions](https://docs.agentlinkops.com/reference/http/conventions.md): Authentication, errors, pagination, retries and asynchronous command behavior.
- [HTTP route index](https://docs.agentlinkops.com/reference/http/routes.md): Method, path and shared operation mappings for every authenticated resource route.
- [Human account access](https://docs.agentlinkops.com/reference/http/account-access.md): Workspace creation, invitation acceptance and credential administration use human authentication.
- [Protocol and account boundaries](https://docs.agentlinkops.com/reference/http/protocol.md): MCP transports, anonymous checks, OAuth discovery, human consent and non-product endpoints.
- [Webhook events and delivery](https://docs.agentlinkops.com/reference/webhooks.md): Signed event, digest and retention-gap payloads with retry and recovery behavior.

## Changelog

- [Documentation changelog](https://docs.agentlinkops.com/changelog.md): Track changes to the documentation structure and distinguish documentation updates from locally implemented product capabilities and hosted releases.

## Machine contracts

- [Command catalog](https://docs.agentlinkops.com/commands.json)
- [HTTP OpenAPI](https://docs.agentlinkops.com/openapi.json)
- [Notification schemas](https://docs.agentlinkops.com/events.json)
- [Release availability](https://docs.agentlinkops.com/release.json)