SearchApi

MCP Server

Give AI assistants access to real-time data. Search the web, compare flights, find hotels, and more.

SearchApi's MCP server supports two authentication methods.

OAuth (Recommended)

Compatible clients (including Claude, Cursor, Codex, VS Code, and Zed) handle authentication automatically. Modern clients use Client ID Metadata Documents; other OAuth clients use secure dynamic registration. Just provide the base MCP URL:

https://www.searchapi.io/mcp

When your client connects for the first time, it will open a browser window where you can sign in and select which MCP integration to authorize. Subsequent connections reuse the stored token automatically.

Token Authentication

For clients without OAuth support or for server-to-server integrations, send your MCP token in the X-MCP-Token header:

X-MCP-Token: YOUR_TOKEN

Get your token from the MCP integrations dashboard. Do not put credentials in an MCP URL; URLs can be retained in browser history and intermediary logs.

Which method should I use?

Use OAuth if your client supports it — it's more secure (tokens expire and rotate automatically) and easier to manage. Use token auth for programmatic access or clients that don't support OAuth.

OAuth (Recommended)

If your client supports OAuth, use the base URL. Authentication is handled automatically on first connect.

No token needed. Your client handles authentication automatically via OAuth.

Claude Code

Run this command in your terminal:

claude mcp add --transport http searchapi https://www.searchapi.io/mcp

Your browser opens on first connect to sign in and pick an integration.

Claude Desktop

Add it from the app — no config file needed:

1. Open Customize → Connectors.
2. Click Add → Add custom connector.
3. Paste the URL above, click Add, then follow the OAuth prompt to authorize.

Available on all plans.

VS Code

Create .vscode/mcp.json in your project root:

{
  "servers": {
    "searchapi": {
      "type": "http",
      "url": "https://www.searchapi.io/mcp"
    }
  }
}

Start the SearchApi server from the MCP view; VS Code handles the OAuth sign-in.

Zed

Add this under context_servers in your Zed settings:

{
  "context_servers": {
    "searchapi": {
      "url": "https://www.searchapi.io/mcp"
    }
  }
}

Zed uses context_servers instead of mcpServers and runs the OAuth sign-in on first connect.

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "searchapi": {
      "url": "https://www.searchapi.io/mcp"
    }
  }
}

Cursor opens the OAuth sign-in when it first connects.

Codex

Run this command in your terminal:

codex mcp add searchapi --url https://www.searchapi.io/mcp

Codex discovers OAuth automatically. Run codex mcp login searchapi if sign-in is not opened immediately.

Any stdio-only client

Use the OAuth-aware mcp-remote bridge:

{
  "mcpServers": {
    "searchapi": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.searchapi.io/mcp"
      ]
    }
  }
}

Requires Node.js (for npx). Your browser opens for authorization on first connect.

Token Authentication

Replace YOUR_TOKEN with the token from your dashboard.

Send the token with the X-MCP-Token header — not in the URL or the Authorization header (that's reserved for OAuth).

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "searchapi": {
      "url": "https://www.searchapi.io/mcp",
      "headers": {
        "X-MCP-Token": "YOUR_TOKEN"
      }
    }
  }
}

Or install it automatically:

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "searchapi": {
      "serverUrl": "https://www.searchapi.io/mcp",
      "headers": {
        "X-MCP-Token": "YOUR_TOKEN"
      }
    }
  }
}

Windsurf uses the serverUrl key instead of url.

Codex

Add this to ~/.codex/config.toml:

[mcp_servers.searchapi]
url = "https://www.searchapi.io/mcp"
http_headers = { "X-MCP-Token" = "YOUR_TOKEN" }

VS Code

Create .vscode/mcp.json in your project root:

{
  "servers": {
    "searchapi": {
      "type": "http",
      "url": "https://www.searchapi.io/mcp",
      "headers": {
        "X-MCP-Token": "YOUR_TOKEN"
      }
    }
  }
}

Zed

Add this under context_servers in your Zed settings:

{
  "context_servers": {
    "searchapi": {
      "url": "https://www.searchapi.io/mcp",
      "headers": {
        "X-MCP-Token": "YOUR_TOKEN"
      }
    }
  }
}

OpenCode

Add this to opencode.json in your project root:

{
  "mcp": {
    "searchapi": {
      "type": "remote",
      "url": "https://www.searchapi.io/mcp",
      "enabled": true,
      "oauth": false,
      "headers": {
        "X-MCP-Token": "YOUR_TOKEN"
      }
    }
  }
}

