Endpoints: 76,849MCP servers: 32,730Payout addresses: 3,825Paid calls: 6,160Letters: 84Defects: 3,898counted 4 min ago
teppi

Server definition

Hash
sha256:c09ab43e95248f182efe1777c99f2c6b25c343fb29e7aa169f82698876fd9005
What it is
What a remote MCP server returned when asked what it offers: 20 tools

The blob, as servednamed by its sha256

{ "instructions": "Primavera is a B2B database of businesses: Google Maps places in France and other countries, read with their websites (email addresses, phone numbers, social networks, technologies). These tools act on the Primavera account that owns the API key, with the same balance and the same prices as the web app (https://primaverapp.com).\n\nTo build a prospect list:\n1. get_account: plan and credit balance.\n2. find_areas: the place as an area.\n3. suggest_categories (100 credits): the target in plain words becomes categories and a \"search\" object. Never invent category ids.\n4. count_search, get_search_metrics, preview_search, estimate_list: free. Show the user the figures and the cost.\n5. create_list (paid): send the \"cost\" of estimate_list as maxCredits, once the user agreed.\n6. get_list until it is \"ready\", then prepare_list_file and get_list_file for a CSV or Excel link, or get_list_items for a few rows.\n7. Optional, paid: estimate_list_job then start_list_job (executives, website summary, question to the website, AI filter), and verify_list_emails.\n\nMoney: every paid tool needs maxCredits (never exceeded) and idempotencyKey (a new UUID v4 per operation); without them nothing runs. To retry the same operation, send the same idempotencyKey and the same arguments: nothing is charged twice; never reuse a key for another operation. Ask the user before any paid call and tell the cost first.\n\nA refused call returns {\"error\": {\"code\", \"message\", \"hint\"}}: do what the hint says, never retry in a loop, wait the seconds given when there is a retry delay. Hints name the REST routes of the same API: GET /api/v1/account = get_account; GET /api/v1/areas = find_areas; POST /api/v1/categories/suggest = suggest_categories; GET /api/v1/categories = find_categories; GET /api/v1/networks = find_networks; POST /api/v1/search/count = count_search; POST /api/v1/search/metrics = get_search_metrics; POST /api/v1/search/preview = preview_search; POST /api/v1/search/estimate = estimate_list; POST /api/v1/lists = create_list; GET /api/v1/lists = list_lists; GET /api/v1/lists/{id} = get_list; GET /api/v1/lists/{id}/items = get_list_items; POST /api/v1/lists/{id}/complete = complete_list; POST /api/v1/lists/{id}/files = prepare_list_file; GET /api/v1/lists/{id}/files/{fileId} = get_list_file; POST /api/v1/lists/{id}/jobs/estimate = estimate_list_job; POST /api/v1/lists/{id}/jobs = start_list_job; GET /api/v1/jobs/{id} = get_job; POST /api/v1/lists/{id}/email-check = verify_list_emails.\n\nWhen a figure comes with exact: false, say \"≈ N\". Previews never show contact details: they only come with a list. Some texts come from the product in French (selection.message, questions, notes): translate them for the user.", "tools": [ { "description": "Add 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).\n\nPaid: maxCredits (the most credits this call may spend, never exceeded) and idempotencyKey (a new UUID v4 for this operation) are required; without them nothing runs. To retry after an error or a timeout, send the same idempotencyKey with the same arguments: nothing is charged twice. Ask the user before calling it.\n\nSame call as POST /api/v1/lists/{id}/complete of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "A new UUID v4 for this operation (sent as the Idempotency-Key of the API). Reuse it only to retry the very same call: the saved result comes back, nothing is charged twice.", "format": "uuid", "type": "string" }, "listId": { "description": "Id of a list of the account (from create_list or list_lists).", "format": "uuid", "type": "string" }, "maxCredits": { "description": "The most credits this call may spend (required on every paid call, with an Idempotency-Key header). Never exceeded.", "maximum": 1000000000, "minimum": 0, "type": "integer" }, "rows": { "description": "Places to add from the original search (places already in the list are skipped).", "maximum": 50000, "minimum": 1, "type": "integer" } }, "required": [ "listId", "rows", "maxCredits", "idempotencyKey" ], "type": "object" }, "name": "complete_list", "outputSchema": null }, { "description": "Count 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 false. When \"exact\" is false, say \"≈ N\".\n\nFree.\n\nSame call as POST /api/v1/search/count of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "search": { "additionalProperties": false, "description": "The search, as returned by POST /categories/suggest (field \"search\"). Send it back as is, edited if needed.", "properties": { "area": { "description": "The area, as returned by /areas (area field). Default: the whole country.", "oneOf": [ { "additionalProperties": false, "properties": { "type": { "const": "country", "type": "string" }, "withoutOverseas": { "const": true, "type": "boolean" } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "codes": { "items": { "pattern": "^[A-Za-z0-9-]{1,40}$", "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" }, "type": { "const": "region", "type": "string" } }, "required": [ "type", "codes" ], "type": "object" }, { "additionalProperties": false, "properties": { "codes": { "items": { "pattern": "^[A-Za-z0-9-]{1,40}$", "type": "string" }, "maxItems": 110, "minItems": 1, "type": "array" }, "type": { "const": "departement", "type": "string" } }, "required": [ "type", "codes" ], "type": "object" }, { "additionalProperties": false, "properties": { "codes": { "items": { "pattern": "^[A-Za-z0-9-]{1,40}$", "type": "string" }, "maxItems": 1000, "minItems": 1, "type": "array" }, "type": { "const": "commune", "type": "string" } }, "required": [ "type", "codes" ], "type": "object" }, { "additionalProperties": false, "properties": { "codes": { "items": { "pattern": "^[A-Za-z0-9 -]{2,10}$", "type": "string" }, "maxItems": 1000, "minItems": 1, "type": "array" }, "type": { "const": "postal", "type": "string" } }, "required": [ "type", "codes" ], "type": "object" }, { "additionalProperties": false, "properties": { "km": { "maximum": 500, "minimum": 0.1, "type": "number" }, "lat": { "maximum": 90, "minimum": -90, "type": "number" }, "lng": { "maximum": 180, "minimum": -180, "type": "number" }, "type": { "const": "radius", "type": "string" } }, "required": [ "type", "lat", "lng", "km" ], "type": "object" } ] }, "categories": { "additionalProperties": false, "description": "The target. Absent or empty: every category of the area.", "properties": { "concepts": { "description": "Legacy trade ids of older searches. Prefer groups.", "items": { "pattern": "^[a-z0-9_]{2,60}$", "type": "string" }, "maxItems": 40, "type": "array" }, "groups": { "description": "Category groups (label and category ids), disjoint, as returned by /categories/suggest. Remove a group to narrow the target.", "items": { "additionalProperties": false, "properties": { "ids": { "items": { "exclusiveMinimum": 0, "type": "integer" }, "maxItems": 600, "minItems": 1, "type": "array" }, "label": { "maxLength": 60, "minLength": 1, "type": "string" }, "prudence": { "const": true, "description": "True when the engine added this group by prudence (a neighbouring activity, not the core of the request): a list delivers the core of the request first.", "type": "boolean" } }, "required": [ "label", "ids" ], "type": "object" }, "maxItems": 8, "type": "array" }, "ids": { "description": "Single category ids (from /categories), outside the groups.", "items": { "exclusiveMinimum": 0, "type": "integer" }, "maxItems": 2000, "type": "array" }, "mode": { "description": "'primary_or_generic' (default): the main category is in the list, or a secondary one when the main one is generic; 'primary': main category only; 'any': main or secondary (broader, less precise).", "enum": [ "primary_or_generic", "primary", "any" ], "type": "string" }, "request": { "description": "The target as the user wrote it: title of the search and default list name. Set by /categories/suggest.", "maxLength": 600, "minLength": 1, "type": "string" } }, "type": "object" }, "country": { "description": "ISO 3166-1 alpha-2 code, lower case (default fr). Only open countries are searchable.", "enum": [ "af", "za", "al", "dz", "de", "ad", "ao", "ai", "ag", "sa", "ar", "am", "aw", "au", "at", "az", "bs", "bh", "bd", "bb", "be", "bz", "bj", "bm", "bt", "bo", "ba", "bw", "br", "bn", "bg", "bf", "bi", "kh", "cm", "ca", "cv", "cl", "cn", "cy", "co", "km", "cg", "cd", "kr", "cr", "ci", "hr", "cw", "dk", "dj", "dm", "eg", "ae", "ec", "er", "es", "ee", "sz", "va", "us", "et", "fj", "fi", "fr", "ga", "gm", "ge", "gh", "gi", "gr", "gd", "gl", "gu", "gt", "gg", "gn", "gq", "gw", "gy", "ht", "hn", "hu", "cx", "im", "nf", "ax", "ky", "cc", "ck", "fo", "fk", "mp", "mh", "pn", "sb", "tc", "vg", "vi", "in", "id", "iq", "ie", "is", "il", "it", "jm", "jp", "je", "jo", "kz", "ke", "kg", "ki", "xk", "kw", "la", "ls", "lv", "lb", "lr", "ly", "li", "lt", "lu", "mk", "mg", "my", "mw", "mv", "ml", "mt", "ma", "mu", "mr", "mx", "fm", "md", "mc", "mn", "me", "ms", "mz", "mm", "na", "nr", "np", "ni", "ne", "ng", "nu", "no", "nz", "om", "ug", "uz", "pk", "pw", "pa", "pg", "py", "nl", "bq", "pe", "ph", "pl", "pr", "pt", "qa", "hk", "mo", "cf", "do", "ro", "gb", "rw", "kn", "sm", "sx", "vc", "sh", "lc", "sv", "ws", "as", "st", "sn", "rs", "sc", "sl", "sg", "sk", "si", "so", "sd", "ss", "lk", "se", "ch", "sr", "sj", "tj", "tw", "tz", "td", "cz", "io", "ps", "th", "tl", "tg", "tk", "to", "tt", "tn", "tm", "tr", "tv", "ua", "uy", "vu", "ve", "vn", "ye", "zm", "zw" ], "type": "string" }, "excludeDelivered": { "default": true, "description": "Leave out the places already delivered to your account: not counted, never billed twice. Default true.", "type": "boolean" }, "excludedCategoryIds": { "description": "Categories to remove from the target.", "items": { "exclusiveMinimum": 0, "type": "integer" }, "maxItems": 2000, "type": "array" }, "excludedConcepts": { "description": "Legacy trade ids to remove.", "items": { "pattern": "^[a-z0-9_]{2,60}$", "type": "string" }, "maxItems": 40, "type": "array" }, "filters": { "additionalProperties": false, "properties": { "companyAgeMax": { "description": "France only: company created at least / less than N years ago.", "maximum": 200, "minimum": 1, "type": "integer" }, "companyAgeMin": { "description": "France only: company created at least / less than N years ago.", "maximum": 200, "minimum": 0, "type": "integer" }, "companyCategories": { "description": "France only: \"PME\", \"ETI\", \"GE\" (INSEE company size category).", "items": { "enum": [ "PME", "ETI", "GE" ], "type": "string" }, "maxItems": 3, "minItems": 1, "type": "array" }, "emailStatus": { "description": "Places with an email address: send [\"deliverable\",\"catch_all\",\"unverified\"] (all three). Prefer withEmail on /search/estimate and POST /lists.", "items": { "enum": [ "deliverable", "catch_all", "unverified" ], "type": "string" }, "maxItems": 3, "minItems": 1, "type": "array" }, "excludeServicePoints": { "default": true, "description": "Remove service points (parcel lockers, charging stations, ATMs): nobody to talk to. Default true.", "type": "boolean" }, "hasContactForm": { "description": "The website has a contact form.", "type": "boolean" }, "hasPhone": { "description": "true: places with a phone number.", "type": "boolean" }, "hasWebsite": { "description": "true: places with a website; false: without.", "type": "boolean" }, "headcountMax": { "description": "France only: company headcount bounds (INSEE brackets fully inside the bounds).", "maximum": 100000, "minimum": 0, "type": "integer" }, "headcountMin": { "description": "France only: company headcount bounds (INSEE brackets fully inside the bounds).", "maximum": 100000, "minimum": 0, "type": "integer" }, "hideHiddenCategories": { "default": true, "description": "Hide categories nobody prospects (bus stops, car parks…). Default true.", "type": "boolean" }, "hotelStarsMin": { "description": "Hotels: minimum stars.", "maximum": 5, "minimum": 1, "type": "integer" }, "includeClosed": { "default": false, "description": "Include permanently closed places (default false).", "type": "boolean" }, "legalForms": { "description": "France only: INSEE legal category codes (\"5\", \"57\", \"5710\").", "items": { "pattern": "^(?:\\d|\\d{2}|\\d{4})$", "type": "string" }, "maxItems": 30, "minItems": 1, "type": "array" }, "naf": { "description": "France only: NAF rev. 2 activity codes of any level (\"56\", \"56.10A\"). Keeps places whose company is known in the French registry.", "items": { "pattern": "^(?:[A-U]|\\d{2}(?:\\.\\d(?:\\d[A-Z]?)?)?)$", "type": "string" }, "maxItems": 40, "minItems": 1, "type": "array" }, "nameContains": { "description": "Part of the name (accents and case ignored), 2 to 100 characters.", "maxLength": 100, "minLength": 2, "type": "string" }, "networks": { "additionalProperties": false, "description": "{ \"mode\": \"exclude\" | \"only\", \"ids\"?: [...] }: brands and networks (ids from GET /networks). Without ids, \"exclude\" removes every confirmed network (\"independent\" businesses).", "properties": { "ids": { "items": { "pattern": "^[a-z0-9_]{2,60}$", "type": "string" }, "maxItems": 50, "minItems": 1, "type": "array" }, "mode": { "enum": [ "exclude", "only" ], "type": "string" } }, "required": [ "mode" ], "type": "object" }, "onePer": { "additionalProperties": false, "description": "France only: { \"by\": \"entreprise\" | \"groupe\", \"keep\"?: \"siege\" | \"classement\" }: one place per company or group (head office first, or best ranked). Places without a known company all stay.", "properties": { "by": { "enum": [ "entreprise", "groupe" ], "type": "string" }, "keep": { "default": "siege", "enum": [ "siege", "classement" ], "type": "string" } }, "required": [ "by" ], "type": "object" }, "ownEmailOnly": { "description": "Only places whose email address is not shared with other places (an address common to a whole network leads to the network, not to this place).", "type": "boolean" }, "pixels": { "description": "At least one of these advertising pixels (Meta Pixel, Google Ads…).", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" }, "ratingMax": { "description": "Google rating bounds.", "maximum": 5, "minimum": 1, "type": "number" }, "ratingMin": { "description": "Google rating bounds.", "maximum": 5, "minimum": 1, "type": "number" }, "reviewsMax": { "description": "Number of Google reviews bounds.", "minimum": 0, "type": "integer" }, "reviewsMin": { "description": "Number of Google reviews bounds.", "minimum": 0, "type": "integer" }, "socials": { "description": "Every listed social network is linked from the website: facebook, instagram, linkedin, youtube, twitter, tiktok, pinterest, threads.", "items": { "enum": [ "facebook", "instagram", "linkedin", "youtube", "twitter", "tiktok", "pinterest", "threads" ], "type": "string" }, "maxItems": 8, "minItems": 1, "type": "array" }, "technologies": { "description": "At least one of these website technologies (WordPress, Wix, Shopify…).", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 30, "minItems": 1, "type": "array" }, "websiteReachable": { "description": "true: the website answered when last read.", "type": "boolean" } }, "type": "object" }, "sort": { "description": "Row order of previews and lists: 'default', 'reviews_desc', 'rating_desc', 'name_asc'.", "enum": [ "default", "reviews_desc", "rating_desc", "name_asc" ], "type": "string" }, "version": { "const": 1, "type": "number" } }, "type": "object" } }, "required": [ "search" ], "type": "object" }, "name": "count_search", "outputSchema": null }, { "description": "Export 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 ones); verifyEmails: plus 1 credit per address verified. maxCredits is never exceeded: send the \"cost\" of estimate_list, once the user agreed. One export at a time per account. While the list says \"creating\", follow it with get_list.\n\nPaid: maxCredits (the most credits this call may spend, never exceeded) and idempotencyKey (a new UUID v4 for this operation) are required; without them nothing runs. To retry after an error or a timeout, send the same idempotencyKey with the same arguments: nothing is charged twice. Ask the user before calling it.\n\nSame call as POST /api/v1/lists of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "A new UUID v4 for this operation (sent as the Idempotency-Key of the API). Reuse it only to retry the very same call: the saved result comes back, nothing is charged twice.", "format": "uuid", "type": "string" }, "maxCredits": { "description": "The most credits this call may spend (required on every paid call, with an Idempotency-Key header). Never exceeded.", "maximum": 1000000000, "minimum": 0, "type": "integer" }, "name": { "description": "List name, as shown in \"My lists\".", "maxLength": 120, "minLength": 1, "type": "string" }, "rows": { "description": "Rows wanted (at most 50000). With withEmail: email addresses wanted. Required unless wholeArea is true.", "maximum": 50000, "minimum": 1, "type": "integer" }, "search": { "description": "The search, as returned by /categories/suggest (then narrowed with /areas, filters…). The \"search\" object returned by suggest_categories (target, area, filters, sort), sent as is or edited; its full schema is the \"search\" input of count_search. An invalid search is refused with invalid_request and the fields to fix.", "type": "object" }, "verifyEmails": { "description": "true = the \"Verify emails\" box of the app: the addresses this list delivers are verified (deliverable, risky, undeliverable), 1 credit per address, reserved at creation and inside maxCredits (send maxCredits ≥ export cost + rows); unused credits are returned. Up to 10000 rows; not for rarely searched areas; included in withEmail lists.", "type": "boolean" }, "wholeArea": { "description": "Rarely searched area only (estimate returned kind \"zone\"): fill the list with the whole area instead of a number of rows.", "type": "boolean" }, "withEmail": { "description": "true = the \"With email\" choice of the app: places with an email address only; found addresses are delivered first, others are guessed on the websites then checked (1 credit per valid address), and the verification of the addresses is reserved at creation (1 credit per address, unused credits returned).", "type": "boolean" } }, "required": [ "name", "search", "maxCredits", "idempotencyKey" ], "type": "object" }, "name": "create_list", "outputSchema": null }, { "description": "Rows, 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 creation (create_list with maxCredits ≥ zoneEstimate.creditCap).\n\nFree.\n\nSame call as POST /api/v1/search/estimate of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "rows": { "description": "Rows wanted in the list (default 500, at most 50000).", "maximum": 50000, "minimum": 1, "type": "integer" }, "search": { "description": "The search, as returned by POST /categories/suggest (field \"search\"). Send it back as is, edited if needed. The \"search\" object returned by suggest_categories (target, area, filters, sort), sent as is or edited; its full schema is the \"search\" input of count_search. An invalid search is refused with invalid_request and the fields to fix.", "type": "object" }, "withEmail": { "description": "True: a list of places WITH an email address (found addresses first, then guessed and checked ones, each address checked at 1 credit). False: the email filter is removed. Absent: the search as is.", "type": "boolean" } }, "required": [ "search" ], "type": "object" }, "name": "estimate_list", "outputSchema": null }, { "description": "Estimate 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 criterion judged on the data we hold, no website read).\n\nFree.\n\nSame call as POST /api/v1/lists/{id}/jobs/estimate of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "criterion": { "description": "tool \"filter\" only.", "maxLength": 300, "minLength": 3, "type": "string" }, "listId": { "description": "Id of a list of the account (from create_list or list_lists).", "format": "uuid", "type": "string" }, "question": { "description": "tool \"question\" only.", "maxLength": 300, "minLength": 5, "type": "string" }, "scope": { "description": "Places the job runs on: the whole list (default), the places a finished qualification judged conforming, or those it could not decide.", "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "all", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "properties": { "jobId": { "description": "A finished filter or question job of this list.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "kind": { "const": "conforming", "type": "string" } }, "required": [ "kind", "jobId" ], "type": "object" }, { "additionalProperties": false, "properties": { "jobId": { "description": "A finished filter or question job of this list: only its \"undetermined\" places.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "kind": { "const": "undetermined", "type": "string" } }, "required": [ "kind", "jobId" ], "type": "object" } ] }, "tool": { "description": "executives: company executives (France and the United States only); summary: 3-sentence summary of the website; question: a yes/no question asked to the website; filter: a criterion judged on the data we hold (no website read).", "enum": [ "executives", "summary", "question", "filter" ], "type": "string" } }, "required": [ "listId", "tool" ], "type": "object" }, "name": "estimate_list_job", "outputSchema": null }, { "description": "Find 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.\n\nFree.\n\nSame call as GET /api/v1/areas of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "country": { "description": "Search this country only (ISO alpha-2, lower case). Default: every open country.", "enum": [ "af", "za", "al", "dz", "de", "ad", "ao", "ai", "ag", "sa", "ar", "am", "aw", "au", "at", "az", "bs", "bh", "bd", "bb", "be", "bz", "bj", "bm", "bt", "bo", "ba", "bw", "br", "bn", "bg", "bf", "bi", "kh", "cm", "ca", "cv", "cl", "cn", "cy", "co", "km", "cg", "cd", "kr", "cr", "ci", "hr", "cw", "dk", "dj", "dm", "eg", "ae", "ec", "er", "es", "ee", "sz", "va", "us", "et", "fj", "fi", "fr", "ga", "gm", "ge", "gh", "gi", "gr", "gd", "gl", "gu", "gt", "gg", "gn", "gq", "gw", "gy", "ht", "hn", "hu", "cx", "im", "nf", "ax", "ky", "cc", "ck", "fo", "fk", "mp", "mh", "pn", "sb", "tc", "vg", "vi", "in", "id", "iq", "ie", "is", "il", "it", "jm", "jp", "je", "jo", "kz", "ke", "kg", "ki", "xk", "kw", "la", "ls", "lv", "lb", "lr", "ly", "li", "lt", "lu", "mk", "mg", "my", "mw", "mv", "ml", "mt", "ma", "mu", "mr", "mx", "fm", "md", "mc", "mn", "me", "ms", "mz", "mm", "na", "nr", "np", "ni", "ne", "ng", "nu", "no", "nz", "om", "ug", "uz", "pk", "pw", "pa", "pg", "py", "nl", "bq", "pe", "ph", "pl", "pr", "pt", "qa", "hk", "mo", "cf", "do", "ro", "gb", "rw", "kn", "sm", "sx", "vc", "sh", "lc", "sv", "ws", "as", "st", "sn", "rs", "sc", "sl", "sg", "sk", "si", "so", "sd", "ss", "lk", "se", "ch", "sr", "sj", "tj", "tw", "tz", "td", "cz", "io", "ps", "th", "tl", "tg", "tk", "to", "tt", "tn", "tm", "tr", "tv", "ua", "uy", "vu", "ve", "vn", "ye", "zm", "zw" ], "type": "string" }, "level": { "description": "Only this level of area.", "enum": [ "region", "departement", "commune" ], "type": "string" }, "limit": { "description": "Areas returned (default 10, at most 20).", "maximum": 20, "minimum": 1, "type": "integer" }, "q": { "description": "A place as written: \"Lyon\", \"31000\", \"Gironde\", \"within 30 km of Nantes\", \"the South-West\".", "maxLength": 120, "minLength": 2, "type": "string" }, "radiusKm": { "description": "A radius around the place, in km (1 to 200).", "maximum": 200, "minimum": 1, "type": "number" } }, "required": [ "q" ], "type": "object" }, "name": "find_areas", "outputSchema": null }, { "description": "Look 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.\n\nFree.\n\nSame call as GET /api/v1/categories of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "country": { "description": "Counts are those of this country (default fr).", "enum": [ "af", "za", "al", "dz", "de", "ad", "ao", "ai", "ag", "sa", "ar", "am", "aw", "au", "at", "az", "bs", "bh", "bd", "bb", "be", "bz", "bj", "bm", "bt", "bo", "ba", "bw", "br", "bn", "bg", "bf", "bi", "kh", "cm", "ca", "cv", "cl", "cn", "cy", "co", "km", "cg", "cd", "kr", "cr", "ci", "hr", "cw", "dk", "dj", "dm", "eg", "ae", "ec", "er", "es", "ee", "sz", "va", "us", "et", "fj", "fi", "fr", "ga", "gm", "ge", "gh", "gi", "gr", "gd", "gl", "gu", "gt", "gg", "gn", "gq", "gw", "gy", "ht", "hn", "hu", "cx", "im", "nf", "ax", "ky", "cc", "ck", "fo", "fk", "mp", "mh", "pn", "sb", "tc", "vg", "vi", "in", "id", "iq", "ie", "is", "il", "it", "jm", "jp", "je", "jo", "kz", "ke", "kg", "ki", "xk", "kw", "la", "ls", "lv", "lb", "lr", "ly", "li", "lt", "lu", "mk", "mg", "my", "mw", "mv", "ml", "mt", "ma", "mu", "mr", "mx", "fm", "md", "mc", "mn", "me", "ms", "mz", "mm", "na", "nr", "np", "ni", "ne", "ng", "nu", "no", "nz", "om", "ug", "uz", "pk", "pw", "pa", "pg", "py", "nl", "bq", "pe", "ph", "pl", "pr", "pt", "qa", "hk", "mo", "cf", "do", "ro", "gb", "rw", "kn", "sm", "sx", "vc", "sh", "lc", "sv", "ws", "as", "st", "sn", "rs", "sc", "sl", "sg", "sk", "si", "so", "sd", "ss", "lk", "se", "ch", "sr", "sj", "tj", "tw", "tz", "td", "cz", "io", "ps", "th", "tl", "tg", "tk", "to", "tt", "tn", "tm", "tr", "tv", "ua", "uy", "vu", "ve", "vn", "ye", "zm", "zw" ], "type": "string" }, "limit": { "description": "Categories returned (default 20, at most 50).", "maximum": 50, "minimum": 1, "type": "integer" }, "q": { "description": "Category name, French or English (empty: the most frequent categories).", "maxLength": 100, "type": "string" } }, "required": [], "type": "object" }, "name": "find_categories", "outputSchema": null }, { "description": "Look 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).\n\nFree.\n\nSame call as GET /api/v1/networks of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "description": "Networks returned (default 10, at most 50).", "maximum": 50, "minimum": 1, "type": "integer" }, "q": { "description": "Brand or network name (\"Century 21\", \"McDonald's\").", "maxLength": 60, "minLength": 2, "type": "string" } }, "required": [ "q" ], "type": "object" }, "name": "find_networks", "outputSchema": null }, { "description": "Plan, 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.\n\nFree.\n\nSame call as GET /api/v1/account of the REST API.", "inputSchema": { "additionalProperties": false, "properties": {}, "required": [], "type": "object" }, "name": "get_account", "outputSchema": null }, { "description": "Progress of a job: status, places done and billed, credits spent; for a finished filter or question job, the places per verdict.\n\nFree.\n\nSame call as GET /api/v1/jobs/{id} of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "jobId": { "description": "Id of a job (from start_list_job or get_list).", "format": "uuid", "type": "string" } }, "required": [ "jobId" ], "type": "object" }, "name": "get_job", "outputSchema": null }, { "description": "Status 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, call it again every 10 seconds or more.\n\nFree.\n\nSame call as GET /api/v1/lists/{id} of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "listId": { "description": "Id of a list of the account (from create_list or list_lists).", "format": "uuid", "type": "string" } }, "required": [ "listId" ], "type": "object" }, "name": "get_list", "outputSchema": null }, { "description": "Status 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.\n\nFree.\n\nSame call as GET /api/v1/lists/{id}/files/{fileId} of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "fileId": { "description": "Id of a prepared file (from prepare_list_file).", "format": "uuid", "type": "string" }, "listId": { "description": "Id of a list of the account (from create_list or list_lists).", "format": "uuid", "type": "string" } }, "required": [ "listId", "fileId" ], "type": "object" }, "name": "get_list_file", "outputSchema": null }, { "description": "Rows 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.\n\nFree.\n\nSame call as GET /api/v1/lists/{id}/items of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "columns": { "description": "Comma-separated column keys; default: every column of the CSV.", "maxLength": 2000, "type": "string" }, "cursor": { "description": "nextCursor of the previous page.", "maxLength": 200, "type": "string" }, "limit": { "default": 100, "maximum": 1000, "minimum": 1, "type": "integer" }, "listId": { "description": "Id of a list of the account (from create_list or list_lists).", "format": "uuid", "type": "string" } }, "required": [ "listId" ], "type": "object" }, "name": "get_list_items", "outputSchema": null }, { "description": "The 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.\n\nFree.\n\nSame call as POST /api/v1/search/metrics of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "search": { "description": "The search, as returned by POST /categories/suggest (field \"search\"). Send it back as is, edited if needed. The \"search\" object returned by suggest_categories (target, area, filters, sort), sent as is or edited; its full schema is the \"search\" input of count_search. An invalid search is refused with invalid_request and the fields to fix.", "type": "object" } }, "required": [ "search" ], "type": "object" }, "name": "get_search_metrics", "outputSchema": null }, { "description": "The lists of the account, newest first, page by page (send nextCursor back as cursor).\n\nFree.\n\nSame call as GET /api/v1/lists of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "description": "nextCursor of the previous page.", "maxLength": 200, "type": "string" }, "limit": { "default": 50, "maximum": 100, "minimum": 1, "type": "integer" } }, "required": [], "type": "object" }, "name": "list_lists", "outputSchema": null }, { "description": "Prepare 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.\n\nFree. idempotencyKey (a new UUID v4) is required; reuse it only to retry the very same call.\n\nSame call as POST /api/v1/lists/{id}/files of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "columns": { "description": "xlsx only: column keys (see GET /lists/{id}/items, \"columns\"). A CSV always holds every column.", "items": { "maxLength": 60, "minLength": 1, "type": "string" }, "maxItems": 100, "type": "array" }, "format": { "enum": [ "csv", "xlsx" ], "type": "string" }, "idempotencyKey": { "description": "A new UUID v4 for this operation (sent as the Idempotency-Key of the API). Reuse it only to retry the very same call: the saved result comes back, nothing is charged twice.", "format": "uuid", "type": "string" }, "listId": { "description": "Id of a list of the account (from create_list or list_lists).", "format": "uuid", "type": "string" } }, "required": [ "listId", "format", "idempotencyKey" ], "type": "object" }, "name": "prepare_list_file", "outputSchema": null }, { "description": "Up 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).\n\nFree.\n\nSame call as POST /api/v1/search/preview of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "description": "Rows returned (default 10, at most 25).", "maximum": 25, "minimum": 1, "type": "integer" }, "offset": { "description": "Rows to skip (default 0).", "maximum": 10000, "minimum": 0, "type": "integer" }, "search": { "description": "The search, as returned by POST /categories/suggest (field \"search\"). Send it back as is, edited if needed. The \"search\" object returned by suggest_categories (target, area, filters, sort), sent as is or edited; its full schema is the \"search\" input of count_search. An invalid search is refused with invalid_request and the fields to fix.", "type": "object" } }, "required": [ "search" ], "type": "object" }, "name": "preview_search", "outputSchema": null }, { "description": "Start 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_items.\n\nPaid: maxCredits (the most credits this call may spend, never exceeded) and idempotencyKey (a new UUID v4 for this operation) are required; without them nothing runs. To retry after an error or a timeout, send the same idempotencyKey with the same arguments: nothing is charged twice. Ask the user before calling it.\n\nSame call as POST /api/v1/lists/{id}/jobs of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "criterion": { "description": "tool \"filter\" only.", "maxLength": 300, "minLength": 3, "type": "string" }, "idempotencyKey": { "description": "A new UUID v4 for this operation (sent as the Idempotency-Key of the API). Reuse it only to retry the very same call: the saved result comes back, nothing is charged twice.", "format": "uuid", "type": "string" }, "listId": { "description": "Id of a list of the account (from create_list or list_lists).", "format": "uuid", "type": "string" }, "maxCredits": { "description": "The most credits this call may spend (required on every paid call, with an Idempotency-Key header). Never exceeded.", "maximum": 1000000000, "minimum": 0, "type": "integer" }, "question": { "description": "tool \"question\" only.", "maxLength": 300, "minLength": 5, "type": "string" }, "scope": { "description": "Places the job runs on: the whole list (default), the places a finished qualification judged conforming, or those it could not decide.", "oneOf": [ { "additionalProperties": false, "properties": { "kind": { "const": "all", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "properties": { "jobId": { "description": "A finished filter or question job of this list.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "kind": { "const": "conforming", "type": "string" } }, "required": [ "kind", "jobId" ], "type": "object" }, { "additionalProperties": false, "properties": { "jobId": { "description": "A finished filter or question job of this list: only its \"undetermined\" places.", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" }, "kind": { "const": "undetermined", "type": "string" } }, "required": [ "kind", "jobId" ], "type": "object" } ] }, "tool": { "description": "executives: company executives (France and the United States only); summary: 3-sentence summary of the website; question: a yes/no question asked to the website; filter: a criterion judged on the data we hold (no website read).", "enum": [ "executives", "summary", "question", "filter" ], "type": "string" } }, "required": [ "listId", "tool", "maxCredits", "idempotencyKey" ], "type": "object" }, "name": "start_list_job", "outputSchema": null }, { "description": "Entry 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 the Google Maps categories in groups and counts them in the area. Returns \"selection\" (groups, categories left out and why, what the data cannot tell) and \"search\", the object that count_search, get_search_metrics, preview_search, estimate_list and create_list take: pass it on as is, or edited. Costs 100 credits (maxCredits ≥ 100), refunded when no selection comes back. A request too vague is refused with clarification_needed, refunded: ask the user the question in error.details, then call again with the answer.\n\nPaid: maxCredits (the most credits this call may spend, never exceeded) and idempotencyKey (a new UUID v4 for this operation) are required; without them nothing runs. To retry after an error or a timeout, send the same idempotencyKey with the same arguments: nothing is charged twice. Ask the user before calling it.\n\nSame call as POST /api/v1/categories/suggest of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "area": { "description": "Area to search, as returned by GET /areas (field \"area\"). Default: that of \"search\", else the whole country.", "oneOf": [ { "additionalProperties": false, "properties": { "type": { "const": "country", "type": "string" }, "withoutOverseas": { "const": true, "type": "boolean" } }, "required": [ "type" ], "type": "object" }, { "additionalProperties": false, "properties": { "codes": { "items": { "pattern": "^[A-Za-z0-9-]{1,40}$", "type": "string" }, "maxItems": 20, "minItems": 1, "type": "array" }, "type": { "const": "region", "type": "string" } }, "required": [ "type", "codes" ], "type": "object" }, { "additionalProperties": false, "properties": { "codes": { "items": { "pattern": "^[A-Za-z0-9-]{1,40}$", "type": "string" }, "maxItems": 110, "minItems": 1, "type": "array" }, "type": { "const": "departement", "type": "string" } }, "required": [ "type", "codes" ], "type": "object" }, { "additionalProperties": false, "properties": { "codes": { "items": { "pattern": "^[A-Za-z0-9-]{1,40}$", "type": "string" }, "maxItems": 1000, "minItems": 1, "type": "array" }, "type": { "const": "commune", "type": "string" } }, "required": [ "type", "codes" ], "type": "object" }, { "additionalProperties": false, "properties": { "codes": { "items": { "pattern": "^[A-Za-z0-9 -]{2,10}$", "type": "string" }, "maxItems": 1000, "minItems": 1, "type": "array" }, "type": { "const": "postal", "type": "string" } }, "required": [ "type", "codes" ], "type": "object" }, { "additionalProperties": false, "properties": { "km": { "maximum": 500, "minimum": 0.1, "type": "number" }, "lat": { "maximum": 90, "minimum": -90, "type": "number" }, "lng": { "maximum": 180, "minimum": -180, "type": "number" }, "type": { "const": "radius", "type": "string" } }, "required": [ "type", "lat", "lng", "km" ], "type": "object" } ] }, "country": { "description": "Country to search (default: that of \"search\", else fr).", "enum": [ "af", "za", "al", "dz", "de", "ad", "ao", "ai", "ag", "sa", "ar", "am", "aw", "au", "at", "az", "bs", "bh", "bd", "bb", "be", "bz", "bj", "bm", "bt", "bo", "ba", "bw", "br", "bn", "bg", "bf", "bi", "kh", "cm", "ca", "cv", "cl", "cn", "cy", "co", "km", "cg", "cd", "kr", "cr", "ci", "hr", "cw", "dk", "dj", "dm", "eg", "ae", "ec", "er", "es", "ee", "sz", "va", "us", "et", "fj", "fi", "fr", "ga", "gm", "ge", "gh", "gi", "gr", "gd", "gl", "gu", "gt", "gg", "gn", "gq", "gw", "gy", "ht", "hn", "hu", "cx", "im", "nf", "ax", "ky", "cc", "ck", "fo", "fk", "mp", "mh", "pn", "sb", "tc", "vg", "vi", "in", "id", "iq", "ie", "is", "il", "it", "jm", "jp", "je", "jo", "kz", "ke", "kg", "ki", "xk", "kw", "la", "ls", "lv", "lb", "lr", "ly", "li", "lt", "lu", "mk", "mg", "my", "mw", "mv", "ml", "mt", "ma", "mu", "mr", "mx", "fm", "md", "mc", "mn", "me", "ms", "mz", "mm", "na", "nr", "np", "ni", "ne", "ng", "nu", "no", "nz", "om", "ug", "uz", "pk", "pw", "pa", "pg", "py", "nl", "bq", "pe", "ph", "pl", "pr", "pt", "qa", "hk", "mo", "cf", "do", "ro", "gb", "rw", "kn", "sm", "sx", "vc", "sh", "lc", "sv", "ws", "as", "st", "sn", "rs", "sc", "sl", "sg", "sk", "si", "so", "sd", "ss", "lk", "se", "ch", "sr", "sj", "tj", "tw", "tz", "td", "cz", "io", "ps", "th", "tl", "tg", "tk", "to", "tt", "tn", "tm", "tr", "tv", "ua", "uy", "vu", "ve", "vn", "ye", "zm", "zw" ], "type": "string" }, "idempotencyKey": { "description": "A new UUID v4 for this operation (sent as the Idempotency-Key of the API). Reuse it only to retry the very same call: the saved result comes back, nothing is charged twice.", "format": "uuid", "type": "string" }, "maxCredits": { "description": "Must be at least 100: the price of a suggestion.", "minimum": 100, "type": "integer" }, "previous": { "anyOf": [ { "additionalProperties": false, "properties": { "groups": { "items": { "additionalProperties": false, "properties": { "ids": { "items": { "exclusiveMinimum": 0, "type": "integer" }, "maxItems": 600, "minItems": 1, "type": "array" }, "label": { "maxLength": 60, "minLength": 1, "type": "string" }, "prudence": { "const": true, "description": "True when the engine added this group by prudence (a neighbouring activity, not the core of the request): a list delivers the core of the request first.", "type": "boolean" } }, "required": [ "label", "ids" ], "type": "object" }, "maxItems": 8, "type": "array" } }, "required": [ "groups" ], "type": "object" }, { "type": "null" } ], "description": "The selection to update (default: the groups of \"search\"); null starts afresh." }, "request": { "description": "The target as the user would say it, WITHOUT the place: \"independent car repair shops\", \"restaurants that could use a booking tool\". What the client sells works too.", "maxLength": 600, "minLength": 2, "type": "string" }, "search": { "description": "A search to refine: its area, filters, exclusions and groups are kept (the groups become the previous selection). The \"search\" object returned by suggest_categories (target, area, filters, sort), sent as is or edited; its full schema is the \"search\" input of count_search. An invalid search is refused with invalid_request and the fields to fix.", "type": "object" } }, "required": [ "request", "maxCredits", "idempotencyKey" ], "type": "object" }, "name": "suggest_categories", "outputSchema": null }, { "description": "Verify 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.\n\nPaid: maxCredits (the most credits this call may spend, never exceeded) and idempotencyKey (a new UUID v4 for this operation) are required; without them nothing runs. To retry after an error or a timeout, send the same idempotencyKey with the same arguments: nothing is charged twice. Ask the user before calling it.\n\nSame call as POST /api/v1/lists/{id}/email-check of the REST API.", "inputSchema": { "additionalProperties": false, "properties": { "idempotencyKey": { "description": "A new UUID v4 for this operation (sent as the Idempotency-Key of the API). Reuse it only to retry the very same call: the saved result comes back, nothing is charged twice.", "format": "uuid", "type": "string" }, "listId": { "description": "Id of a list of the account (from create_list or list_lists).", "format": "uuid", "type": "string" }, "maxCredits": { "description": "The most credits this call may spend (required on every paid call, with an Idempotency-Key header). Never exceeded.", "maximum": 1000000000, "minimum": 0, "type": "integer" } }, "required": [ "listId", "maxCredits", "idempotencyKey" ], "type": "object" }, "name": "verify_list_emails", "outputSchema": null } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:c09ab43e95248f182efe1777c99f2c6b25c343fb29e7aa169f82698876fd9005 | sha256sum