This server acts as an MCP interface for JustSerpAPI, letting you search, explore, and call JustSerpAPI endpoints (Google Search, Google Maps, Google Trends, Web scraping, and more) from any MCP-compatible AI assistant.
search_endpoints: Find the right endpoint using a natural-language query, with optional filtering by service (e.g. google_maps, google_trends, web).
get_endpoint_schema: Inspect the full parameter contract for a specific endpoint, including required/optional parameters and pagination hints.
call_endpoint: Execute any JustSerpAPI endpoint by ID with validated parameters; supports result size limiting and idempotency keys. Returns raw JSON, with large responses automatically truncated.
list_services: See all supported services (e.g. Google Search, Google Maps, Google Trends, Web) along with their endpoint counts.
get_account_balance: Check your subscription and remaining credits.
get_usage_summary: Review recent API usage, consumed credits, and endpoint trends.
refresh_catalog: Re-fetch and update the endpoint catalog from JustSerpAPI's OpenAPI documentation (admin-only).
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.
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.
Remote HTTP is the recommended setup.
{
"mcpServers": {
"justserpapi": {
"url": "https://mcp.justserpapi.com/mcp",
"headers": {
"Authorization": "Bearer your_api_key"
}
}
}
}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
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
Use your JustSerpAPI API key:
Authorization: Bearer your_api_keyFor local stdio, set:
JUSTSERPAPI_API_KEY=your_api_keysearch_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.
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.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.
MIT
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 the full schema and parameter contract for an endpoint_id returned by search_endpoints.
Inputs: endpoint_id (required).
List supported JustSerpAPI services and endpoint counts.
Inputs: no named parameters.
Admin-only. Refresh the endpoint catalog from JustSerpAPI OpenAPI documents.
Inputs: force.
Find JustSerpAPI endpoint candidates from natural language. Returns endpoint_id candidates; call get_endpoint_schema next.
Inputs: query (required), service, platform, limit, +2 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
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
