Peec AI MCP
for LuumenAI

Read AI-search visibility in Peec AI, then change project setup with approval.

Connect Peec AI and Luumen can read how AI search engines describe your brand: visibility and sentiment reports, competitor breakdowns, cited sources, objections, and agent visit counts. Ask a question and get the numbers back. When project setup needs to change — brands, categories, products, prompts, classifications — Luumen previews the change and asks before writing.

The Peec AI MCP toolbox

84 tools: 46 read, 38 write. Reads answer instantly. Writes require approval by default. Everything is logged.

  • ReadGet actionsGet Peec's opportunity-scored action recommendations for improving brand visibility in AI search engines.
  • ReadGet agent visitsAggregate AI agent visit counts from access logs over a date range.
  • ReadGet brand perception attribute rankingsHow the project's own brand ranks against competitors for each brand-perception attribute.
  • ReadGet brand perception attribute sourcesThe sources feeding one brand-perception attribute: the URLs AI answers cited when describing the brand with this attribute.
  • ReadGet brand perception brand attributesHow AI models describe the project's own brand: attribute clusters (e.g.
  • ReadGet 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 AI answers.
  • ReadGet brand perception objectionsThe recurring arguments AI models make against the project's brand when a buyer is deciding.
  • ReadGet brand perception objection sourcesThe sources AI models retrieved when asked about one objection.
  • ReadGet brand reportGet a report on brand visibility, sentiment, and position across AI search engines.
  • ReadGet chatGet the full content of a single chat (one AI engine's response to one prompt on one date).
  • ReadGet chats reportAggregate counts and rich-answer-feature shares over a project's chats for a date range.
  • ReadGet domain reportGet a report on source domain visibility and citations across AI search engines.
  • ReadGet productGet one product's detailed metrics over a date range — the drill-down companion to list_products, which returns a thin row per product.
  • ReadGet 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 generate prompt suggestions.
  • ReadGet prompt suggestion generationRead the authoritative status of a run returned by generate_prompt_suggestions.
  • ReadGet shopping attributesCompare the qualitative characteristics and features that AI engines associate with a product (or the whole catalog) against competitors.
  • ReadGet 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 row across the filtered scope.
  • ReadGet shopping trendReturn a per-bucket shopping time series (visibility, win_rate, avg_position, sov) for specific products or global brands over a date range.
  • ReadGet url contentFetches and returns the content of a URL for downstream analysis — the markdown Peec extracted from the page.
  • ReadGet url reportGet a report on source URL visibility and citations across AI search engines.
  • ReadList botsList all known AI crawler/agent bots that visit the site (e.g.
  • ReadList brand perception attribute clustersThe editable attribute taxonomy behind brand perception: every cluster with its id, label and the raw extracted attributes grouped under it.
  • ReadList brandsList brands tracked in a project — includes the user's own brand and competitors.
  • ReadList brand social channelsList the social channels configured for a project's own brand and competitors.
  • ReadList categoriesList a project's product categories.
  • ReadList chatsList chats (individual AI responses) for a project over a date range.
  • ReadList domain classificationsList the custom domain classifications defined for a project.
  • ReadList global brandsSearch Peec's global brand catalog — the shared registry of real-world brands (e.g.
  • ReadList merchantsList the merchants (sellers, e.g.
  • ReadList model channelsList the AI engine channels tracked by Peec.
  • ReadList modelsDeprecated — prefer list_model_channels, which returns stable channel IDs that survive model upgrades.
  • ReadList productsList a project's products with headline metrics over a date range, filtered by the shopping filter pack.
  • ReadList projectsList active projects the authenticated user has access to.
  • ReadList promptsList prompts (conversational questions tracked daily across AI engines) in a project.
  • ReadList prompt suggestionsList a project's prompt suggestions — prompts generated by Prompt discovery and awaiting review, which are not tracked and produce no data until accepted.
  • ReadList referral sourcesEvery AI assistant Peec can attribute referral traffic to, whether or not a project has seen traffic from it.
  • ReadList 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, NOT product/shopping lookups…
  • ReadList shopping demandRank the query terms that drive shopping demand by how many distinct chats they appear in, with a trend vs a comparison window.
  • ReadList shopping performanceList products or categories (via entity_type) ranked by shopping performance over a date range.
  • ReadList shopping queriesList the product/shopping queries an AI engine fanned out to while answering prompts in a project over a date range.
  • ReadList tag groupsList the user-defined tag groups in a project, each with its shared color and tag count.
  • ReadList tagsList tags in a project.
  • ReadList topicsList topics in a project.
  • ReadList url classificationsList the custom URL classifications defined for a project.
  • ReadRead docRead the full markdown content of a single Peec documentation page.
  • ReadSearch docsSearch the Peec docs (https://docs.peec.ai) and return the most relevant pages.
  • WriteArchive promptsArchive up to 50 prompts (sets is_archived = true) so they stop running while keeping their chats and history intact. Approval by default
  • WriteAssign domain classificationAssign a built-in classification (Corporate, Competitor, Editorial, Institutional, Other, Reference, UGC, You, Related) or the name of a custom domain classification to a domain. Approval by default
  • WriteAssign url classificationAssign a built-in classification (Homepage, Category Page, Product Page, Listicle, Comparison, Profile, Alternative, Discussion, How-To Guide, Article, Other) or the name of a custom URL… Approval by default
  • WriteCreate brandsCreate up to 50 brands (competitors or own) in a project in one call. Approval by default
  • WriteCreate categoriesCreate product categories. Approval by default
  • WriteCreate domain classificationDefine a new custom domain classification on a project. Approval by default
  • WriteCreate global brandCreate a brand and return its global_brand_id. Approval by default
  • WriteCreate 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. Approval by default
  • WriteCreate promptsCreate up to 50 prompts in a project in one call. Approval by default
  • WriteCreate tagsCreate up to 50 tags in a project in one call. Approval by default
  • WriteCreate topicsCreate up to 50 topics in a project in one call. Approval by default
  • WriteCreate url classificationDefine a new custom URL classification on a project. Approval by default
  • WriteDelete brandsDelete up to 50 brands in a project. Approval by default
  • WriteDelete categoriesDelete categories by id (use list_categories to resolve ids). Approval by default
  • WriteDelete domain classificationPermanently delete a custom domain classification entity. Approval by default
  • WriteDelete productsDelete products by id (use list_products to resolve ids). Approval by default
  • WriteDelete promptsDelete up to 50 prompts in a project. Approval by default
  • WriteDelete tag groupsDelete up to 50 user-defined tag groups. Approval by default
  • WriteDelete tagsDelete up to 50 tags in a project. Approval by default
  • WriteDelete topicsDelete up to 50 topics in a project. Approval by default
  • WriteDelete url classificationPermanently delete a custom URL classification entity. Approval by default
  • WriteEdit brand perception attribute clustersRename, delete and reassign brand-perception attribute clusters — the same edits the Manage attributes screen makes. Approval by default
  • WriteFinalize 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 the project, ids in… Approval by default
  • WriteGenerate prompt suggestionsGenerate prompt suggestions for a project — the same generation Prompt discovery runs in the app. Approval by default
  • WriteGenerate topicsCompose candidate topics for the project from its brand profile — the same composition Prompt discovery runs in the app. Approval by default
  • WriteSet brand social channelsReplace the complete social-channel list for up to 50 brands. Approval by default
  • WriteSet project profileSet the project's own brand-identity profile — its industry, target audience, tone, and similar descriptive fields. Approval by default
  • WriteUnarchive promptsUnarchive up to 50 prompts (sets is_archived = false), reactivating them so they resume running. Approval by default
  • WriteUnassign domain classificationClear the classification override on a whole domain (operates on a domain, e.g. Approval by default
  • WriteUnassign 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 classification. Approval by default
  • WriteUpdate brandsUpdate up to 50 brands in one call (name, regex, aliases, domains, color per item). Approval by default
  • WriteUpdate categoriesRename and/or move categories by id (use list_categories to resolve ids). Approval by default
  • WriteUpdate productsUpdate up to 1000 products by id in one call (use list_products to resolve ids). Approval by default
  • WriteUpdate promptsUpdate the topic, tags, location and/or fact-checking selection of up to 50 prompts in one call. Approval by default
  • WriteUpdate 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. Approval by default
  • WriteUpdate tag groupsRename and/or recolor up to 50 user-defined tag groups in one call. Approval by default
  • WriteUpdate tagsUpdate up to 50 tags in one call (name, color, and/or group per item). Approval by default
  • WriteUpdate topicsRename up to 50 topics in one call. Approval by default

One prompt, start to finish

What a governed Peec AI MCP run looks like inside Luumen.

Questions

How does LuumenAI connect to Peec AI MCP?

Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

Can LuumenAI change things in Peec AI MCP on its own?

Read actions answer immediately. Anything that writes — archive prompts, assign domain classification, assign url classification, create brands, and more — is shown as a plan and requires approval by default, including the 15 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.

Who gets access to the integration?

You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.

Is there an audit trail?

Every call to Peec AI MCP — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.

Put Peec AI MCP to work with Luumen

Connect in minutes. Every action scoped, approved, and audited from day one.