justserpapi-mcp
OfficialAn MCP server for discovering, inspecting, and calling JustSerpAPI endpoints, with catalog/service helpers.
Search for endpoint candidates from natural-language queries, with optional service/platform and hidden/deprecated filters.
Inspect an endpoint’s full schema and required/optional parameter contract.
Call an endpoint by ID with validated parameters, max result items, and optional idempotency key.
List supported JustSerpAPI services and endpoint counts.
Refresh the endpoint catalog from JustSerpAPI OpenAPI documents (admin-only).
The README also advertises account-balance and usage-summary tools, but those are not present in the provided schema.
Provides tools to search Google, access Google Trends, and retrieve Google Shopping results via the JustSerpAPI.
Provides tools to query Google Maps for reviews and other location data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@justserpapi-mcp Search Google for "best running shoes" in the United States."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
JustSERPAPI MCP Server
Use JustSERPAPI from Codex, Claude Desktop, Cursor, and other MCP-compatible AI assistants.
This MCP server helps your assistant find the right JustSERPAPI endpoint, inspect the required parameters, call the API, and continue paginated results when the API returns a next-page token or offset.
Quick Start
Remote HTTP
Remote HTTP is the recommended setup.
{
"mcpServers": {
"justserpapi": {
"url": "https://mcp.justserpapi.com/mcp",
"headers": {
"Authorization": "Bearer your_api_key"
}
}
}
}Local stdio
You can also run the MCP server locally with npx.
{
"mcpServers": {
"justserpapi": {
"command": "npx",
"args": ["-y", "justserpapi-mcp"],
"env": {
"JUSTSERPAPI_API_KEY": "your_api_key"
}
}
}
}Related MCP server: tavily-mcp
Supported Clients
JustSERPAPI MCP works with MCP-compatible clients that support remote HTTP or local stdio servers, including:
Codex
Claude Desktop
Cursor
Claude Code
OpenAI Agents SDK
Other MCP-compatible AI assistants
Authentication
Use your JustSERPAPI API key:
Authorization: Bearer your_api_keyFor local stdio, set:
JUSTSERPAPI_API_KEY=your_api_keyAvailable Tools
search_endpoints: Find the best JustSERPAPI endpoint from a natural-language request.get_endpoint_schema: Inspect required parameters, optional parameters, and pagination hints.call_endpoint: Call a JustSERPAPI endpoint and return raw JSON data.get_account_balance: Check your subscription and remaining credits.get_usage_summary: Review recent API usage, consumed credits, and endpoint trends.list_services: List available services such as Google Search, Google Maps, Google Trends, and Web.refresh_catalog: Refresh the endpoint catalog from JustSERPAPI docs.
Example Prompts
Ask your AI assistant naturally:
Find the Google search API and show me the required parameters.Search Google for "best running shoes" in the United States.Find the Google Maps reviews endpoint and tell me how to request the next page.Get Google Trends trending-now results for the US.Find the Google Shopping search API and call it for "iphone 16 case".Convert this web page to Markdown: https://example.comContinue to the next page of the previous JustSERPAPI result.Check my remaining JustSERPAPI credits.Show my API usage for the last 30 days.The API returned code 402. Explain what it means and what I should check.Response Format
call_endpoint returns the JustSERPAPI response data as raw JSON. Large arrays
and long text fields may be shortened so the AI assistant can read the result
reliably. When that happens, the response includes truncated: true and the
paths that were shortened.
License
MIT
Available Tools
5 toolscall_endpointB
Validate params and call a JustSerpAPI endpoint by endpoint_id. Params should use snake_case names from get_endpoint_schema.
Inputs: endpoint_id (required), params, max_items, idempotency_key.
get_endpoint_schemaA
Get the full schema and parameter contract for an endpoint_id returned by search_endpoints.
Inputs: endpoint_id (required).
list_servicesA
List supported JustSerpAPI services and endpoint counts.
Inputs: no named parameters.
refresh_catalogB
Admin-only. Refresh the endpoint catalog from JustSerpAPI OpenAPI documents.
Inputs: force.
search_endpointsA
Find JustSerpAPI endpoint candidates from natural language. Returns endpoint_id candidates; call get_endpoint_schema next.
Inputs: query (required), service, platform, limit, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: list_services lists available services, search_endpoints finds endpoint candidates, get_endpoint_schema retrieves parameter details for a specific endpoint, call_endpoint executes the API call, and refresh_catalog updates the endpoint catalog. There is no ambiguity or overlap between tools.
All tool names follow a consistent verb_noun pattern using snake_case: list_services, search_endpoints, get_endpoint_schema, call_endpoint, refresh_catalog. The naming style is uniform and predictable.
With 5 tools, the server is lightweight but well-scoped for its purpose of interacting with JustSerpAPI endpoints. It covers the essential workflow of discovering services, searching for endpoints, getting schemas, making calls, and refreshing data. The count feels appropriate, though slightly on the smaller side.
The tool set covers the core lifecycle: discovery (list_services, search_endpoints), parameter retrieval (get_endpoint_schema), execution (call_endpoint), and maintenance (refresh_catalog). There are minor gaps such as missing error handling or status checking tools, but the surface is complete enough for typical usage.
Maintenance
Related MCP Connectors
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Google SERP, Maps, Shopping, News and AI-answer data for AI agents, from the Searlo search API.
Web search, scraping, Google Trends and data lookups. Paid per call in USDC on Base via x402.
Search Google straight from your AI agent. Web results, images, videos, news, products, scholarly ar
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceIntegrates with SerpAPI and YouTube to provide comprehensive search capabilities across Google Search, News, Scholar, Trends, Finance, Maps, Images, YouTube, and transcript retrieval for AI assistants.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform real-time web searches, extract data from web pages, map website structures, and crawl websites using the Tavily API.85 npmMIT
- FlicenseNot gradedqualityAmaintenanceIntegrates with SerpApi to enable comprehensive, multi-engine search and data extraction across Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay and more, returning real-time results such as weather and stock data in JSON or Markdown. Supports flexible response modes, per-engine parameter schemas, and optional interactive UI rendering.-
- FlicenseNot gradedqualityAmaintenanceEnables querying Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay and other engines through SerpApi, returning search results, weather, stock data, and more in JSON or Markdown. Supports per-engine parameter schemas and interactive table or dashboard views.-