Tool reference
Tool reference
Every tool the Composway MCP server exposes - 48 in total, generated from the running server's own registry.
The Composway MCP server exposes 48 tools. This page is generated
from the server's own tool registry, so it always matches what a connected client
discovers via tools/list. Current tools schema version: 2026-09-02.5.
Reads or writes is the tool's own annotation, and it is what decides when you get interrupted: a read runs without asking, while a write is prompted by your client and then confirmed again by the server, describing exactly what is about to change. Cost is a separate question - nearly everything here is free, and the few tools that spend money or draw on a plan quota say so on their own page too.
Diagnostics
Server freshness, schema versioning and identity. Call get_server_status at the start of a session.
| Tool | What it does | Reads or writes | Cost |
|---|---|---|---|
get_server_status | Start here. | Read | Free |
get_server_info | Return Composway MCP server freshness metadata: server version, tools schema version, git/deploy metadata, and Worker version metadata when available. | Read | Free |
get_tool_manifest | 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. | Read | Free |
Workspaces & campaigns
Read the workspaces, campaigns, entities and article drafts the rest of the surface operates on.
| Tool | What it does | Reads or writes | Cost |
|---|---|---|---|
search_reference | Resolve a human-readable location or language name into the DataForSEO reference object ({ id, code, isoCode, name }) required by campaign/workspace writes. | Read | Free |
whoami | Return the authenticated user's Kinde claims (sub, email, name). | Read | Free |
list_workspaces | List the current user's workspaces (id, title). | Read | Free |
get_workspace | Get a single workspace with its target audiences, products, default location and language, and its campaigns. | Read | Free |
get_workspace_competitors | The brands this workspace measures itself against in AI answers: the tracked competitors plus, for reference, the workspace's own brand (selfBrand, `isSelf:… | Read | Free |
list_campaigns | List the AEO/AI campaigns in a workspace. | Read | Free |
get_campaign | Get an AEO campaign's detail: SERP snapshot, analysis, brief, and search-intent-classification ids. | Read | Free |
get_campaign_related_questions | Get a campaign's related questions and the discovered pain points. | Read | Free |
get_campaign_entities | Get the extracted entity list for a campaign. | Read | Free |
get_latest_article | Get the latest user-generated content (article draft + meta tags) for a campaign - the input for evaluate_article, optimize_article, and quick_save. | Read | Free |
deep_research | Perform deep research on how people ask on a related topic. | Read | Free |
get_evaluation_result | Poll an evaluate_article or optimize_article background job by its jobId. | Read | Free |
get_task_status | Poll the status of a long-running analysis task by the domain record it is linked to (e.g. | Read | Free |
Search analytics
Search Console and Bing Webmaster Tools reads: performance, keyword discovery, decay, gaps and reporting.
| Tool | What it does | Reads or writes | Cost |
|---|---|---|---|
list_sites | Live: lists every Google Search Console property and Bing Webmaster Tools site visible to the caller's connected accounts, tagged with searchEngine, and joined… | Read | Free |
get_connection_status | Live: connected Google + Bing accounts, the property/site attached to this site's workspace, and the last time its search data synced. | Read | Free |
get_site_snapshot | Summarizes a site's overall Google + Bing search performance over a window and compares it with the immediately preceding window of the same length. | Read | Free |
get_performance_trend | Daily, weekly, or monthly Google + Bing performance trend for a site. | Read | Free |
find_new_and_lost_keywords | Query-level /breakdown rows classified per engine as new, lost, improved, declined, or stable between the current window and the immediately preceding one of… | Read | Free |
find_cross_engine_gaps | Queries or pages where Google and Bing performance diverge materially in the current window. | Read | Free |
find_low_hanging_keywords | 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… | Read | Free |
find_ctr_opportunities | Queries or pages whose actual CTR falls well below what the site's own position-based CTR curve predicts for their rank. | Read | Free |
find_content_gaps | Two halves under one name, labelled per row. | Read - confirmed when paid | Paid (opt-in) |
get_page_queries | The queries a specific page drew impressions and clicks for, per engine, over the window. | Read | Free |
get_query_pages | The pages of the site that surfaced for a specific query, per engine, over the window. | Read | Free |
detect_keyword_cannibalization | Queries more than one of the site's own pages competes for, read from two sources. | Read | Free |
find_content_decay | 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. | Read | Free |
find_emerging_keywords | Queries with sustained or accelerating growth over several whole periods - find_content_decay's classifier with the sign flipped. | Read | Free |
diagnose_traffic_losses | 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. | Read | Free |
analyze_site_sections | Aggregates Google + Bing page performance into URL directories (the leading sectionDepth path segments) and compares each section's current total against the… | Read | Free |
analyze_branded_vs_nonbranded | 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 t… | Read | Free |
get_workspace_brand_terms | The brand terms a workspace matches queries and AI answers against: brandTerms is the effective list (title plus confirmed aliases) and is what analyze_brand… | Read | Free |
score_seo_opportunities | One prioritized queue over four tools that each answer a different question: find_low_hanging_keywords, find_ctr_opportunities, find_content_decay and find_con… | Read | Free |
generate_search_performance_report | 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… | Read | Free |
get_advanced_search_analytics | The composable read: you choose the grouping, filters, sort and limit instead of asking one of the named questions above. | Read | Free |
Writes
Everything that creates or changes data. Every tool here asks a human to confirm before it runs.
| Tool | What it does | Reads or writes | Cost |
|---|---|---|---|
create_workspace | Create a new workspace. | Write - confirmed | Quota |
create_ai_campaign | Create an AEO (AI) campaign in a workspace from one or more target prompts. | Write - confirmed | Quota |
confirm_search_intent | Confirm the chosen search-intent classification for a campaign. | Write - confirmed | Free |
confirm_pain_points | Confirm the campaign background: the selected pain points, target audiences, and search-intent ids. | Write - confirmed | Free |
attach_target_ai_prompt | Attach a new target AI prompt (topic + location + language + LLM providers) to a campaign. | Write - confirmed | Free |
evaluate_article | Start an asynchronous evaluation job for an article in a campaign. | Write - confirmed | Free |
optimize_article | Start an asynchronous optimization job for an article in a campaign. | Write - confirmed | Free |
quick_save | Save an article draft (and meta tags) to a specific user-generated-content version of a campaign. | Write - confirmed | Free |
set_workspace_brand_terms | Add, remove, or replace a workspace's confirmed brand aliases. | Write - confirmed | Free |
set_workspace_competitors | Add, edit, or stop tracking the competitors a workspace is measured against in AI answers. | Write - confirmed | Free |
explain_query_serp | Fetch this query's Google SERP live and diff it against the newest SERP stored for this workspace. | Write - confirmed | Paid |