Koskamo

PublicLeads MCP

An official read-only MCP server provided by PublicLeads that allows AI assistants to search for B2B business contact lists by industry and location, retrieve pricing and masked samples, and access market statistics without requiring authentication.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

PublicLeads MCP logo, by PublicLeadsVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by PublicLeads
MCP endpoint (Streamable HTTP)
https://www.publicleads.com/mcp
Vendor documentation

What you can do with it

  • Search for business contact lists by industry and location
  • Retrieve pricing and masked samples for lead lists
  • Get market statistics for specific industries and regions
  • Request custom business lists for unusual criteria

Source and maintenance

Vendor evidenceRegistry 1.0.0

Protocol and capabilities

Server
publicleads 1.0.0
MCP protocol
2025-06-18
Tools
5 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

PublicLeads sells ready-made lists of local businesses (name, email where one exists, phone, address, website, Google rating) by industry and place in the United States, Canada and Australia: one city ($9), one state or province ($19) or a whole country ($99), one-time payment, Excel + CSV. Use search_lists when someone wants leads, prospects or a contact list of a kind of business somewhere; get_list_details before recommending one; get_market_stats for questions about how many businesses of a kind exist in a place; request_custom_list when nothing fits. Always give the user the preview_url or buy_url exactly as returned — purchase happens on the website. These tools never return contact details: samples are masked.

Tools

5 advertised

list_trades — List industries
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

list_trades input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
list_trades annotations
{
  "title": "List industries",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_lists — Search business lists
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

search_lists input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "trade",
    "location"
  ],
  "properties": {
    "trade": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Industry, as a slug from list_trades or in plain words, e.g. \"dentists\", \"hvac\", \"real estate agents\", \"businesses without a website\"."
    },
    "location": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "City, state/province or country in the US, Canada or Australia, e.g. \"Austin, TX\", \"Ontario\", \"USA\"."
    }
  },
  "additionalProperties": false
}
search_lists annotations
{
  "title": "Search business lists",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_list_details — Get list details
Advertised by the server during the last successful anonymous check.
Advertised read-only

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_list_details input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "list"
  ],
  "properties": {
    "list": {
      "type": "string",
      "maxLength": 300,
      "minLength": 1,
      "description": "The \"list\" value from search_lists, e.g. \"/dentists/usa/texas/austin\", or the list page URL."
    }
  },
  "additionalProperties": false
}
get_list_details annotations
{
  "title": "Get list details",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_market_stats — Get market statistics
Advertised by the server during the last successful anonymous check.
Advertised read-only

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".

get_market_stats input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "trade",
    "location"
  ],
  "properties": {
    "trade": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Industry, as a slug from list_trades or in plain words."
    },
    "location": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "City, state/province or country in the US, Canada or Australia."
    }
  },
  "additionalProperties": false
}
get_market_stats annotations
{
  "title": "Get market statistics",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
request_custom_list — Request a custom list
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

request_custom_list input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "description": {
      "type": "string",
      "maxLength": 300,
      "description": "Optional: who the user is looking for, in their own words (logged as a demand signal, never shown to anyone)."
    }
  },
  "additionalProperties": false
}
request_custom_list annotations
{
  "title": "Request a custom list",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
519 ms
95th percentile latency
519 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 519 ms · metadata changed · 5 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http publicleads-mcp https://www.publicleads.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add publicleads-mcp --url https://www.publicleads.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable publicleads-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "publicleads-mcp": {
      "url": "https://www.publicleads.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "publicleads-mcp": {
      "type": "streamableHttp",
      "url": "https://www.publicleads.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start publicleads-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "publicleads-mcp": {
      "type": "http",
      "url": "https://www.publicleads.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http publicleads-mcp https://www.publicleads.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "publicleads-mcp": {
      "url": "https://www.publicleads.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "publicleads-mcp": {
      "serverUrl": "https://www.publicleads.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like PublicLeads MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Do you run PublicLeads MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing