health_checkLABSCO SUMMARY
Search, then act on the result — the whole chain on one key.
Most search servers stop at the ten blue links. This one carries on into the work that usually follows a lookup: find the flight, price the dates, find the hotel, read what people said about the restaurant. Read it as a search plumbing layer — careful about caching and failure, and bounded by whatever your SearchAPI.io plan allows.
What it is
A Python server that puts SearchAPI.io's Google endpoints in front of an assistant. Web, video and AI-overview search sit alongside Maps, Events, Flights and Hotels, so a question and the booking-shaped work that follows it are answered from one vendor. Underneath, calls are pooled and cached with a configurable TTL, retried with exponential backoff, and cut off by a circuit breaker when the upstream starts failing.
What you get
- Google web search with the knowledge graph and answer box, filtered by location, language, time period and safe search
- An AI-overview mode that returns a generated summary with its cited sources, structured content blocks and the ordinary results underneath
- Video search filtered by upload time and device
- Maps place search, a place's own detail record with hours, photos and amenities, and its reviews sorted by date or rating
- Event search for concerts, conferences and festivals, narrowed by a date chip such as weekend or month
- Flight search with class, stops and passenger filters, a price calendar for flexible dates, and airport-code lookup
- Destination discovery by interest and travel period, for when the departure airport is fixed and nothing else is
- Hotel search by rating, class, price range, amenities and free cancellation, down to a single property's detail for given dates
- A clock tool that returns today's date and a run of future dates in the format the travel calls expect
- A health check reporting API connectivity, latency, circuit-breaker state, cache statistics and error counts
Requirements
Python 3.10 or newer and a SearchAPI.io key in the environment; it runs from a clone after pip install -r requirements.txt (the README's uvx --from git+… shortcut fails, because the repository defines no installable package), and the client configurations in the repository cover Claude Desktop, VS Code, Zed and Cline. The searches themselves are billed by SearchAPI.io under your plan, and its rate limits are what the retry logic is backing off from. Everything in a query is sent to SearchAPI.io; responses are cached locally, which you can turn off. On Windows, set the client's environment to UTF-8 encoding or non-ASCII results will fail to render.
Setup effort
Build from source — git clone https://github.com/RmMargt/searchAPI-mcp.git
USE CASES
01
Planning a trip without leaving the conversation
Look up the airport code, explore destinations from it by interest, check the price calendar for flexible dates, then search flights and hotels and open one property's detail for the dates you settle on. The clock tool supplies the dates, so nothing is planned against yesterday.
02
Checking what a place is actually like before you commit
Search Maps for candidates near a location, pull the detail record for hours, photos and amenities, then read the reviews sorted by newest or by rating.
03
Getting an answer with its sources attached
AI mode returns a generated overview with reference links and structured blocks, plus the ordinary web results underneath, so the model can quote a source instead of paraphrasing from memory.
04
Finding what is on in a city that weekend
Event search takes a query and a date chip — today, tomorrow, weekend, month — and returns concerts, conferences and festivals for a named location.
05
Watching recent video coverage of a topic
Video search filters by upload time and device, which is the difference between what has been said about something and what has been said this week.
15 tools
Listed in project docs. Your client may show a different list.
get_current_timesearch_googlesearch_google_videossearch_google_ai_modesearch_google_mapssearch_google_maps_placesearch_google_maps_reviewssearch_google_eventssearch_google_flightssearch_google_flights_calendarsearch_google_flights_location_searchsearch_google_travel_exploresearch_google_hotelssearch_google_hotels_propertyBEFORE YOU INSTALL
What to know first
Tools you get
15 tools named in the project's documentation.
Requires
- Python 3.10 or later
- SEARCHAPI_API_KEY in your environment
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/RmMargt/searchAPI-mcp.git
cd searchAPI-mcp
pip install -r requirements.txtMCP Clients
VS Code
VS CODE · JSON
{
"servers": {
"searchapi": {
"command": "python",
"args": [
"<YOUR_PATH_TO_SEARCH_API_MCP>/mcp_server_refactored.py"
],
"env": {
"SEARCHAPI_API_KEY": "<YOUR_SEARCHAPI_API_KEY>"
}
}
}
}Zed
ZED · JSON
{
"context_servers": {
"searchapi": {
"command": {
"path": "python",
"args": [
"<YOUR_PATH_TO_SEARCH_API_MCP>/mcp_server_refactored.py"
],
"env": {
"SEARCHAPI_API_KEY": "<YOUR_SEARCHAPI_API_KEY>"
}
}
}
}
}Cline
CLINE · JSON
{
"mcpServers": {
"searchapi": {
"command": "python",
"args": [
"<YOUR_PATH_TO_SEARCH_API_MCP>/mcp_server_refactored.py"
],
"env": {
"SEARCHAPI_API_KEY": "<YOUR_SEARCHAPI_API_KEY>"
}
}
}
}Any MCP client
ANY MCP CLIENT · TERMINAL
python <YOUR_PATH_TO_SEARCH_API_MCP>/mcp_server_refactored.py
