How to integrate Composio search MCP with Hermes

Connect Hermes to Composio search MCP. Find recent news about electric vehicles, search for top-rated hotels in paris, and more using natural language, with authentication handled for you.

Composio search logoComposio search
No Auth

Composio search is a unified web search toolkit spanning travel, e-commerce, news, financial markets, images, and more. It lets you and your apps tap into up-to-date web data from a single, easy-to-integrate service.

21 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 Composio search 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 Composio search 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 Composio search 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 Composio search

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

4. Done. You're all set with a new Composio search 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 Composio search or request any Composio search-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Composio search MCP server, and what's possible with it?

The Composio Search MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to Composio Search. It provides structured and secure access to web, travel, shopping, financial, news, and public filing search, so your agent can find flights and hotels, compare products, track markets, research current events, and retrieve public web content on your behalf.

  • Travel planning: Have your agent search flights, hotels, vacation rentals, and TripAdvisor recommendations for your next trip.
  • Product and deal discovery: Let the agent search Amazon and other shopping sources, compare prices, apply location preferences, and find deals.
  • Market and company research: Direct your agent to retrieve stock prices, market data, financial news, company information, and historical analysis.
  • News and web research: Instruct your agent to search current news and the wider web for relevant articles, sources, and information.
  • Filings and page retrieval: Have your agent find SEC filings such as annual, quarterly, and current reports, or extract readable text from public web pages.

Way Forward

With Composio search 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 Composio search action and event your agent gets out of the box.

Amazon Product Search

Search Amazon products across international marketplaces.

Composio DuckDuckGo Search

The DuckDuckGoSearch class utilizes the Composio DuckDuckGo Search API to perform searches, focusing on web information and details.

Composio Google Events Search

Search for upcoming events, concerts, festivals, conferences, and other activities.

Composio Similarlinks

Find links similar to a supplied URL using Exa, with optional domain, date, category and result-count filters.

Fetch URL Content

Fetch and extract clean, readable page text (markdown) from public web pages (HTML content) using the Exa API.

Composio Finance Search

Search Google Finance for stock quotes, indices, cryptocurrency prices, exchange rates, company financials and related news.

Flight Search

Search flights using a natural-language route or structured airport codes and dates.

Composio Google Maps Search

Search Google Maps for places by query, optionally using map coordinates and a pagination offset.

Groq Chat Completion

Generate chat completions using Groq models for tasks such as question answering, content generation, coding, summarization and translation.

Hotel Search

Search hotels and vacation rentals by location and stay dates, with price, class, cancellation and localization filters.

Composio Image Search

Search Google Images for image metadata and URLs, including original and thumbnail links.

Composio News Search

Search Google News results by query, time window, country and language.

NPPES NPI Registry Lookup

Lookup US healthcare provider details from the CMS NPI Registry (NPPES) using an NPI number or search filters.

Composio Scholar Search

Search Google Scholar for scholarly articles.

Composio SEC EDGAR Filings Search

Retrieve recent SEC EDGAR filing metadata for a company by ticker or CIK, optionally filtering by form type and constructing primary document and index URLs.

Composio Shopping Search

Search for products with advanced price filtering, location targeting, and deal discovery.

Composio LLM Search

Search a broad range of content using the Tavily API, with options for search depth, images, direct answers, domain filters, and the number of results.

Composio Trends Search

Search Google Trends for interest over time, regional comparisons, related topics, and related queries.

TripAdvisor Travel Search

Search TripAdvisor for attractions, restaurants, hotels, tours, and other travel information without a connected TripAdvisor account.

Walmart Product Search

Search Walmart products with optional minimum and maximum price filters.

Composio Web Search

Search the web using Exa's answer API, returning an AI-generated answer and source citations.

FAQ

Frequently asked questions

With a standalone Composio search MCP server, the agents and LLMs can only access a fixed set of Composio search tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Composio search 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 Composio search tools.

Yes, absolutely. You can configure which Composio search 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 Composio search data and credentials are handled as safely as possible.

Start with Composio search.It takes 30 seconds.

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

Start building