Find the right tool

Start here.

Return Composway MCP server freshness metadata: server version, tools schema version, git/deploy metadata, and Worker version metadata when available.

Return the canonical tool manifest for this running MCP server, including the tools schema version and a SHA-256 hash of each tool input schema.

Resolve a human-readable location or language name into the DataForSEO reference object ({ id, code, isoCode, name }) required by campaign/workspace writes.

Return the authenticated user's Kinde claims (sub, email, name).

List the current user's workspaces (id, title).

Get a single workspace with its target audiences, products, default location and language, and its campaigns.

The brands this workspace measures itself against in AI answers: the tracked competitors plus, for reference, the workspace's own brand (`selfBrand`, `isSelf: true`).

List the AEO/AI campaigns in a workspace.

Get an AEO campaign's detail: SERP snapshot, analysis, brief, and search-intent-classification ids.

Get a campaign's related questions and the discovered pain points.

Get the extracted entity list for a campaign.

Get the latest user-generated content (article draft + meta tags) for a campaign — the input for evaluate_article, optimize_article, and quick_save.

Perform deep research on how people ask on a related topic.

Poll an evaluate_article or optimize_article background job by its jobId.

Poll the status of a long-running analysis task by the domain record it is linked to (e.g.

Live: lists every Google Search Console property and Bing Webmaster Tools site visible to the caller's connected accounts, tagged with searchEngine, and joined to the workspace each is already attach…

Live: connected Google + Bing accounts, the property/site attached to this site's workspace, and the last time its search data synced.

Summarizes a site's overall Google + Bing search performance over a window and compares it with the immediately preceding window of the same length.

Daily, weekly, or monthly Google + Bing performance trend for a site.

Query-level `/breakdown` rows classified per engine as new, lost, improved, declined, or stable between the current window and the immediately preceding one of the same length.

Queries or pages where Google and Bing performance diverge materially in the current window.

High-impression queries ranking just off page one, with an estimated click uplift if promoted to the site's own page-one (`pos1_3`) CTR — built from the site's own current-window rows, not an industr…

Queries or pages whose actual CTR falls well below what the site's own position-based CTR curve predicts for their rank.

Two halves under one name, labelled per row.

The queries a specific page drew impressions and clicks for, per engine, over the window.

The pages of the site that surfaced for a specific query, per engine, over the window.

Queries more than one of the site's own pages competes for, read from two sources.

Pages or queries in *sustained* decline across several whole periods — not a window-over-window drop, which cannot tell a decline from a bad month.

Queries with sustained or accelerating growth over several whole periods — find_content_decay's classifier with the sign flipped.

For the queries that lost the most clicks, says *why* — and each cause implies a different action, so the class matters more than the number.

Aggregates Google + Bing page performance into URL directories (the leading `sectionDepth` path segments) and compares each section's current total against the immediately preceding period.

Splits the window's Google + Bing queries into branded and non-branded demand and reports each side's clicks, impressions, CTR, average position and share of the engine's total.

The brand terms a workspace matches queries and AI answers against: `brandTerms` is the effective list (title plus confirmed aliases) and is what analyze_branded_vs_nonbranded and find_low_hanging_ke…

One prioritized queue over four tools that each answer a different question: find_low_hanging_keywords, find_ctr_opportunities, find_content_decay and find_content_gaps.

A Google + Bing performance report for one site or several, assembled by calling the other tools and embedding their responses whole — so a section here is the same answer the tool gives on its own,…

The composable read: you choose the grouping, filters, sort and limit instead of asking one of the named questions above.

Create a new workspace.

Create an AEO (AI) campaign in a workspace from one or more target prompts.

Confirm the chosen search-intent classification for a campaign.

Confirm the campaign background: the selected pain points, target audiences, and search-intent ids.

Attach a new target AI prompt (topic + location + language + LLM providers) to a campaign.

Start an asynchronous evaluation job for an article in a campaign.

Start an asynchronous optimization job for an article in a campaign.

Save an article draft (and meta tags) to a specific user-generated-content version of a campaign.

Add, remove, or replace a workspace's confirmed brand aliases.

Add, edit, or stop tracking the competitors a workspace is measured against in AI answers.

Fetch this query's Google SERP **live** and diff it against the newest SERP stored for this workspace.