Claude Code

Run this command in your terminal:

claude mcp add --transport http searchapi https://www.searchapi.io/mcp --header "X-MCP-Token: YOUR_TOKEN"

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "searchapi": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.searchapi.io/mcp",
        "--header",
        "X-MCP-Token:${MCP_TOKEN}"
      ],
      "env": {
        "MCP_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Restart Claude Desktop after saving. Requires Node.js (for npx).

Any other client

Bridge a stdio-only client with mcp-remote. Set MCP_TOKEN in its environment:

npx mcp-remote https://www.searchapi.io/mcp --header "X-MCP-Token:${MCP_TOKEN}"

Click any tool card to copy an example prompt you can use with your AI assistant.

Airbnb Experience Details

Airbnb Experiences Search

Airbnb Property Availability Calendar

Airbnb Property Reviews

Airbnb Property

Airbnb Search

Amazon Autocomplete

Amazon Categories

Amazon Offers

Amazon Product

Amazon Search

Apple App Details

Apple Appstore Search

Apple Appstore Top Grossing

Apple Maps Guide

Apple Maps Place Details

Apple Maps Search

Autoscout24 Listing

Autoscout24

Bestbuy Product

Bestbuy Search

Bing Maps Search

Bing News

Bing Product

Bing Search

Bing Shopping

Booking Autocomplete

Booking Property

Get Booking.com details for this booking.com hotel from September 10-17 for 2 adults

Booking

Chatgpt

Duckduckgo Search Light

Ebay Product

Ebay Search

Ebay Shipping Calculator

Facebook Business Page

Get the details of this facebook.com page

Gemini

Github Profile

Github Repository

Github Search

Github Trending

Google Ads Advertiser Search

Google Ads Search

Google Ai Mode

Google Events Details

Google Events

Simple icons/google flights

Google Flights Calendar One Way

Simple icons/google flights

Google Flights Calendar Round Trip

Simple icons/google flights

Google Flights Deals

Simple icons/google flights

Google Flights Location Search

Simple icons/google flights

Google Flights One Way

Simple icons/google flights

Google Flights Round Trip

Google Hotels Autocomplete

Google Hotels Price Calendar

Google Hotels Property

Google Hotels

Google Images Light

Google Jobs Listing

Google Jobs

Google Lens

Identify this i.ibb.co image

Google Local Services

Google Local

Google Maps Autocomplete

Google Maps Directions Search Along Route

Google Maps Directions

Google Maps Directions Transit

Google Maps Photo Meta

Google Maps Photos

Google Maps Place

Google Maps Reviews

Google Maps Search

Google News Light

Google Patents Search

Google Place Products

Google Place

Google Play Details

Google Play Search

Google Product

Google Rank Tracking

Google Reverse Image

Run a Google reverse image search on this upload.wikimedia.org image

Google Scholar Case Law

Google Scholar Cases

Google Scholar Courts

Google Scholar

Google Search Light

Google Shopping Search

Google Travel Explore Destination

Google Travel Explore

Google Vacation Rentals

Instagram Post

Instagram Profile

Linkedin Ads Search

Linkedin Job Details

Linkedin Jobs

Linkedin Top Content

Meta Ads Page Search

Meta Ads Search

Reddit Search

Skyscanner Flights

Skyscanner Hotels

Tiktok Ads Search

Tiktok Advertiser Search

Tiktok Autocomplete

Tiktok Explore

Tiktok Hashtag

Tiktok Profile Followers

Tiktok Profile Following

Tiktok Profile Live

Tiktok Profile

Tiktok Profile Videos

Tiktok Search

Tiktok Transcript

Get the transcript for this tiktok.com video

Tiktok Video

Get details for this tiktok.com video

Tripadvisor Forums Search

Tripadvisor Place

Tripadvisor Reviews

Tripadvisor

Simple icons/walmart

Walmart Product

Simple icons/walmart

Walmart Reviews

Simple icons/walmart

Walmart Search

Simple icons/walmart

Walmart Stores

Youtube Channel Lives

Youtube Channel Posts

Youtube Hashtag

Youtube Post

Get this youtube.com community post

Youtube Search

Youtube Transcript

Youtube Video

Zillow Property

Zillow Search

• Maximum 10 MCP integrations per account
• Standard API rate limits apply
• Each tool call counts as one API request