Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1500+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

How to integrate Serpapi MCP with DeepSeek Harness

Connect DeepSeek Harness to Serpapi MCP. Find latest job postings for python developers, show recent stock news for apple inc, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Serpapi

Api Key

SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research.

59 Tools

Managed auth

Connect Serpapi without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

DeepSeek Harness (dsh) is an open-source agent runtime from DeepSeek AI, and every part of it is a plugin, so you can swap out the model adapter, the tool registry, or the agent loop. It runs on the Cordis framework and comes with a local Web UI, a headless CLI runner, and a Python SDK. You can point it at DeepSeek V4-Pro and V4-Flash, or at Anthropic, OpenAI, and other OpenAI-compatible providers. It is MIT licensed and still in developer preview.

This guide shows how to connect your Serpapi account to DeepSeek Harness, and you can do it with either the Composio Connect CLI or the Composio Connect MCP. The dsh-base bundle gives shell execution as a first-class tool, so the CLI is the easiest path for personal use. It is quick to set up and needs no server config, and the MCP path works well too, since the harness comes with a built-in MCP client.

What is Composio Connect?

Composio Connect lets anyone plug 1,500+ applications directly into their agent harness, including DeepSeek Harness, through a single hosted MCP endpoint. Each task runs as a session, a scoped runtime that ties together the user, the available toolkits, authentication, and execution state. It can:

Discover and load tools on-demand. A small set of meta tools lets the agent search for the right tool at runtime, so you never load hundreds of tool definitions into context.
Chain tools in a sandboxed remote workbench. Multi-step workflows run server-side, passing outputs between tools and working with files in the session's sandbox, so long chains finish without a lot of back-and-forth with the LLM.
Manage authentication end-to-end. Managed OAuth, per-user connected accounts, and account isolation are all handled for you, so you never wire up auth yourself.

Connect Serpapi to DeepSeek Harness with Composio

Prerequisites: Install DeepSeek Harness

DeepSeek Harness needs Node.js (20 or 22) and pnpm. Build it from source. This is also what the MCP path in Option 2 requires, since the built-in MCP client resolves its dependencies from the checkout:

bash

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

The Web UI listens on http://127.0.0.1:3080 by default. Open that address to confirm it is up.

Then configure your model route. In the Web UI, open Settings → Models: the built-in DeepSeek card accepts a DeepSeek API key, and the same page supports Anthropic, OpenAI, and custom OpenAI-compatible endpoints. Full first-run details are in the DeepSeek Harness docs.

Option 1: Composio CLI (recommended)

DeepSeek Harness runs shell commands as a first-class tool through its dsh-base bundle, so the Composio Universal CLI fits well. There is no MCP server to configure, and multi-step tool chaining is reliable. Install and authenticate:

bash

# Install the Composio CLI
curl -fsSL https://composio.dev/install | bash

# Log in to Composio
composio login

Connect to Serpapi

Ask DeepSeek Harness to connect to Serpapi, or just request any Serpapi-related task. Under the hood the agent calls Composio commands like any other shell tool:

bash

composio search "what can I do with Serpapi?"
composio link serpapi

On the first Serpapi call, composio link serpapi opens an OAuth prompt so you can authorize access. After that, every Serpapi command works with your stored credentials automatically, so you just talk to the agent and it will search, execute, and chain Serpapi tools as needed.

Option 2: Composio MCP

DeepSeek Harness bridges MCP through its built-in @deepseek-ai/dsh-mcp-client plugin. You register one server as a plugin row, and its tools appear under server-qualified names (mcp__<serverName>__<rawName>), the same shape Claude Code and Codex use.

MCP requires the source build. The built-in client depends on the harness's own internal packages (cordis, dsh-llm, dsh-tools, dsh-invariants, dsh-subprocess), which resolve from the git checkout you built in the prerequisites. Run everything below from that checkout with pnpm dsh. For a route that avoids editing config files, see the community plugin at the end of this section.

Auth note: The built-in client passes static headers only and has no OAuth flow, so authenticate to Composio Connect with the x-consumer-api-key header. For Composio's OAuth flow, use the community plugin below.

1. Register the Composio server

