Tools

Most tools are read-only. A set of write tools can also modify your project's configuration — these require an API key with the mcp:write scope (see Write tools below). Your assistant picks the right tool from your question — this reference tells you what's available and how each tool behaves.

Project selection

Every tool except list-projects takes an optional projectId:

list-projects

Lists the projects your connection can access, with their IDs and names. The assistant calls this first when it doesn't know which project ID to use. No parameters.

Analytics tools

All analytics tools share these parameters on top of projectId:

Tools marked paged additionally accept:

fetch-brand-rankings

Fetches AI visibility brand rankings within a time range — visibility, source presence, mentions, responses, and share of voice per brand, for your own brand and competitors. Paged, default limit 20.

fetch-share-of-voice

Fetches the share of voice breakdown showing your brand versus competitors within a time range.

fetch-performance-breakdown

Fetches your brand's AI visibility performance grouped by a dimension.

fetch-prompt-analytics

Fetches per-prompt performance analytics for your own brand within a time range. Paused prompts are excluded.

fetch-brand-perception

Fetches brand perception analytics — how brands are described in AI answers (e.g. reliable, innovative, affordable).

fetch-sentiment

Fetches own-brand sentiment analytics from Perception > Sentiment, including positive, neutral, and negative shares plus a breakdown by model or another dimension.

fetch-sentiment-sources

Fetches source pages for a selected sentiment bucket from Perception > Sentiment > Sources. Paged, default limit 20.

fetch-perception-sources

Fetches source pages for a selected brand-perception attribute from Perception > Attributes > Sources. Use fetch-brand-perception first to discover available attribute names. Paged, default limit 20.

fetch-top-domains

Fetches the top cited source domains with presence, brand mentions, category, and model coverage within a time range. Paged, default limit 20, sorted by response count descending.

fetch-source-urls

Fetches individual source URLs with citation analytics within a time range. Paged, default limit 50.

fetch-cited-pages

Alias of fetch-source-urls for cited-page/source-URL analytics — same parameters. Paged, default limit 50.

Backlink tools

Read the project's backlink profile: links, referring domains, and the competitor link gap. Backlink data comes from scheduled or manual scans — if a project has never completed one, fetch-backlink-overview returns neverSynced: true and the list tools return nothing.

fetch-backlink-overview

Fetches the backlink profile summary: sync status (last sync, cooldown, warnings) plus KPIs — domain rank, backlinks, referring domains, AI-cited domains, and new/lost counts. Takes only projectId.

fetch-backlink-timeseries

Fetches the backlink profile history: one snapshot per sync with rank, backlinks, referring domains, AI-cited domains, and new/lost counts.

fetch-backlinks

Lists individual backlinks (referring page → target URL) with anchor, referring-domain rank, dofollow flag, and the AI signal on the referring domain. Paged, default page size 20.

Each row carries citedInAiAnswers (the referring domain was named outright as a source) and appearedAsAiSource (it fed an AI answer at all). The second includes the first — it is the wider signal, not the uncited remainder. The response's totalMatchingFilters counts the rows matching the filters you passed, not the size of the whole profile.

fetch-backlink-domains

Lists referring domains with their rank, backlink and dofollow counts, and their AI signal. Takes the same filters as fetch-backlinks, except sortBy is rank | backlinksCount | firstSeenAt (default rank). Paged, default page size 20.

Each row carries citedInAiAnswersCount (AI answers that named the domain outright) and appearedAsAiSourceCount (AI answers it fed at all). The second already includes the first. As above, totalMatchingFilters is scoped to the filters you passed — do not report it as the project's referring-domain total.

fetch-backlink-gap

Lists domains that link to the tracked competitors but not to this project — link-building prospects, sorted by how many competitors they link to. Paged, default page size 20.

Configuration tools

These take only projectId and return the project's setup:

fetch-brand-details

Fetches your own brand's details.

fetch-competitors

Fetches the competitors tracked in the project.

fetch-prompts

Fetches the prompts configured for monitoring.

fetch-personas

Fetches the configured personas.

fetch-offerings

Fetches the configured offerings/products.

fetch-monitor-settings

Fetches the monitoring settings: run frequency and which AI models are tracked.

Action planner tools

fetch-campaigns

Fetches campaigns for a project.

fetch-actions

Fetches actions with optional filters.

Content pieces

Read content pieces and their per-step outputs. These tools are designed for progressive disclosure — list pieces first, inspect one piece's steps, then read a single step's output — so your assistant pulls only what it needs instead of loading whole documents.

fetch-content-pieces

Lists content pieces as compact one-line summaries (id, status, title, format, current step). No step bodies are returned.

fetch-content-piece

Returns one piece's header and a per-step table (label, kind, human-input policy, current revision, quality/brandkit/factcheck outcomes, size). Metadata only — no step bodies.

read-content-piece-step

Reads a single step's output, rendered to markdown (doc/markdown steps) or pretty JSON (json steps) and length-capped. Image steps have no readable artifact.

Write tools

These tools modify your project's configuration and mirror the write capabilities of the in-app Project Manager Agent. They apply changes immediately — your AI assistant is the approval surface, so review proposed changes before confirming.

Each write tool takes the optional projectId parameter described above. The bulk-apply-* tools accept an operations array so you can create, update, and delete several items in a single call:

Each call returns a summary with per-operation results (succeeded, failed, total, and a results array), so a failure on one item does not abort the rest of the batch.

update-brand-details

Updates your own brand's details. All fields optional: name, description, website, aliases (string[]), domainAliases (string[]).

bulk-apply-competitors

Creates / updates / deletes tracked competitors. Create fields: name, website (URL), optional description. Update fields: _id plus any of name, website, description.

bulk-apply-offerings

Creates / updates / deletes offerings (products/services). Create fields: name, optional description. Update fields: _id plus any of name, description.

bulk-apply-personas

Creates / updates / deletes personas. Create fields: name, description. Update fields: _id plus any of name, description.

bulk-apply-prompt-tags

Creates / updates / deletes prompt tags. Create fields: name, color. Update fields: _id plus any of name, color.

bulk-apply-prompts

Creates / updates / deletes (archives) prompts. Create fields: text, language, country, and optional tagIds, personaId, offeringId, topicId. Update fields: _id plus any of language, type, isPaused, tagIds, personaId, offeringId, topicId (pass null to clear a link). A delete operation archives the prompt.

add-manual-backlink

Registers a backlink you know about but the provider's index is missing. The target URL must be a page on this project's own site and the referring page must be on another site. Free — it makes no third-party call and does not count against your scan allowance.

trigger-backlink-sync

Starts a manual backlink scan.

Call it without confirm first: that returns the current sync status (target domain, last scan time, cooldown, any warnings) without starting anything. Show that to the user, and call again with confirm: true only after they explicitly approve.