Count, preview and quote US business leads for free, then buy them with a spending limit.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer dc_live_... API key; optional, only for account tools
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Show the account behind your API key: email, plan, credit balance, today's usage and spend limits. Needs an API key (Authorization: Bearer dc_live_... or X-API-Key).
This tool takes no arguments.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http leads https://datacandy.co/mcp
Headers
Authorization (optional, not in the config above): Bearer dc_live_... API key; optional, only for account toolsShow the account behind your API key: email, plan, credit balance, today's usage and spend limits. Needs an API key (Authorization: Bearer dc_live_... or X-API-Key).
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}Start a credit top-up of $10 to $1,000. THIS SPENDS MONEY once a person pays. Returns a Stripe checkout link that a person must open; the credits arrive after payment and buy_leads then spends them. Needs an API key.
| Argument | Type | Description |
|---|---|---|
| amount_usd* | number | Top-up amount in US dollars, 10 to 1000. |
| idempotency_key | string | Optional. Send the same value when retrying after a timeout so you are never charged twice for one purchase. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"amount_usd"
],
"properties": {
"amount_usd": {
"type": "number",
"maximum": 1000,
"minimum": 10,
"description": "Top-up amount in US dollars, 10 to 1000."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]+$",
"maxLength": 128,
"minLength": 8,
"description": "Optional. Send the same value when retrying after a timeout so you are never charged twice for one purchase."
}
},
"additionalProperties": false
}Buy leads. THIS SPENDS MONEY AND CANNOT BE UNDONE. max_price_usd is required: nothing is bought if the price is higher. Paid from the account's credits (API key needed) it returns the leads at once: the first 25 inline and download links for the full set. Otherwise it returns a checkout link and an order id; a person pays on that page, then get_order returns the leads. Run quote_leads first.
| Argument | Type | Description |
|---|---|---|
| string | Email for the receipt and for recovering the order. | |
| fresh | boolean | Skip leads this account already received for the same search (default true when an API key is used). |
| filters | object | Search filters, all optional. Combine as needed; more filters means fewer leads. |
| after_id | integer | Continue after this lead id (use next_after_id from an earlier order to get new leads). |
| quantity* | integer | How many leads (1 to 25,000). If fewer match, you get what matches. |
| max_price_usd* | number | REQUIRED spending cap in US dollars. Nothing is bought if the price is higher. |
| payment_method | string | auto (default): account credits when enough, else a Shared Payment Token if given, else a checkout link. checkout: always return a link for a person to pay. |
Count the leads that match the filters (industry, category, keyword, state, city, ZIP, has_email, has_cell and so on). Fast and free; nothing is charged. Returns the count and whether it is exact.
| Argument | Type | Description |
|---|---|---|
| filters | object | Search filters, all optional. Combine as needed; more filters means fewer leads. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"filters": {
"type": "object",
"properties": {
"zip": {
"type": "string",
"maxLength": 300,
"minLength": 5,
"description": "5-digit ZIP code, or a comma-separated list of ZIP codes."
},
"city": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Exact city name (case-insensitive). Use together with state."
},
"state": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "2-letter US state code, or a comma-separated list such as \"TX,OK\"."
},
"keyword": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Business name contains this text (case-insensitive)."
},
"category": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Specific category, e.g. \"Roofing contractor\" (find names with list_industries and its search argument)."
},
"has_cell": {
"type": "boolean",
"description": "Only leads that have a mobile phone number."
},
"industry": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Exact industry name from list_industries, e.g. \"Construction & Contractors\"."
},
"has_email": {
"type": "boolean",
"description": "Only leads that have an email address."
},
"has_phone": {
"type": "boolean",
"description": "Only leads that have any phone number."
},
"has_website": {
"type": "boolean",
"description": "Only leads that have a website."
},
"has_facebook": {
"type": "boolean",
"description": "Only leads that have a Facebook page."
},
"has_owner_name": {
"type": "boolean",
"description": "Only leads that have the owner's name."
}
},
"description": "Search filters, all optional. Combine as needed; more filters means fewer leads.",
"additionalProperties": false
}
},
"additionalProperties": false
}Create a Data Candy account and API key for an email address (free; credits start at $0). The key is shown once: store it. Returns the exact MCP configuration to reconnect with the key. If the email already has an account, no key is returned and its owner gets a sign-in link by email.
| Argument | Type | Description |
|---|---|---|
| email* | string | Email address that will own the account. |
| use_case | string | What you will use the leads for. |
| agent_name | string | Name of your agent or app. |
| idempotency_key | string | Optional. Send the same value when retrying after a timeout so you are never charged twice for one purchase. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Email address that will own the account."
},
"use_case": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "What you will use the leads for."
},
"agent_name": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Name of your agent or app."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]+$",
"maxLength": 128,
"minLength": 8,
"description": "Optional. Send the same value when retrying after a timeout so you are never charged twice for one purchase."
}
},
"additionalProperties": false
}Overview of the Data Candy US business-lead database: how many records it holds, how many have an email, a mobile number or a website, how fresh the data is, the fields on each lead, and the current prices and payment options. Free, no account needed.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}Email 25 free real sample leads to an address (use the person's own email). This sends a real email. No text message is sent from here.
| Argument | Type | Description |
|---|---|---|
| name* | string | Name of the person asking for the sample. |
| email* | string | Where to email the sample: the person's own address. |
| phone | string | Ignored: no text message is sent from this tool. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Name of the person asking for the sample."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Where to email the sample: the person's own address."
},
"phone": {
"type": "string",
"maxLength": 30,
"minLength": 7,
"description": "Ignored: no text message is sent from this tool."
}
},
"additionalProperties": false
}Check an order by its id: status (awaiting_payment, paid, fulfilled, expired ...), price and, once fulfilled, the first 25 leads plus download links for the whole set. Use it after a person has paid a checkout link. Nothing is charged.
| Argument | Type | Description |
|---|---|---|
| order_id* | string | The order id returned by buy_leads, like "ord_...". Keep it secret: it grants the download. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 80,
"minLength": 8,
"description": "The order id returned by buy_leads, like \"ord_...\". Keep it secret: it grants the download."
}
},
"additionalProperties": false
}List the industries you can filter on, with lead counts. Pass `search` (for example "roof") to also find the more specific categories such as "Roofing contractor". Use the exact names it returns in the industry and category filters. Free.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum categories to return with search (default 25). |
| search | string | Find industries and more specific categories containing this text, e.g. "roof". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum categories to return with search (default 25)."
},
"search": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Find industries and more specific categories containing this text, e.g. \"roof\"."
}
},
"additionalProperties": false
}List US states with lead counts, or the cities of one state (pass `state`, optionally `search` to narrow by name). Use the exact values in the state and city filters. Free.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum cities to return (default 50). |
| state | string | 2-letter state code: list the cities of this state. |
| search | string | Only cities whose name contains this text. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Maximum cities to return (default 50)."
},
"state": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "2-letter state code: list the cities of this state."
},
"search": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Only cities whose name contains this text."
}
},
"additionalProperties": false
}Show up to 10 sample leads for the filters with email, phone and last name partly hidden, plus the total number of matches. Free; use it to check the filters return the kind of businesses you want.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many sample rows (1 to 10, default 5). |
| filters | object | Search filters, all optional. Combine as needed; more filters means fewer leads. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "How many sample rows (1 to 10, default 5)."
},
"filters": {
"type": "object",
"properties": {
"zip": {
"type": "string",
"maxLength": 300,
"minLength": 5,
"description": "5-digit ZIP code, or a comma-separated list of ZIP codes."
},
"city": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Exact city name (case-insensitive). Use together with state."
},
"state": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "2-letter US state code, or a comma-separated list such as \"TX,OK\"."
},
"keyword": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Business name contains this text (case-insensitive)."
},
"category": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Specific category, e.g. \"Roofing contractor\" (find names with list_industries and its search argument)."
},
"has_cell": {
"type": "boolean",
"description": "Only leads that have a mobile phone number."
},
"industry": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Exact industry name from list_industries, e.g. \"Construction & Contractors\"."
},
"has_email": {
"type": "boolean",
"description": "Only leads that have an email address."
},
"has_phone": {
"type": "boolean",
"description": "Only leads that have any phone number."
},
"has_website": {
"type": "boolean",
"description": "Only leads that have a website."
},
"has_facebook": {
"type": "boolean",
"description": "Only leads that have a Facebook page."
},
"has_owner_name": {
"type": "boolean",
"description": "Only leads that have the owner's name."
}
},
"description": "Search filters, all optional. Combine as needed; more filters means fewer leads.",
"additionalProperties": false
}
},
"additionalProperties": false
}Exact price for buying `quantity` leads for the filters. Nothing is charged. Returns how many leads match, the price in dollars and the payment methods available right now.
| Argument | Type | Description |
|---|---|---|
| filters | object | Search filters, all optional. Combine as needed; more filters means fewer leads. |
| after_id | integer | Continue after this lead id (use next_after_id from an earlier order to get new leads). |
| quantity* | integer | How many leads (1 to 25,000). If fewer match, you get what matches. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"quantity"
],
"properties": {
"filters": {
"type": "object",
"properties": {
"zip": {
"type": "string",
"maxLength": 300,
"minLength": 5,
"description": "5-digit ZIP code, or a comma-separated list of ZIP codes."
},
"city": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Exact city name (case-insensitive). Use together with state."
},
"state": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "2-letter US state code, or a comma-separated list such as \"TX,OK\"."
},
"keyword": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Business name contains this text (case-insensitive)."
},
"category": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Specific category, e.g. \"Roofing contractor\" (find names with list_industries and its search argument)."
},
"has_cell": {
"type": "boolean",
"description": "Only leads that have a mobile phone number."
},
"industry": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Exact industry name from list_industries, e.g. \"Construction & Contractors\"."
},
"has_email": {
"type": "boolean",
"description": "Only leads that have an email address."
},
"has_phone": {
"type": "boolean",
"description": "Only leads that have any phone number."
},
"has_website": {
"type": "boolean",
"description": "Only leads that have a website."
},
"has_facebook": {
"type": "boolean",
"description": "Only leads that have a Facebook page."
},
"has_owner_name": {
"type": "boolean",
"description": "Only leads that have the owner's name."
}
},
"description": "Search filters, all optional. Combine as needed; more filters means fewer leads.",
"additionalProperties": false
},
"after_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Continue after this lead id (use next_after_id from an earlier order to get new leads)."
},
"quantity": {
"type": "integer",
"maximum": 25000,
"minimum": 1,
"description": "How many leads (1 to 25,000). If fewer match, you get what matches."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 17, 2026.
| idempotency_key | string | Optional. Send the same value when retrying after a timeout so you are never charged twice for one purchase. |
| shared_payment_token | string | Stripe Shared Payment Token (spt_...), only with payment_method "stripe_spt". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"quantity",
"max_price_usd"
],
"properties": {
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Email for the receipt and for recovering the order."
},
"fresh": {
"type": "boolean",
"description": "Skip leads this account already received for the same search (default true when an API key is used)."
},
"filters": {
"type": "object",
"properties": {
"zip": {
"type": "string",
"maxLength": 300,
"minLength": 5,
"description": "5-digit ZIP code, or a comma-separated list of ZIP codes."
},
"city": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "Exact city name (case-insensitive). Use together with state."
},
"state": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "2-letter US state code, or a comma-separated list such as \"TX,OK\"."
},
"keyword": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Business name contains this text (case-insensitive)."
},
"category": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Specific category, e.g. \"Roofing contractor\" (find names with list_industries and its search argument)."
},
"has_cell": {
"type": "boolean",
"description": "Only leads that have a mobile phone number."
},
"industry": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Exact industry name from list_industries, e.g. \"Construction & Contractors\"."
},
"has_email": {
"type": "boolean",
"description": "Only leads that have an email address."
},
"has_phone": {
"type": "boolean",
"description": "Only leads that have any phone number."
},
"has_website": {
"type": "boolean",
"description": "Only leads that have a website."
},
"has_facebook": {
"type": "boolean",
"description": "Only leads that have a Facebook page."
},
"has_owner_name": {
"type": "boolean",
"description": "Only leads that have the owner's name."
}
},
"description": "Search filters, all optional. Combine as needed; more filters means fewer leads.",
"additionalProperties": false
},
"after_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Continue after this lead id (use next_after_id from an earlier order to get new leads)."
},
"quantity": {
"type": "integer",
"maximum": 25000,
"minimum": 1,
"description": "How many leads (1 to 25,000). If fewer match, you get what matches."
},
"max_price_usd": {
"type": "number",
"maximum": 100000,
"description": "REQUIRED spending cap in US dollars. Nothing is bought if the price is higher.",
"exclusiveMinimum": 0
},
"payment_method": {
"enum": [
"auto",
"credits",
"checkout",
"stripe_spt"
],
"type": "string",
"description": "auto (default): account credits when enough, else a Shared Payment Token if given, else a checkout link. checkout: always return a link for a person to pay."
},
"idempotency_key": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]+$",
"maxLength": 128,
"minLength": 8,
"description": "Optional. Send the same value when retrying after a timeout so you are never charged twice for one purchase."
},
"shared_payment_token": {
"type": "string",
"maxLength": 200,
"minLength": 8,
"description": "Stripe Shared Payment Token (spt_...), only with payment_method \"stripe_spt\"."
}
},
"additionalProperties": false
}