How to integrate Composio search MCP with Atomic Agent

Connect Atomic Agent 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.

22 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Composio search.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Composio search account. See the Atomic Agent documentation for installation instructions.

Also integrate Composio search with

How Atomic Agent connects to Composio search

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Composio search to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Composio search. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Composio search account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

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 the entire Composio Search suite. It provides structured and secure access to powerful web, travel, shopping, news, academic, and financial search tools, so your agent can perform actions like searching the web, finding events, locating places, pulling news, and fetching academic research on your behalf.

  • Comprehensive web and news search: Instantly ask your agent to fetch up-to-date web pages, breaking news, or current events using Google, DuckDuckGo, or news-specific search APIs.
  • Travel and local discovery: Let your agent find nearby hotels, flights, events, or map locations using Google Maps and events search for seamless travel planning and local exploration.
  • E-commerce and product lookup: Have your agent search for products, deals, and reviews across major retailers like Amazon and Walmart to help you shop smarter and faster.
  • Financial and market data retrieval: Direct your agent to pull real-time stock information, financial news, and market trends with just a query—no manual research needed.
  • Academic and scholarly research: Empower your agent to find relevant academic papers, citations, and scholarly articles using Google Scholar and Exa Answer for research-heavy tasks.

Use Composio search from Atomic Agent

With your account connected, ask Atomic Agent to work with Composio search in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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

Vercel AI Gateway Chat

Execute LLM inference through Vercel AI Gateway's unified API.

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. Atomic Agent 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