How to integrate Peec AI MCP with Hermes

Connect Hermes 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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Peec AI account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Peec AI MCP with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Peec AI with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Peec AI

Ask your agent to connect to Peec AI, or simply request any Peec AI-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Peec AI connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Peec AI or request any Peec AI-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Peec AI MCP server, 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.

Way Forward

With Peec AI connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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.

FRAMEWORKS

How to build Peec AI MCP Agent with another framework

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