MCP server
Tool reference
Every tool the AEOMCP MCP server exposes to an authenticated caller, with the permission tier and scope each one requires.
Tiers: 0 meta, 1 read, 2 configuration write, 3 billable, 4 external communication, 5 destructive, 6 staff. A tool marked planned is declared with a frozen name but not yet available.
Generated from the tool catalog by scripts/mcp-tools-doc.mjs; it always matches the running registry.
| Tool | Group | Tier | Scope | Status |
|---|---|---|---|---|
describe_capabilities | meta | 0 (meta) | — | implemented |
search_docs | meta | 0 (meta) | — | implemented |
read_doc | meta | 0 (meta) | — | implemented |
request_approval | meta | 0 (meta) | — | implemented |
get_account_context | account | 0 (meta) | org:read | implemented |
get_plan_and_usage | account | 1 (read) | usage:read | implemented |
forecast_capacity | account | 1 (read) | usage:read | implemented |
list_usage_events | account | 1 (read) | usage:read | implemented |
create_upgrade_link | account | 4 (external communication) | billing:manage | implemented |
get_onboarding_status | account | 1 (read) | org:read | implemented |
list_workspaces | workspace | 0 (meta) | workspace:read | implemented |
get_workspace | workspace | 1 (read) | workspace:read | implemented |
create_client_workspace | workspace | 2 (configuration write) | workspace:write | planned |
update_workspace | workspace | 2 (configuration write) | workspace:write | implemented |
archive_workspace | workspace | 5 (destructive) | workspace:archive | planned |
restore_workspace | workspace | 2 (configuration write) | workspace:write | planned |
bulk_create_client_workspaces | workspace | 2 (configuration write) | workspace:write | planned |
clone_workspace_template | workspace | 2 (configuration write) | workspace:write | planned |
allocate_workspace_capacity | workspace | 2 (configuration write) | workspace:write | implemented |
get_portfolio_summary | workspace | 1 (read) | org:read | implemented |
get_clients_needing_attention | workspace | 1 (read) | org:read | implemented |
get_clients_with_visibility_decline | workspace | 1 (read) | org:read | implemented |
get_clients_with_run_failures | workspace | 1 (read) | org:read | implemented |
get_pull_status_matrix | workspace | 1 (read) | org:read | implemented |
get_reports_awaiting_approval | workspace | 1 (read) | report:read | planned |
onboard_brand | brand | 2 (configuration write) | brand:write | implemented |
validate_brand_setup | brand | 1 (read) | brand:read | implemented |
get_brand_profile | brand | 1 (read) | brand:read | implemented |
update_brand_profile | brand | 2 (configuration write) | brand:write | implemented |
add_competitor | brand | 2 (configuration write) | brand:write | planned |
remove_competitor | brand | 2 (configuration write) | brand:write | planned |
bulk_onboard_brands | brand | 2 (configuration write) | brand:write | planned |
create_prospect_audit | brand | 3 (billable) | brand:write | planned |
convert_prospect_audit_to_workspace | brand | 2 (configuration write) | workspace:write | planned |
create_prospect_report | brand | 3 (billable) | brand:write | beta — available when prospect reports are enabled for your account |
list_prospect_reports | brand | 1 (read) | workspace:read | beta — available when prospect reports are enabled for your account |
get_prospect_report | brand | 1 (read) | report:read | beta — available when prospect reports are enabled for your account |
get_prospect_deck | brand | 1 (read) | report:read | beta — available when prospect reports are enabled for your account |
get_brand_kit | brand | 1 (read) | brand:read | beta — available when prospect reports are enabled for your account |
get_brand_asset | brand | 1 (read) | brand:read | beta — available when prospect reports are enabled for your account |
get_agency_brand_kit | brand | 1 (read) | brand:read | beta — available when prospect reports are enabled for your account |
convert_prospect_to_client | brand | 2 (configuration write) | workspace:write | beta — available when prospect reports are enabled for your account |
add_competitors | brand | 2 (configuration write) | brand:write | implemented |
remove_competitors | brand | 5 (destructive) | brand:write | implemented |
update_brands | brand | 2 (configuration write) | brand:write | implemented |
list_prompt_sets | prompt | 1 (read) | prompt:read | planned |
get_prompt_set | prompt | 1 (read) | prompt:read | planned |
create_prompt_set | prompt | 2 (configuration write) | prompt:write | planned |
update_prompt_set | prompt | 2 (configuration write) | prompt:write | planned |
archive_prompt_set | prompt | 2 (configuration write) | prompt:write | planned |
generate_buyer_questions | prompt | 3 (billable) | prompt:write | implemented |
import_prompts | prompt | 2 (configuration write) | prompt:write | implemented |
export_prompts | prompt | 1 (read) | prompt:read | implemented |
validate_prompts | prompt | 1 (read) | prompt:read | implemented |
deduplicate_prompts | prompt | 2 (configuration write) | prompt:write | implemented |
tag_prompts | prompt | 2 (configuration write) | prompt:write | implemented |
apply_prompt_template | prompt | 2 (configuration write) | prompt:write | planned |
set_weekly_schedule | prompt | 2 (configuration write) | prompt:write | implemented |
list_daily_watchlist | prompt | 1 (read) | prompt:read | implemented |
add_to_daily_watchlist | prompt | 2 (configuration write) | prompt:write | implemented |
remove_from_daily_watchlist | prompt | 2 (configuration write) | prompt:write | implemented |
reorder_daily_watchlist | prompt | 2 (configuration write) | prompt:write | planned |
archive_prompts | prompt | 2 (configuration write) | prompt:write | implemented |
unarchive_prompts | prompt | 2 (configuration write) | prompt:write | implemented |
delete_prompts | prompt | 5 (destructive) | prompt:write | implemented |
update_prompts | prompt | 2 (configuration write) | prompt:write | implemented |
list_prompt_candidates | prompt | 1 (read) | prompt:read | implemented |
update_prompt_candidates | prompt | 2 (configuration write) | prompt:write | implemented |
finalize_prompt_candidates | prompt | 5 (destructive) | prompt:write | implemented |
generate_topics | prompt | 2 (configuration write) | prompt:write | implemented |
list_topics | prompt | 1 (read) | prompt:read | implemented |
get_discovery_status | prompt | 1 (read) | prompt:read | implemented |
link_prompt_keyword | prompt | 2 (configuration write) | prompt:write | implemented |
discover_keywords | prompt | 3 (billable) | prompt:write | implemented |
get_keyword_volumes | prompt | 3 (billable) | prompt:write | implemented |
expand_topics | prompt | 3 (billable) | prompt:write | implemented |
create_topics | prompt | 2 (configuration write) | prompt:write | implemented |
update_topics | prompt | 2 (configuration write) | prompt:write | implemented |
delete_topics | prompt | 5 (destructive) | prompt:write | implemented |
list_tags | prompt | 1 (read) | prompt:read | implemented |
list_tag_groups | prompt | 1 (read) | prompt:read | implemented |
create_tags | prompt | 2 (configuration write) | prompt:write | implemented |
update_tags | prompt | 2 (configuration write) | prompt:write | implemented |
delete_tags | prompt | 5 (destructive) | prompt:write | implemented |
update_tag_groups | prompt | 2 (configuration write) | prompt:write | implemented |
delete_tag_groups | prompt | 5 (destructive) | prompt:write | implemented |
run_question_now | run | 3 (billable) | run:execute | implemented |
run_prompt_set_now | run | 3 (billable) | run:execute | planned |
estimate_run_cost | run | 1 (read) | run:read | implemented |
get_run | run | 1 (read) | run:read | implemented |
list_runs | run | 1 (read) | run:read | implemented |
cancel_run | run | 5 (destructive) | run:cancel | implemented |
retry_failed_executions | run | 3 (billable) | run:execute | implemented |
get_engine_health | run | 1 (read) | run:read | implemented |
get_collection_status | run | 1 (read) | run:read | implemented |
list_engines | run | 1 (read) | workspace:read | implemented |
search_answers | answer | 1 (read) | answer:read | implemented |
get_answer | answer | 1 (read) | answer:read | implemented |
get_answer_evidence | answer | 1 (read) | evidence:read | planned |
compare_engine_answers | answer | 1 (read) | answer:read | implemented |
compare_date_ranges | answer | 1 (read) | answer:read | implemented |
get_visibility_summary | answer | 1 (read) | answer:read | implemented |
get_share_of_voice | answer | 1 (read) | answer:read | implemented |
get_brand_mentions | answer | 1 (read) | answer:read | implemented |
get_competitor_mentions | answer | 1 (read) | answer:read | implemented |
get_visibility_trends | answer | 1 (read) | answer:read | implemented |
get_prompt_volatility | answer | 1 (read) | answer:read | implemented |
list_citations | answer | 1 (read) | answer:read | implemented |
find_citation_gaps | answer | 1 (read) | answer:read | implemented |
find_source_opportunities | answer | 1 (read) | answer:read | implemented |
detect_claim_mismatches | answer | 1 (read) | answer:read | planned |
detect_hallucinations | answer | 1 (read) | answer:read | planned |
explain_visibility_change | answer | 1 (read) | answer:read | planned |
recommend_next_actions | answer | 1 (read) | answer:read | implemented |
get_report | answer | 1 (read) | answer:read | implemented |
get_answers_report | answer | 1 (read) | answer:read | implemented |
get_source_content | answer | 1 (read) | answer:read | implemented |
list_source_classifications | answer | 1 (read) | answer:read | implemented |
create_source_classification | answer | 2 (configuration write) | brand:write | implemented |
delete_source_classification | answer | 5 (destructive) | brand:write | implemented |
assign_source_classification | answer | 2 (configuration write) | brand:write | implemented |
unassign_source_classification | answer | 5 (destructive) | brand:write | implemented |
get_client_report | answer | 1 (read) | answer:read | implemented |
get_overview | console | 1 (read) | answer:read | implemented |
list_brands | console | 1 (read) | answer:read | implemented |
get_brand | console | 1 (read) | answer:read | implemented |
list_prompts | console | 1 (read) | prompt:read | implemented |
get_prompt | console | 1 (read) | prompt:read | implemented |
list_fanout_queries | console | 1 (read) | answer:read | implemented |
list_domains | console | 1 (read) | answer:read | implemented |
get_domain | console | 1 (read) | answer:read | implemented |
get_domain_movers | console | 1 (read) | answer:read | implemented |
list_urls | console | 1 (read) | answer:read | implemented |
get_url | console | 1 (read) | answer:read | implemented |
get_url_movers | console | 1 (read) | answer:read | implemented |
get_winback_targets | console | 1 (read) | answer:read | implemented |
list_reports | report | 1 (read) | report:read | planned |
generate_brand_report | report | 2 (configuration write) | report:write | planned |
generate_portfolio_report | report | 2 (configuration write) | report:write | planned |
preview_report | report | 2 (configuration write) | report:write | planned |
request_report_approval | report | 4 (external communication) | report:approve | planned |
approve_report | report | 4 (external communication) | report:approve | planned |
reject_report | report | 4 (external communication) | report:approve | planned |
send_report | report | 4 (external communication) | report:send | planned |
schedule_report | report | 2 (configuration write) | report:write | planned |
update_report_schedule | report | 2 (configuration write) | report:write | planned |
cancel_report_schedule | report | 5 (destructive) | report:write | planned |
create_client_action_plan | report | 2 (configuration write) | report:write | planned |
update_action_item | report | 2 (configuration write) | report:write | implemented |
list_members | member | 1 (read) | member:read | implemented |
invite_member | member | 4 (external communication) | member:manage | implemented |
update_member_role | member | 5 (destructive) | member:manage | implemented |
revoke_member_access | member | 5 (destructive) | member:manage | implemented |
create_service_account | member | 5 (destructive) | member:manage | implemented |
revoke_service_account | member | 5 (destructive) | member:manage | planned |
list_mcp_connections | member | 1 (read) | member:read | implemented |
revoke_mcp_connection | member | 5 (destructive) | member:manage | implemented |
list_webhooks | member | 1 (read) | webhook:read | planned |
create_webhook | member | 4 (external communication) | webhook:manage | planned |
rotate_webhook_secret | member | 5 (destructive) | webhook:manage | planned |
delete_webhook | member | 5 (destructive) | webhook:manage | planned |
list_audit_events | member | 1 (read) | audit:read | planned |
export | export | 3 (billable) | answer:read | planned |
get_export | export | 1 (read) | answer:read | planned |
get_trial_usage | trial | 1 (read) | usage:read | implemented |
preview_collection | trial | 1 (read) | run:read | implemented |
get_workflow_examples | trial | 1 (read) | usage:read | implemented |
get_collection_mode_options | collection_mode | 1 (read) | org:read | implemented |
preview_collection_mode_change | collection_mode | 1 (read) | org:read | implemented |
get_pending_collection_mode_change | collection_mode | 1 (read) | org:read | implemented |
request_collection_mode_change | collection_mode | 2 (configuration write) | org:manage | implemented |
cancel_collection_mode_change | collection_mode | 2 (configuration write) | org:manage | implemented |
get_market_profile | market | 1 (read) | workspace:read | implemented |
preview_market_change | market | 1 (read) | workspace:read | implemented |
set_market_profile | market | 2 (configuration write) | workspace:write | implemented |
request_market_change | market | 2 (configuration write) | workspace:write | implemented |
cancel_market_change | market | 2 (configuration write) | workspace:write | implemented |
list_market_locations | market | 1 (read) | workspace:read | implemented |
add_market_location | market | 2 (configuration write) | workspace:write | implemented |
remove_market_location | market | 2 (configuration write) | workspace:write | implemented |
set_primary_market_location | market | 2 (configuration write) | workspace:write | implemented |
187 declared; 138 implemented.