The web profile's user patch layer is $DSH_HOME/profiles/web/cordis.patch.yml ($DSH_HOME defaults to ~/.dsh). This is a patch file, so a new plugin goes under an insert: entry. A bare - id: row instead targets an existing entry and fails to boot with patch: entry "…" not found. Add:

bash

- insert:
    - id: mcp-composio
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: composio
        transport: streamable-http
        url: https://connect.composio.dev/mcp
        headers:
          x-consumer-api-key: !!js process.env.COMPOSIO_API_KEY

2. Set the API key and launch

The header value must resolve to a string at load time. Export your Composio consumer API key (ck_...), which is on the Connect → Settings → Sessions page of the Composio dashboard, in the shell you launch from. If it is unset, process.env.COMPOSIO_API_KEY is undefined and the config fails validation:

bash

export COMPOSIO_API_KEY=ck_your_key
pnpm dsh web

3. Done!

Open http://127.0.0.1:3080 and start a session on Standard or Code mode. (Minimal mode exposes only bash and str_replace_editor, so it hides MCP tools.) Composio's tools register as mcp__composio__*. Ask DeepSeek Harness to connect to Serpapi or request any Serpapi-related task, and Composio authorizes Serpapi on demand on the first call.

The dsh-mcp-client config schema (transport, serverName, url, headers, plus reconnect.* and toolCallTimeoutMs) is the current developer-preview interface and may change between releases.

Alternative: OAuth via the community plugin

To use Composio Connect's OAuth flow instead of a static key, or to skip editing cordis.patch.yml by hand, use the community dsh-mcp-manager plugin. It installs as a self-contained external plugin, ships a bundle patch so it auto-mounts, and adds a Settings → MCP page plus OAuth (authorization code + PKCE, RFC 7591 dynamic client registration, and refresh-token rotation). It needs the web profile and Node.js ^22.19 or >=24, with pnpm on your PATH.

Install it from your source checkout, then restart pnpm dsh web and refresh:

bash

pnpm dsh plugin --profile web add github:hyqhyq3/dsh-mcp-manager

Open Settings → MCP → ＋ Add MCP server, choose HTTP, set the name to composio, the URL to https://connect.composio.dev/mcp, and the auth mode to OAuth. Click Authenticate, and Composio's login and consent screen opens in the browser, then redirects back and registers the tools as mcp__composio__*. The row should read connected (N tools).

