Developers

PublicLeads for AI assistants

AI assistants can search PublicLeads directly: find the business list that fits a request, check its price, size and a masked sample, and send the user to the list page to buy. No login and no API key; every tool is read-only.

MCP server

Remote MCP over Streamable HTTP:

https://www.publicleads.com/mcp

Claude — Settings → Connectors → Add custom connector, paste the URL. ChatGPT — Settings → Apps & Connectors → Advanced → Developer mode, then Create, paste the URL, authentication “No authentication”. Other clients (Cursor, VS Code, MCP Inspector) — add it as an HTTP / Streamable HTTP server.

Tools

  • list_trades — List every industry (trade) PublicLeads sells business lists for, with the slug to pass to search_lists, plus the countries covered (US, Canada, Australia). Call this when the user's industry may not match a name directly.
  • search_lists — Find ready-made business contact lists for sale by industry and location. Returns up to 10 lists, best match first (the exact city, then its state/province, then the country): name, scope, number of businesses, how many have an email, price, and preview and buy links. Location can be a city ("Austin", "Austin, TX"), a state or province ("Ontario"), or a country ("USA", "Canada", "Australia"); spelling is matched loosely. Use when someone needs leads or prospects of a type of local business.
  • get_list_details — Details of one list from search_lists: the fields included in the file, the price, the freshness policy, and a masked 5-row sample (business name, city, Google rating; emails and phones are masked). Pass the list value search_lists returned, or the list's publicleads.com URL.
  • get_market_stats — Aggregate statistics for an industry in a place: number of operational businesses, average Google rating, total reviews, and the percentage with an email, with a company-domain email, with a phone, with a website and with a street address. No contact details. Use for market-sizing questions such as "how many plumbers are there in Ohio".
  • request_custom_list — When no ready-made list fits (an unusual industry, a county or a radius, several industries together), return the link to request a custom list and its price. We measure the data and reply with the real count before any payment.

Without MCP: OpenAPI

The same tools as plain GET endpoints, described at www.publicleads.com/openapi.json — for example /api/ai/search-lists?trade=dentists&location=Austin. Use it for custom GPT actions or any tool that imports an OpenAPI document.

What the tools return, and what they never do

Prices, business counts and links are the same ones the list pages show. Samples are at most five rows, with emails and phones masked; full contact details are only in the file a buyer downloads. Links carry ?src=mcp so we can see which visits came from an assistant. Limits: 30 calls a minute and 600 a day per address. We log the tool, the industry and place asked for, and the number of results — never the conversation or the caller’s address (privacy). Data is refreshed quarterly.

Contact

Questions or higher limits: support@publicleads.com. A summary of the dataset for language models is at /llms.txt.