How to integrate Search1API MCP with Hermes

Connect Hermes to Search1API MCP. Search latest climate news and summarize key developments, find coffee shops near your current location, and more using natural language, with authentication handled for you.

Search1API logoSearch1API
Api Key

Search1API is a search and web data service for web, maps, and news results. It also supports crawling, screenshots, sitemaps, and structured data extraction.

14 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 Search1API 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 Search1API 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 Search1API 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 Search1API

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

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

5. Done!

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

The Search1API MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Search1API account. It provides structured and secure access to web, maps, news search, crawling, screenshots, sitemap discovery, and structured data extraction, so your agent can research topics, find places and current stories, collect website content, and extract useful data on your behalf.

  • Web and research search: Have your agent research a topic across multiple search engines, find relevant web pages, and return deduplicated results.
  • News and maps discovery: Let the agent search recent news with filters or find businesses and places on Google Maps.
  • Website crawling and discovery: Direct your agent to fetch readable content from public URLs, discover a site's sitemap, or start and check a multi-page crawl.
  • Structured data extraction: Instruct your agent to extract caller-defined information from a public webpage in a specified JSON shape.
  • Webpage capture and account insights: Have your agent take webpage screenshots, check Search1API service health, review usage, or retrieve a live trending feed.

Way Forward

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

Ask Research

Run a natural-language research query across up to five provider-selected engines and return at most 10 deduplicated, reranked results plus partial source errors.

Crawl URLs

Fetch readable content from one or more public URLs.

Discover Sitemap

Discover sitemap URLs for a public site, or list all links on one public page without fetching page content.

Extract Structured Data

Extract caller-defined structured data from one public webpage using an optional prompt and JSON response shape.

Get Deepcrawl Status

Get the current state of a deepcrawl task and its packaged result URL when available.

Get Health

Read Search1API's free, unauthenticated provider serving/readiness status.

Get Trending

Return a platform's current live trending feed.

Get Usage

Return the connected account's remaining Search1API credits and credential metadata.

Search Maps

Search one Google Maps results page for businesses or places.

Search News

Search recent news for one or more queries with source, site, language, and time filters, returning a typed outcome for each.

Search Web

Search the web for one or more queries and return a typed outcome for each.

Start Deepcrawl

Start an asynchronous multi-page crawl of a public site and return its task ID.

Submit Feedback

Create external feedback for Search1API about a problem, missing capability, or confusing documentation encountered during a task.

Take Screenshot

Render a public webpage as a PNG, JPEG, or WebP file with viewport, readiness, selector, and appearance controls.

FAQ

Frequently asked questions

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

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

Start with Search1API.It takes 30 seconds.

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

Start building