79 available actions
What your AI agent can do in Peec AI MCP
Peec AI MCP lets agents analyze authorized AI-search visibility, competitors, citations, sources, sentiment, topics, and trends, and manage supported project configuration with confirmation. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.
Showing all 79 actions.
Common starting points
- Read docRead the full markdown content of a single Peec documentation page.
- Search docsSearch the Peec product documentation ( and return the most relevant pages.
- Create brandsCreate up to 50 brands (competitors or own) in a project in one call.
- Create categoriesCreate product categories.
- Update brandsUpdate up to 50 brands in one call (name, regex, aliases, domains, color per item).
- Update categoriesRename and/or move categories by id (use list_categories to resolve ids).
Browse all 79 actions by capability
Open a capability to see every supported action and its description.
Find & reviewLook up and review existing recordsView 42 actions
- Get actionsGet Peec's opportunity-scored action recommendations for improving brand visibility in AI search engines.
- Get agent visitsAggregate AI agent visit counts from access logs over a date range.
- Get brand perception attribute rankingsHow the project's own brand ranks against competitors for each brand-perception attribute.
- Get brand perception attribute sourcesThe sources feeding one brand-perception attribute: the URLs AI answers cited when describing the brand with this attribute.
- Get brand perception brand attributesHow AI models describe the project's own brand: attribute clusters (e.g.
- Get brand perception competitive breakdownThe full competitive breakdown matrix: for every brand-perception attribute, the average prominence of each brand (the project's own brand and its competitors) across…
- Get brand reportGet a report on brand visibility, sentiment, and position across AI search engines.
- Get chatGet the full content of a single chat (one AI engine's response to one prompt on one date).
- Get chats reportAggregate counts and rich-answer-feature shares over a project's chats for a date range.
- Get domain reportGet a report on source domain visibility and citations across AI search engines.
- Get productGet one product's detailed metrics over a date range — the drill-down companion to list_products, which returns a thin row per product.
- Get project profileRead a project's brand profile — the description, industry, brand-identity adjectives, target markets, audience distribution, and product/service list that Peec uses to…
- Get prompt suggestion generationRead the authoritative status of a run returned by generate_prompt_suggestions.
- Get shopping attributesCompare the qualitative characteristics and features that AI engines associate with a product (or the whole catalog) against competitors.
- Get shopping summaryReturn catalog-wide shopping metrics over a date range — avg_visibility, avg_win_rate, and avg_position, each with a period-over-period delta — as a single aggregated…
- Get shopping trendReturn a per-bucket shopping time series (visibility, win_rate, avg_position, sov) for specific products or global brands over a date range.
- Get url contentFetches and returns the content of a URL for downstream analysis — the markdown Peec extracted from the page.
- Get url reportGet a report on source URL visibility and citations across AI search engines.
- List botsList all known AI crawler/agent bots that visit the site (e.g.
- List brand perception attribute clustersThe editable attribute taxonomy behind brand perception: every cluster with its id, label and the raw extracted attributes grouped under it.
- List brandsList brands tracked in a project — includes the user's own brand and competitors.
- List categoriesList a project's product categories.
- List chatsList chats (individual AI responses) for a project over a date range.
- List domain classificationsList the custom domain classifications defined for a project.
- List global brandsSearch Peec's global brand catalog — the shared registry of real-world brands (e.g.
- List merchantsList the merchants (sellers, e.g.
- List model channelsList the AI engine channels tracked by Peec.
- List modelsDeprecated — prefer list_model_channels, which returns stable channel IDs that survive model upgrades.
- List productsList a project's products with headline metrics over a date range, filtered by the shopping filter pack.
- List projectsList active projects the authenticated user has access to.
- List promptsList prompts (conversational questions tracked daily across AI engines) in a project.
- List prompt suggestionsList a project's prompt suggestions — prompts generated by the Prompt Builder and awaiting review, which are not tracked and produce no data until accepted.
- List search queriesList the general web-search queries an AI engine fanned out to while answering prompts in a project over a date range — the text sub-queries it sent to a search index…
- List shopping demandRank the query terms that drive shopping demand by how many distinct chats they appear in, with a trend vs a comparison window.
- List shopping performanceList products or categories (via entity_type) ranked by shopping performance over a date range.
- List shopping queriesList the product/shopping queries an AI engine fanned out to while answering prompts in a project over a date range.
- List tag groupsList the user-defined tag groups in a project, each with its shared color and tag count.
- List tagsList tags in a project.
- List topicsList topics in a project.
- List url classificationsList the custom URL classifications defined for a project.
- Read docRead the full markdown content of a single Peec documentation page.
- Search docsSearch the Peec product documentation ( and return the most relevant pages.
Create & communicateCreate records or send supported messagesView 11 actions
- Create brandsCreate up to 50 brands (competitors or own) in a project in one call.
- Create categoriesCreate product categories.
- Create domain classificationDefine a new custom domain classification on a project.
- Create global brandCreate a brand and return its global_brand_id.
- Create productsCreate catalog products (source=CATALOG) in a project — the brand's own claimed/uploaded products, as opposed to LLM products that Peec auto-detects in shopping answers.
- Create promptsCreate up to 50 prompts in a project in one call.
- Create tagsCreate up to 50 tags in a project in one call.
- Create topicsCreate up to 50 topics in a project in one call.
- Create url classificationDefine a new custom URL classification on a project.
- Generate prompt suggestionsGenerate Prompt Builder suggestions for a project — the same generation the app's Prompt Builder runs.
- Generate topicsCompose candidate topics for the project from its brand profile — the same composition the app's Prompt Builder runs.
Update & manageChange and manage existing recordsView 13 actions
- Archive promptsArchive up to 50 prompts (sets is_archived = true) so they stop running while keeping their chats and history intact.
- Assign domain classificationAssign a built-in classification (Corporate, Competitor, Editorial, Institutional, Other, Reference, UGC, You, Related) or the name of a custom domain classification to…
- Assign url classificationAssign a built-in classification (Homepage, Category Page, Product Page, Listicle, Comparison, Profile, Alternative, Discussion, How-To Guide, Article, Other) or the…
- Edit brand perception attribute clustersRename, delete and reassign brand-perception attribute clusters — the same edits the Manage attributes screen makes.
- Set project profileSet the project's own brand-identity profile — its industry, target audience, tone, and similar descriptive fields.
- Update brandsUpdate up to 50 brands in one call (name, regex, aliases, domains, color per item).
- Update categoriesRename and/or move categories by id (use list_categories to resolve ids).
- Update productsUpdate up to 1000 products by id in one call (use list_products to resolve ids).
- Update promptsUpdate the topic and/or tags of up to 50 prompts in one call.
- Update prompt suggestionsEdit up to 50 pending prompt suggestions from list_prompt_suggestions before finalizing: rewrite the text and/or replace the tag set per item.
- Update tag groupsRename and/or recolor up to 50 user-defined tag groups in one call.
- Update tagsUpdate up to 50 tags in one call (name, color, and/or group per item).
- Update topicsRename up to 50 topics in one call.
Remove & cancelRemove records or cancel supported workView 9 actions
- Delete brandsDelete up to 50 brands in a project.
- Delete categoriesDelete categories by id (use list_categories to resolve ids).
- Delete domain classificationPermanently delete a custom domain classification entity.
- Delete productsDelete products by id (use list_products to resolve ids).
- Delete promptsDelete up to 50 prompts in a project.
- Delete tag groupsDelete up to 50 user-defined tag groups.
- Delete tagsDelete up to 50 tags in a project.
- Delete topicsDelete up to 50 topics in a project.
- Delete url classificationPermanently delete a custom URL classification entity.
Other actionsSpecialist and administrative actions.View 4 actions
- Finalize prompt suggestionsResolve prompt suggestions listed by list_prompt_suggestions, in one pass over a reviewed set: ids in accepted_ids become tracked prompts and promote their topics into…
- Unarchive promptsUnarchive up to 50 prompts (sets is_archived = false), reactivating them so they resume running.
- Unassign domain classificationClear the classification override on a whole domain (operates on a domain, e.g.
- Unassign url classificationClear the classification override on a single URL (operates on one full URL — for a whole domain use unassign_domain_classification), restoring the heuristic…
Connection record
A connection you can control.
- Sign-in
- OAuth sign-in
- Setup
- Sign in with your own Peec AI MCP account. Access is limited to the work agreed for the role.
- Boundaries
- Only the approved role and actions.
- Off switch
- Revoke the connection from your account.
FAQ
Before you connect Peec AI MCP
How does the agent connect to Peec AI MCP?
You sign in with your own Peec AI MCP account. Permissions are limited to what the agent needs, the connection is health-checked, and you can revoke access from Peec AI MCP at any time.
What can the agent actually do in Peec AI MCP?
The page above lists the 79 actions currently available through the Peec AI MCP connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Peec AI MCP included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Peec AI MCP is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.
Bring the workflow together
Ready to put Peec AI MCP to work?
Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.