MCP server
Connect the JustSERP MCP server to Claude, ChatGPT, Claude Code, Cursor or VS Code and let your AI assistant search Google, Maps, News, Shopping, YouTube and any web page.
The JustSERP MCP server gives your AI assistant Google results, Maps, News, Shopping, YouTube and any web page as tools it can call, from your JustSERP account. You ask in your own words and the assistant picks the tools itself.
https://mcp.justserp.com/mcpThis is a remote MCP server over Streamable HTTP.
Add it to your assistant
Add the server to your client, then sign in with your JustSERP account. If you do not have one yet, you can sign up on the sign-in page.
For claude.ai and Claude Desktop.
- Go to claude.ai/customize/connectors (Customize, then Connectors).
- Select Add, then Add custom connector.
- Name it
JustSerp, paste the server URL and select Continue. - Select Continue again, keep Sign in now and Use Claude's published identity, and select Add.
- Sign in with your JustSERP account (or sign up right on that page).
- In a chat, select +, then Connectors, and check that JustSerp is on.
On a Team or Enterprise plan, an owner adds the connector first, in Organization settings, then Connectors. Everyone else then selects Connect next to it in Customize, then Connectors.
Authentication
There are two ways to sign in:
- Your JustSERP account. The client opens a sign-in page (OAuth). You can sign up on that page.
- Your API key. Send it in an
X-API-Keyheader.Authorization: Bearer YOUR_KEYworks too.
See Authentication for the API key.
Tools
| Tool | What it does | Cost |
|---|---|---|
google_search | Google Search results | 1 call |
google_news | Google News articles | 1 call |
google_maps | Google Maps search: places with their ratings, addresses and phone numbers | 1 call |
google_maps_reviews | A place's Google reviews | 1 call |
google_images | Google Images | 1 call |
google_shopping | Google Shopping | 1 call |
google_trends | Google Trends | 1 call |
google_autocomplete | Google Autocomplete suggestions | 1 call |
youtube_search | YouTube Search | 1 call |
web_page | Any web page by its URL, as Markdown or HTML | 1 call |
call_engine | Any other JustSERP engine by name, such as Yelp or Tripadvisor | 1 call |
list_engines | Lists every engine, with its parameters, for call_engine | Free |
google_locations | Finds the exact place name to send as location | Free |
account | Your calls left, concurrency limit, plan and recent usage | Free |
account_calls | Your key's call log, newest first | Free |
Billing
Each search uses one of your JustSERP API calls. Calls that fail are not charged. list_engines, google_locations, account and account_calls are free. See Errors & billing.
Example prompts
Ask in your own words. A few things you might ask in a working day:
| Area | Prompt | Tools |
|---|---|---|
| SEO | Which sites are on Google's first page for "emergency plumber" in Manchester, UK? | google_locations, google_search |
| Local | List coffee shops near Union Square, San Francisco, rated 4.5 or higher, with their addresses and phone numbers. | google_maps |
| Reviews | Read the newest Google reviews of the three best-rated dentists in Leeds. What do patients praise, and what do they complain about? | google_maps, google_maps_reviews |
| Shopping | Compare prices for the Sony WH-1000XM5 across stores, cheapest first, with links. | google_shopping |
| Reading | Read stripe.com/pricing and put the card fees in a table. | web_page |
| Beyond Google | Find the top-rated Thai restaurants in Chicago on Yelp. | list_engines, call_engine |
You can also ask "How many JustSERP calls do I have left?" whenever you like: the account tool answers it, for free.
Get started
The full setup guide is at mcp.justserp.com. To get an account, sign up.
Authentication
Authenticate JustSERP API requests with your API key in the X-API-Key header, as an Authorization Bearer token or as the apikey query parameter, and see the 401 and 403 responses.
Parameters
The query parameters for every JustSERP endpoint, and how to encode them: shared fields, Google search inputs, AI question and location, reviews profiles and place ids.