MCP server

If you know Peec's MCP

Peec and aeomcp use the same columnar idea — every analytical tool returns columns, rows, row_count and a trace_id — so most of what you already know about calling one server carries straight over to the other. A few things differ. Peec requires a free-text context argument on every tool; ours accepts and logs context but never requires it. Our engines are chatgpt, google_ai_overview, google_ai_mode and gemini (public names, not Peec's internal channel ids). aeomcp no longer supports Perplexity (retired 2026-10-12) or Microsoft Copilot (retired 2026-10-14): Peec's perplexity and copilot channels have no counterpart here, and historical answers from either are not returned. Until 2026-09-27 google_ai_overview labelled the channel that is now google_ai_mode; report bundles built before then keep the old label. Where Peec ships three separate report tools (get_brand_report, get_domain_report, get_url_report), we ship one get_report(kind=…) that takes brands, domains or urls. Creating and updating brands, prompts, prompt candidates, topics, tags and source classifications is here now — see writes for the bulk contract, dry_run and idempotency_key. Deleting any of those, and finalizing prompt candidates, is not here yet — they arrive in a later release; every row below marked planned is a frozen catalog name, not a working tool.

Status: available means the tool works today; planned means the name is reserved in the catalog but not yet callable.

account

Peec toolaeomcp toolNotes
get_project_profileget_brand_profilePeec's six-question shape: occupation, industry, brand presentation, products and services, target markets, audience distribution
list_projectslist_workspacesours adds is_current, official_origin; no include_inactive — tenants carries no inactive flag to filter on
read_docread_doc
search_docssearch_docsthis corpus, including this page
set_project_profileupdate_brand_profileavailable; a PATCH, not a full replace, and it saves a new profile version rather than overwriting the old one; it does not itself regenerate prompts (generate_buyer_questions does)

brands

Peec toolaeomcp toolNotes
create_brandsadd_competitorsavailable; supersedes the singular add_competitor, which stays in the catalog; resets aliases to [] when omitted on re-add (see writes)
delete_brandsremove_competitorsplanned (a later release); supersedes the singular remove_competitor, which stays in the catalog
get_brand_reportget_report (kind=brands)dimensions incl. week, month; raw sums on every row
list_brandslist_brandsappends domains, aliases, regex, color after the same twelve columns get_overview returns
update_brandsupdate_brandsavailable; patch semantics, at least one field required

prompts

Peec toolaeomcp toolNotes
archive_promptsarchive_promptsavailable
create_promptsimport_promptsavailable
delete_promptsdelete_promptsplanned (a later release)
list_promptslist_promptsadds country_code, is_archived, search, tag_ids; fields
unarchive_promptsunarchive_promptsavailable
update_promptsupdate_promptsavailable

prompt suggestions

Peec toolaeomcp toolNotes
finalize_prompt_suggestionsfinalize_prompt_candidatesplanned (a later release)
generate_prompt_suggestionsgenerate_buyer_questionsavailable; async — returns a run handle plus an estimate, and the questions land as candidates to accept
generate_topicsgenerate_topicsavailable; derived from the stored brand profile rather than generated freely, so the same profile always yields the same topics
get_prompt_suggestion_generationget_runany run kind, not just prompt generation
list_prompt_suggestionslist_prompt_candidatesstatus proposed by default; run_id narrows to one generation run
update_prompt_suggestionsupdate_prompt_candidatesavailable

topics & tags

Peec toolaeomcp toolNotes
create_tagscreate_tagsavailable
create_topicscreate_topicsavailable
delete_tag_groupsdelete_tag_groupsplanned (a later release)
delete_tagsdelete_tagsplanned (a later release)
delete_topicsdelete_topicsplanned (a later release)
list_tag_groupslist_tag_groupsuser tags only, with colour and tag count
list_tagslist_tagsuser tags and the five system tags; group narrows to one group
list_topicslist_topicstopic_id is the slug (e.g. general) — the same thing it means in Window.topic_id and the report topic_id dimension; the row's uuid is the separate first column id; suggested topics hidden unless include_suggested
update_tag_groupsupdate_tag_groupsavailable
update_tagsupdate_tagsavailable
update_topicsupdate_topicsavailable; addresses the topic row by its uuid, not the slug

engines

Peec toolaeomcp toolNotes
list_model_channelslist_engines
list_models—not planned; deprecated on both sides

answers & fan-outs

Peec toolaeomcp toolNotes
get_chatget_answerno products or raw payload yet; adds observed_location (the location evidence), measurement_method, location and location_label
list_chatssearch_answersWindow + features, brand_ids, include_archived, location_id; limit max 500, cursor pages; location column names the verified location (null otherwise)
list_search_querieslist_fanout_queriesone row per occurrence, not aggregated: answer_id, prompt_id, engine, date, query_index, plus Peec's occurrences count kept per query over the window; prompt_id is optional, not required

reports & sources

Peec toolaeomcp toolNotes
get_chats_reportget_answers_reportchat counts + feature shares (web search, shopping, product comparison, ad, map) over the same dimensions get_report accepts
get_domain_reportget_report (kind=domains)Peec's gap and mentioned_brand_count numeric filters are having clauses over gap_competitors and mentioned_brand_count
get_url_contentget_source_contentstatus pending/failed/blocked with text null when the page is known but not fetched; not_found only when no source page has ever been cited
get_url_reportget_report (kind=urls)

classifications

Peec toolaeomcp toolNotes
assign_domain_classificationassign_source_classificationavailable
assign_url_classificationassign_source_classification (kind=url)available
create_domain_classificationcreate_source_classificationavailable
create_url_classificationcreate_source_classification (kind=url)available
delete_domain_classificationdelete_source_classificationplanned (a later release)
delete_url_classificationdelete_source_classification (kind=url)planned (a later release)
list_domain_classificationslist_source_classifications (kind=domain)builtin, custom and per-target override rows, same as the url kind
list_url_classificationslist_source_classifications (kind=url)
unassign_domain_classificationunassign_source_classificationplanned (a later release)
unassign_url_classificationunassign_source_classification (kind=url)planned (a later release)

actions

Peec toolaeomcp toolNotes
get_actionsrecommend_next_actionsplanned; heuristics over several payloads, not a single projection

Not planned

Three Peec groups have no aeomcp counterpart and none is planned: brand perception (edit_brand_perception_attribute_clusters, get_brand_perception_attribute_rankings, get_brand_perception_attribute_sources, get_brand_perception_brand_attributes, get_brand_perception_competitive_breakdown, get_brand_perception_objection_sources, get_brand_perception_objections, list_brand_perception_attribute_clusters), agent analytics (get_agent_visits, list_bots, list_referral_sources), and shopping (create_categories, create_global_brand, create_products, delete_categories, delete_products, get_product, get_shopping_attributes, get_shopping_summary, get_shopping_trend, list_categories, list_global_brands, list_merchants, list_products, list_shopping_demand, list_shopping_performance, list_shopping_queries, update_categories, update_products — except list_shopping_queries, which our list_fanout_queries already covers as a fan-out kind).

← All docs