The plugin catches the OAuth code on a loopback redirect (http://127.0.0.1:<port>/mcp-manager/callback/<id>), so Composio's OAuth provider must allow that loopback URL. Server configs and tokens persist at ~/.dsh/mcp-manager.json, so treat that file as a secret. Being a community plugin on a preview harness, its commands may change, so check the plugin repo if a step drifts.

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

The SerpApi MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your SerpApi account. It provides structured and secure access to search engine, shopping, maps, jobs, academic, app store, and video results, so your agent can research topics, compare products, find local businesses, analyze reviews, and track search usage on your behalf.

Web and regional search: Have your agent research topics across Google, Bing, Baidu, Yahoo, Yandex, Naver, and DuckDuckGo, then organize the relevant results.
Shopping and product research: Let the agent compare products, prices, ratings, sellers, and reviews across Amazon, eBay, Walmart, Google Play, and the Apple App Store.
Local discovery and reviews: Direct your agent to find places through Bing Maps or DuckDuckGo Maps, examine Google Maps reviews, and research restaurant feedback from OpenTable.
Jobs, patents, and academic research: Instruct your agent to find job listings and employer ratings, inspect patent details, or review Google Scholar author publications and citation metrics.
Video and visual research: Have your agent search YouTube, retrieve video details and timestamped transcripts, or use Google Lens to find visually similar images and products.

Way Forward

With Serpapi connected, DeepSeek Harness can now act on your behalf whenever you ask it to.

From here, you can extend the harness further:

Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup, and each new integration adds to what your agent can do for you.
Build workflows across tools: Once multiple apps are connected, DeepSeek Harness can chain actions together, so it can turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
Use the plugin system: Wrap common Serpapi flows as dsh plugins or prompt templates so recurring tasks become one-line commands, and bundle your most-used Serpapi tools into a named profile you can boot on demand.

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

TOOLS

Supported Tools

Every Serpapi action and event your agent gets out of the box.

Amazon Search

Search Amazon by keyword or category for products, prices, and ratings.

Search Baidu with Query

Search Baidu (Chinese search engine) and retrieve search results.

Bing Maps Search

Search Bing Maps via SerpApi for local businesses and places, using a required query and an optional place ID.

Bing Search

Retrieve Bing Search Engine Results via SerpAPI.

DuckDuckGo Light Search

Tool to access the world's fastest DuckDuckGo Search API via SerpApi.

DuckDuckGo Maps search

Scrapes DuckDuckGo Maps results via SerpApi.

DuckDuckGo search

Performs a DuckDuckGo search via SerpApi to retrieve SERP data, including organic results, ads, and structured information.

eBay Search

Search eBay product listings via SerpApi using keywords and optional location and marketplace settings.

Search Google Events

Searches for events in Google Search's structured event results.

Search finance

Retrieves structured financial information (e.

Get SerpApi Account

Return plan, usage, remaining searches, renewal, throughput, and extra credits.

Amazon Product

Retrieve Amazon product details, variants, sellers, and related items by ASIN.

Get Location Options

Tool to get available location options for Google searches.

Get Facebook profile information

Tool to retrieve public information from a Facebook profile or page using SerpAPI.

Get Google About This Result

Tool to get Google 'About this result' information for a website.

Google AI Overview

Retrieve the full AI Overview referenced by a fresh Google Search page token.

Get Google Hotels Autocomplete

Tool to get autocomplete suggestions for Google Hotels destination searches.

Get Google Images Related Content

Get related content for a specific Google Images result.

Google Jobs Listing

Retrieve employer ratings for a job ID returned by Google Jobs Search.

Get Google Patent Details

Tool to retrieve detailed information about a specific patent or scholar document from Google Patents via SerpApi.

Get Search Archive

Retrieve an archived search by its search ID, including status and modeled result fields when available.

YouTube Video

Retrieve YouTube video metadata, chapters, comments, and related videos.

YouTube Video Transcript

Retrieve timestamped transcript content for a YouTube video.

Google Domains List

Retrieve the list of supported Google domains for search queries.

Google Forums Search

Tool to scrape forum results from Google's Forums Platform using SerpApi.

Google Jobs Search

Retrieve Google Jobs search results via SerpApi, with pagination, location and remote-job filtering.

Google Lens search

Performs reverse image search using Google Lens to find visually similar images, products, and related content.

Google Light Search

Retrieve Google Light Search Results via SerpApi.

Google Maps Posts

Scrapes Google Maps Posts for a business location via SerpApi.

Google maps search

Performs a Google Maps search via SERP API.

Google Play Product Search

Tool to retrieve detailed Google Play product information using SerpApi.

Google Scholar Author Profile

Scrapes full Google Scholar Author page including articles, citations, metrics, and co-authors.

Google Scholar Cite

Scrapes full Google Scholar Citations with multiple citation formats.

Google Videos Light Search

Tool to scrape Google Videos results using SerpApi's ultra-fast Google Videos Light API.

Hotel Search

Search Google Hotels via SerpApi using a query and check-in and check-out dates, or retrieve property details with a property token.

Image search

Searches Google Images via SERP API for a given query, returning structured image results.

Google Maps Reviews

Retrieve Google Maps place reviews, topics, place data, and pagination.

Naver Search

Search Naver for Korean web content, news, videos, and shopping results.

Search for news articles

Search Google news results via SerpApi for articles matching a query.

OpenTable Reviews Search

Tool to scrape OpenTable restaurant reviews using SerpApi.

Google Play Search

Retrieve Google Play Store search results in JSON, with query, country, language, category, chart, and pagination options.

Google AI Mode

Query Google AI Mode for generated text, references, and follow-up data.

Search Google Scholar

Searches Google Scholar via SerpApi for academic literature, papers, articles, and citations based on a query.

Serp API search

Search Google via SerpApi and return up to five organic results nested under results.

Search Apple App Store

Tool to search Apple App Store for iOS and Mac apps.

Google Images Light Search

Tool to scrape Google Images results using SerpApi's Google Images Light API.

Search Google Local Services

Search Google Local Services for providers such as electricians, plumbers and HVAC technicians.

Search Index

Search SerpApi's preview LLM-first web index for grounding results.

Search public Google ads

Find public Google advertisements by advertiser or domain.

Search Yelp businesses

Search Yelp for businesses and places using SerpApi.

Shopping search

Searches Google Shopping via SerpAPI for a specific product, returning structured listings in results.

Google Trends search

Fetches Google Trends data; returns relative 0–100 interest indices (not absolute volumes) meaningful only when comparing queries within the same request.

Walmart Product Reviews

Tool to scrape full Walmart product reviews using SerpApi's Walmart Product Reviews API.

Walmart Search

Retrieve Walmart search results by query, location, store ID, and other parameters.

Yahoo Search

Retrieve Yahoo!

Yahoo Videos Search

Scrape Yahoo!

Yandex Images Search

Tool to search Yandex Images for image results with advanced filters.

Yandex Search

Retrieve Yandex Search Results.

YouTube Search

Retrieve YouTube Search Results.

FRAMEWORKS

How to build Serpapi MCP Agent with another framework

Claude Code

Use Serpapi MCP with Claude Code

Cursor

Use Serpapi MCP with Cursor

ChatGPT

Use Serpapi MCP with ChatGPT

Claude Cowork

Use Serpapi MCP with Claude Cowork

Antigravity

Use Serpapi MCP with Antigravity

OpenAI Agents SDK

Use Serpapi MCP with OpenAI Agents SDK

Claude Agent SDK

Use Serpapi MCP with Claude Agent SDK

Grok Bot

Use Serpapi MCP with Grok Bot

Muse

Use Serpapi MCP with Muse

Codex

Use Serpapi MCP with Codex

Grok Build

Use Serpapi MCP with Grok Build

VS Code

Use Serpapi MCP with VS Code

OpenCode

Use Serpapi MCP with OpenCode

OpenClaw

Use Serpapi MCP with OpenClaw

Hermes

Use Serpapi MCP with Hermes

Atomic Agent

Use Serpapi MCP with Atomic Agent

Pi

Use Serpapi MCP with Pi

Google ADK

Use Serpapi MCP with Google ADK

LangChain

Use Serpapi MCP with LangChain

Vercel AI SDK

Use Serpapi MCP with Vercel AI SDK

Mastra AI

Use Serpapi MCP with Mastra AI

LlamaIndex

Use Serpapi MCP with LlamaIndex

CrewAI

Use Serpapi MCP with CrewAI

Pydantic AI

Use Serpapi MCP with Pydantic AI

AutoGen

Use Serpapi MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Firecrawl

Api Key

Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.

Tavily

Api Key

Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.

Exa

Api Key

Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.

Excel

Oauth2S2s Oauth2

Microsoft Excel is a robust spreadsheet application for organizing, analyzing, and visualizing data. It's the go-to tool for calculations, reporting, and flexible data management.

FAQ

Frequently asked questions

With a standalone Serpapi MCP server, the agents and LLMs can only access a fixed set of Serpapi tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Serpapi and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. DeepSeek Harness 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 Serpapi tools.

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

Start with Serpapi.It takes 30 seconds.

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

Start building

How to integrate Serpapi MCP with DeepSeek Harness

Connect Serpapi without auth hassles

Introduction

Also integrate Serpapi with

What is Composio Connect?

Connect Serpapi to DeepSeek Harness with Composio

Prerequisites: Install DeepSeek Harness

Option 1: Composio CLI (recommended)

Connect to Serpapi

Option 2: Composio MCP

1. Register the Composio server

2. Set the API key and launch

3. Done!

Alternative: OAuth via the community plugin

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

Way Forward

Supported Tools

How to build Serpapi MCP Agent with another framework

Claude Code

Cursor

ChatGPT

Claude Cowork

Antigravity

OpenAI Agents SDK

Claude Agent SDK

Grok Bot

Muse

Codex

Grok Build

VS Code

OpenCode

OpenClaw

Hermes

Atomic Agent

Pi

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Firecrawl

Tavily

Exa

Excel

Frequently asked questions

What are the differences in Tool Router MCP and Serpapi MCP?+

Can I use Tool Router MCP with DeepSeek Harness?+

Can I manage the permissions and scopes for Serpapi while using Tool Router?+

How safe is my data with Composio Tool Router?+

Start with Serpapi.It takes 30 seconds.