Use Primavera from Claude

What you can ask Claude

Once Primavera is connected, you ask Claude in plain words. Claude finds the area, has Primavera pick the Google Maps categories, reads the count and the cost, then creates the list when you agree. Four requests, with what Primavera counted for each on November 9, 2026:

Source: Primavera’s database, monthly snapshot 2026-11 of November 9, 2026: exact counts, service points left out. Counts for the Google Maps categories Roofing contractor, Plumber and the restaurant and bakery categories, in the city of Houston, the city of Austin, the state of Vermont and the Rhône département.

An example conversation, with real figures

The first request above, followed to the end. Claude calls Primavera’s tools one by one; the free ones run at once, and Claude asks before each paid one, with its price.

Note: An example written for this page, not a recorded session. Its figures are Primavera’s exact counts for the Google Maps category “Roofing contractor” in the city of Houston, Texas, on November 9, 2026 (snapshot 2026-11). In your own conversation, Primavera may pick other categories, and today’s count may differ.

In all, this conversation cost 100 credits on the Agency plan: the 734 businesses exported used none. On the Pro plan, the same list would cost at most 834 credits, one credit per business never delivered to the account before.

What each step costs

Primavera’s tools cost the same credits as the web app, from the same balance. Every paid tool needs a credit ceiling, maxCredits, that the call never exceeds, and a key that makes a retry safe: without them, nothing runs. Primavera’s server tells Claude to give you the cost and ask you before any paid call.

Source: Primavera’s price grid and API documentation. Agency’s exports are included up to 10% of a country’s businesses in any 30 days, 2,000,000 at most (fair use).

Set it up

1. Subscribe to Pro or Agency.
   The API and the MCP server come with both plans: Pro at $59 a month (€49 excl. VAT), Agency at $119 a month (€99 excl. VAT) with exports included. A trial account can connect and list the tools, but its first call is refused with plan_required.
2. Create an API key.
   In Primavera, open API in the menu (primaverapp.com/dashboard/api) and create a key. It shows once: keep it in the environment variable PRIMAVERA_API_KEY, never in a file you share. A key can carry a monthly credit cap, and can be revoked at any time.
3. Add Primavera’s server to Claude.
   In Claude Code, one command, which reads the key from your environment:

   claude mcp add --transport http primavera \
     https://primaverapp.com/api/mcp \
     --header "Authorization: Bearer $PRIMAVERA_API_KEY"

   In Claude Desktop and claude.ai: Customize › Connectors › Add custom connector, with the URL https://primaverapp.com/api/mcp and, under Request headers, Authorization set to Bearer followed by your key. The setup for Cursor, Codex and a project file is in the MCP section of the API documentation.
4. Ask in plain words.
   For example: “Find roofing contractors in Houston, Texas, and tell me how many have an email.” Claude reads the tools’ descriptions and the server’s instructions: you do not need to name a tool.

Questions