Peec AI MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Peec AI MCP or direct API to analyze visibility, compare competitors, surface citations and sources, and manage project configuration through natural language.

Peec AI MCP logoPeec AI MCP
Dcr Oauth

Peec AI MCP analyzes AI-search visibility, competitors, citations, sources, and trends. It helps teams configure projects and surface actionable insights.

79 Tools

Try Peec AI MCP now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Peec AI MCP
Try asking
TOOLS

Supported Tools

Every Peec AI MCP action and event your agent gets out of the box.

Archive prompts

Archive up to 50 prompts (sets is_archived = true) so they stop running while keeping their chats and history intact.

Assign domain classification

Assign a built-in classification (Corporate, Competitor, Editorial, Institutional, Other, Reference, UGC, You, Related) or the name of a custom domain classification to a domain.

Assign url classification

Assign 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 classification to a URL.

Create brands

Create up to 50 brands (competitors or own) in a project in one call.

Create categories

Create product categories.

Create domain classification

Define a new custom domain classification on a project.

Create global brand

Create a brand and return its global_brand_id.

Create products

Create 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 prompts

Create up to 50 prompts in a project in one call.

Create tags

Create up to 50 tags in a project in one call.

Create topics

Create up to 50 topics in a project in one call.

Create url classification

Define a new custom URL classification on a project.

Delete brands

Delete up to 50 brands in a project.

Delete categories

Delete categories by id (use list_categories to resolve ids).

Delete domain classification

Permanently delete a custom domain classification entity.

Delete products

Delete products by id (use list_products to resolve ids).

Delete prompts

Delete up to 50 prompts in a project.

Delete tag groups

Delete up to 50 user-defined tag groups.

Delete tags

Delete up to 50 tags in a project.

Delete topics

Delete up to 50 topics in a project.

Delete url classification

Permanently delete a custom URL classification entity.

Edit brand perception attribute clusters

Rename, delete and reassign brand-perception attribute clusters — the same edits the Manage attributes screen makes.

Finalize prompt suggestions

Resolve 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 rejected_ids are deleted from the review list.

Generate prompt suggestions

Generate Prompt Builder suggestions for a project — the same generation the app's Prompt Builder runs.

Generate topics

Compose candidate topics for the project from its brand profile — the same composition the app's Prompt Builder runs.

Get actions

Get Peec's opportunity-scored action recommendations for improving brand visibility in AI search engines.

Get agent visits

Aggregate AI agent visit counts from access logs over a date range.

Get brand perception attribute rankings

How the project's own brand ranks against competitors for each brand-perception attribute.

Get brand perception attribute sources

The sources feeding one brand-perception attribute: the URLs AI answers cited when describing the brand with this attribute.

Get brand perception brand attributes

How AI models describe the project's own brand: attribute clusters (e.

Get brand perception competitive breakdown

The 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.

Get brand report

Get a report on brand visibility, sentiment, and position across AI search engines.

Get chat

Get the full content of a single chat (one AI engine's response to one prompt on one date).

Get chats report

Aggregate counts and rich-answer-feature shares over a project's chats for a date range.

Get domain report

Get a report on source domain visibility and citations across AI search engines.

Get product

Get 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 profile

Read 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.

Get prompt suggestion generation

Read the authoritative status of a run returned by generate_prompt_suggestions.

Get shopping attributes

Compare the qualitative characteristics and features that AI engines associate with a product (or the whole catalog) against competitors.

Get shopping summary

Return 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.

Get shopping trend

Return a per-bucket shopping time series (visibility, win_rate, avg_position, sov) for specific products or global brands over a date range.

Get url content

Fetches and returns the content of a URL for downstream analysis — the markdown Peec extracted from the page.

Get url report

Get a report on source URL visibility and citations across AI search engines.

List bots

List all known AI crawler/agent bots that visit the site (e.

List brand perception attribute clusters

The editable attribute taxonomy behind brand perception: every cluster with its id, label and the raw extracted attributes grouped under it.

List brands

List brands tracked in a project — includes the user's own brand and competitors.

List categories

List a project's product categories.

List chats

List chats (individual AI responses) for a project over a date range.

List domain classifications

List the custom domain classifications defined for a project.

List global brands

Search Peec's global brand catalog — the shared registry of real-world brands (e.

List merchants

List the merchants (sellers, e.

List model channels

List the AI engine channels tracked by Peec.

List models

Deprecated — prefer list_model_channels, which returns stable channel IDs that survive model upgrades.

List products

List a project's products with headline metrics over a date range, filtered by the shopping filter pack.

List projects

List active projects the authenticated user has access to.

List prompts

List prompts (conversational questions tracked daily across AI engines) in a project.

List prompt suggestions

List 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 queries

List 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 (use list_shopping_queries for those).

List shopping demand

Rank the query terms that drive shopping demand by how many distinct chats they appear in, with a trend vs a comparison window.

List shopping performance

List products or categories (via entity_type) ranked by shopping performance over a date range.

List shopping queries

List the product/shopping queries an AI engine fanned out to while answering prompts in a project over a date range.

List tag groups

List the user-defined tag groups in a project, each with its shared color and tag count.

List tags

List tags in a project.

List topics

List topics in a project.

List url classifications

List the custom URL classifications defined for a project.

Read doc

Read the full markdown content of a single Peec documentation page.

Search docs

Search the Peec product documentation (https://docs.

Set project profile

Set the project's own brand-identity profile — its industry, target audience, tone, and similar descriptive fields.

Unarchive prompts

Unarchive up to 50 prompts (sets is_archived = false), reactivating them so they resume running.

Unassign domain classification

Clear the classification override on a whole domain (operates on a domain, e.

Unassign url classification

Clear the classification override on a single URL (operates on one full URL — for a whole domain use unassign_domain_classification), restoring the heuristic classification.

Update brands

Update up to 50 brands in one call (name, regex, aliases, domains, color per item).

Update categories

Rename and/or move categories by id (use list_categories to resolve ids).

Update products

Update up to 1000 products by id in one call (use list_products to resolve ids).

Update prompts

Update the topic and/or tags of up to 50 prompts in one call.

Update prompt suggestions

Edit 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 groups

Rename and/or recolor up to 50 user-defined tag groups in one call.

Update tags

Update up to 50 tags in one call (name, color, and/or group per item).

Update topics

Rename up to 50 topics in one call.

SETUP GUIDE

Connect Peec AI MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Peec AI MCP
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Peec AI MCP API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Peec AI MCP Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Peec AI MCP actions with your Agent

Why Use Composio?

AI Native Peec AI MCP Integration

  • Supports both Peec AI MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Peec AI MCP data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Peec AI MCP access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Peec AI MCP
  • Scoped, least privilege access to Peec AI MCP resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use Peec AI MCP with any AI Agent Framework

Choose a Framework you want to connect Peec AI MCP with

FAQ

Frequently asked questions

Yes, Peec AI MCP requires you to configure your own Dcr Oauth credentials. Once set up, Composio handles secure credential storage and management for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Peec AI MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Peec AI MCP tool your agent needs.Free to start.

Start building