How to connect Peec AI MCP to Claude

Connect Claude Web, Desktop and Cowork to Peec AI MCP. Analyze competitor visibility changes this quarter, list top citations for your product pages, and more using natural language, with authentication handled for you.

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

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Peec AI account to Claude via Composio Connect, enabling it to analyze competitor visibility changes this quarter, list top citations for your product pages, summarize sentiment trends for keyword set, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Peec AI MCP with

Connecting Peec AI to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Peec AI account

Back in Claude, ask it to connect to Peec AI or give it any Peec AI-related task.

For example, ask Claude to:

  • "Analyze competitor visibility changes this quarter"
  • "List top citations for your product pages"
  • "Summarize sentiment trends for keyword set"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Peec AI account is ready to use.

What is the Peec AI Claude Connector, and what's possible with it?

The Peec AI MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Peec AI account. It provides structured and secure access so your agent can perform Peec AI operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for Peec AI?

The connector can show as connected, but Claude must use it in each Peec AI conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Peec AI again.

2. Why does Claude show an MCP server error before Peec AI connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Peec AI.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Peec AI.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Peec AI authorization link not work?

The Composio connector is one server. Your Peec AI account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Peec AI connection.
  • Composio creates a fresh Peec AI authorization link.
  • Open that link in your browser and finish the Peec AI sign-in.

4. Why do Peec AI actions fail after they worked before?

The Peec AI connection can expire or lose permission.

  • Ask Claude to inspect the Peec AI connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Peec AI account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Peec AI.
  • If the action still fails with a permission error, check that the connected account has that permission in Peec AI itself.

5. How do I switch to a different Peec AI account?

Claude can manage the Peec AI connection for you.

  • Ask Claude to disconnect or delete the current Peec AI account.
  • Ask Claude to connect Peec AI again.
  • Open the new Composio authorization link for Peec AI.
  • Sign in with the other Peec AI account in the browser.
  • After the account connects, ask Claude to retry the Peec AI task.

6. Why is my Peec AI connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Peec AI connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Peec AI tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Peec AI.
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.

FAQ

Frequently asked questions

With a standalone Peec AI MCP server, the agents and LLMs can only access a fixed set of Peec AI tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Peec AI and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Peec AI tools.

Yes, absolutely. You can configure which Peec AI scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Peec AI data and credentials are handled as safely as possible.

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