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 for products across different country 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

Perform a search to find similar links and retrieve a list of relevant results.

Fetch URL Content

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

Composio Finance Search

Get real-time stock prices, market data, financial news, and company information with historical analysis.

Flight Search

Search for flights with comprehensive pricing, schedule, and airline information.

Composio Google Maps Search

Performs a location-specific search via the Composio Google Maps Search API, returning results under `results.

Groq Chat Completion

Execute fast LLM inference using Groq's optimized hardware and API.

Hotel Search

Search for hotels and vacation rentals with comprehensive filtering and pricing.

Composio Image Search

The ImageSearch class performs an image search using the Composio Image Search API, targeting image metadata and URLs (not binary data) via Google Images.

Composio News Search

Search for the latest news articles and current events with smart filtering.

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

Scholar API scrapes Google Scholar search results via SERP API, returning academic papers and scholarly articles.

Composio SEC EDGAR Filings Search

Retrieve authoritative SEC EDGAR filing metadata (10-K/10-Q/8-K etc.

Composio Shopping Search

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

Composio LLM Search

The Composio LLM Search class serves as a gateway to the Composio LLM Search API, allowing users to perform searches across a broad range of content with multiple filtering options.

Composio Trends Search

Discover trending topics, search patterns, and popularity data.

TripAdvisor Travel Search

Search TripAdvisor for travel recommendations and itinerary planning without authentication (unlike TRIPADVISOR_CONTENT_API_SEARCH_LOCATIONS and other TripAdvisor tools requiring an active connection).

Walmart Product Search

Search Walmart for products with price filtering.

Composio Web Search

Perform a web search using the Exa API.

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