Prospect lists of businesses from Google Maps and their websites: target, count, export with emails.
Connect Remote server
claude mcp add --transport http primavera https://primaverapp.com/api/mcp --header "Authorization: Bearer <YOUR_API_KEY>"{
"mcpServers": {
"primavera": {
"url": "https://primaverapp.com/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}{
"servers": {
"primavera": {
"type": "http",
"url": "https://primaverapp.com/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_API_KEY>"
}
}
}
}Settings > Connectors > Add custom connector
URL: https://primaverapp.com/api/mcpReplace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools 20 found in our last check
get_accountPlan, credit balance, Agency fair use per country and rate limits of the Primavera account that owns the API key. Call it first: it tells what the account can afford. Free. Same call as GET /api/v1/account of the REST API.
find_areasFind an area from a place as written: region, département, commune, postal code, or a radius around a town ("Lyon", "33", "30 km around Nantes"). Use the "area" field of a result (or of "match" when its status is "resolved") as the area of suggest_categories or as search.area. F…
suggest_categoriesEntry point for ANY target: call it before any search, and never invent category ids. Give the target in plain words, WITHOUT the place ("independent car repair shops", "restaurants that could use an online booking tool") and the area from find_areas. Primavera's engine picks th…
find_categoriesLook up a single Google Maps category by name (French or English), with its number of places. To build a target, use suggest_categories instead; use this only to check or add one category id to search.categories.ids. Free. Same call as GET /api/v1/categories of the REST API.
find_networksLook up a brand, franchise or network by name. Use its id in search.filters.networks ({ "mode": "only" | "exclude", "ids": [...] }); mode "exclude" without ids removes every known network (independent businesses only). Free. Same call as GET /api/v1/networks of the REST API.
count_searchCount the places of a search (the "search" returned by suggest_categories). Its input describes the search object in full (target, area, filters one by one, sort): read it to edit a search. Places already delivered to the account are left out unless search.excludeDelivered is fa…
get_search_metricsThe figures of a search in one call: total, places with an email address, a phone number, a website, and the estimated number of email addresses. Free. Same call as POST /api/v1/search/metrics of the REST API.
preview_searchUp to 25 sample places of a search (name, city, category, rating, reviews). Contact details are booleans here: email addresses, phone numbers and websites only come with a list (create_list). Free. Same call as POST /api/v1/search/preview of the REST API.
estimate_listRows, cost in credits and balance after, for a list of N rows of a search (up to 50,000). Tell the user the cost, then send "cost" as maxCredits to create_list with the same search, rows and withEmail. In a rarely searched area it returns kind "zone": the list fills itself after…
create_listExport the places of a search into a new list, with their contact details (up to 50,000 rows). Price: 1 credit per place never delivered to this account (Agency: included under fair use); withEmail: only places with an email address (found ones first, then guessed and verified o…
list_listsThe lists of the account, newest first, page by page (send nextCursor back as cursor). Free. Same call as GET /api/v1/lists of the REST API.
get_listStatus of a list (creating, ready, filling, failed), rows, credits spent, progress of the export, of the guessed email addresses and of the email verification (progress.emailCheck.unverified = what verify_list_emails would cost), contents and latest jobs. While it is not ready,…
get_list_itemsRows of a ready list with every contact detail, page by page (nextCursor). Keep limit small (50 or less) and choose columns: large pages flood the conversation. For the whole list, use prepare_list_file. Free. Same call as GET /api/v1/lists/{id}/items of the REST API.
complete_listAdd places to a list from its original search; places already in the list are skipped. Priced as an export: 1 credit per place never delivered to the account (Agency: included under fair use). Paid: maxCredits (the most credits this call may spend, never exceeded) and idempotenc…
prepare_list_filePrepare the CSV file (every column) or the Excel file (the columns you choose) of a ready list. Then call get_list_file until the file is ready. A file stays available 7 days. Free. idempotencyKey (a new UUID v4) is required; reuse it only to retry the very same call. Same call…
get_list_fileStatus of a prepared file. Once it is ready, "url" is a download link valid 120 seconds: download it at once or give it to the user, and call again for a new link. Free. Same call as GET /api/v1/lists/{id}/files/{fileId} of the REST API.
estimate_list_jobEstimate a job on a list before starting it: places eligible and the most credits it can spend. Jobs: executives (company executives, France and the United States only), summary (a 3-sentence summary of each website), question (a yes/no question asked to each website), filter (a…
start_list_jobStart a job on a list; it runs in the background. Each place is billed on its result, never beyond maxCredits nor the estimate: send estimate.maxCredits of estimate_list_job, with the same tool, question, criterion and scope. Follow it with get_job; results land in get_list_item…
get_jobProgress of a job: status, places done and billed, credits spent; for a finished filter or question job, the places per verdict. Free. Same call as GET /api/v1/jobs/{id} of the REST API.
verify_list_emailsVerify the email addresses of a ready list (deliverable, risky, undeliverable): 1 credit per address that gets a verdict; the credits of the others are returned. maxCredits is the number of addresses you accept to verify: send progress.emailCheck.unverified of get_list. Paid: ma…
Headers
| Name | Description |
|---|---|
AuthorizationRequired, secret | Your Primavera API key as a Bearer token. Keys are created at https://primaverapp.com/dashboard/api (Pro or Agency subscription). |
Details
| Endpoint | https://primaverapp.com/api/mcp (Streamable HTTP) |
| First published | 12 Nov 2026 |
| Last updated | 12 Nov 2026 |
| Registry name | com.primaverapp/primavera |
More search and web servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.