Data Candy: US business leads
Count, preview and quote US business leads for free, then buy them with a spending limit.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"leads": {
"url": "https://datacandy.co/mcp"
}
}
}Remote endpoints
https://datacandy.co/mcpstreamable-httpWhat it can do
Tool inventory
Tools (12)
🟢database_overview
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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"total_leads": {
"type": [
"number",
"null"
]
},
"catalog": {
"type": "object",
"properties": {},
"additionalProperties": {},
"description": "The catalog overview from /v1/catalog: totals, coverage per field, freshness, fields."
},
"pricing": {
"type": "object",
"properties": {
"currency": {
"type": [
"string",
"null"
]
},
"per_lead_usd": {
"type": [
"number",
"null"
]
},
"min_card_order_usd": {
"type": [
"number",
"null"
]
},
"payment_methods": {
"type": "array",
"items": {
"type": "object",
"properties": {
"method": {
"type": "string"
},
"how": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"plans": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {}
}
},
"datasets": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {}
}
},
"free": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": {}
},
{
"type": "null"
}
]
}
},
"additionalProperties": {}
},
"links": {
"type": "object",
"properties": {
"agents": {
"type": "string"
},
"docs": {
"type": "string"
},
"openapi": {
"type": "string"
},
"pricing": {
"type": "string"
}
},
"required": [
"agents",
"docs",
"openapi",
"pricing"
],
"additionalProperties": {}
}
},
"required": [
"catalog",
"pricing",
"links"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢list_industries(search, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"search": {
"description": "Find industries and more specific categories containing this text, e.g. \"roof\".",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"limit": {
"description": "Maximum categories to return with search (default 25).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"industries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"count": {
"type": [
"number",
"null"
]
}
},
"required": [
"name"
],
"additionalProperties": {}
}
},
"categories": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"industry": {
"type": [
"string",
"null"
]
},
"count": {
"type": [
"number",
"null"
]
}
},
"required": [
"name"
],
"additionalProperties": {}
}
},
"search": {
"type": [
"string",
"null"
]
}
},
"required": [
"industries",
"categories"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_locations(state, search, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"state": {
"description": "2-letter state code: list the cities of this state.",
"type": "string",
"minLength": 2,
"maxLength": 2
},
"search": {
"description": "Only cities whose name contains this text.",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"limit": {
"description": "Maximum cities to return (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"level": {
"type": "string",
"enum": [
"states",
"cities"
]
},
"states": {
"type": "array",
"items": {
"type": "object",
"properties": {
"state": {
"type": "string"
},
"count": {
"type": [
"number",
"null"
]
}
},
"required": [
"state"
],
"additionalProperties": {}
}
},
"cities": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"state": {
"type": [
"string",
"null"
]
},
"count": {
"type": [
"number",
"null"
]
}
},
"required": [
"city"
],
"additionalProperties": {}
}
}
},
"required": [
"level",
"states",
"cities"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢count_leads(filters)
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.
Input Schema
{
"type": "object",
"properties": {
"filters": {
"type": "object",
"properties": {
"industry": {
"description": "Exact industry name from list_industries, e.g. \"Construction & Contractors\".",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"category": {
"description": "Specific category, e.g. \"Roofing contractor\" (find names with list_industries and its search argument).",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"keyword": {
"description": "Business name contains this text (case-insensitive).",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"state": {
"description": "2-letter US state code, or a comma-separated list such as \"TX,OK\".",
"type": "string",
"minLength": 2,
"maxLength": 120
},
"city": {
"description": "Exact city name (case-insensitive). Use together with state.",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"zip": {
"description": "5-digit ZIP code, or a comma-separated list of ZIP codes.",
"type": "string",
"minLength": 5,
"maxLength": 300
},
"has_email": {
"description": "Only leads that have an email address.",
"type": "boolean"
},
"has_cell": {
"description": "Only leads that have a mobile phone number.",
"type": "boolean"
},
"has_phone": {
"description": "Only leads that have any phone number.",
"type": "boolean"
},
"has_website": {
"description": "Only leads that have a website.",
"type": "boolean"
},
"has_facebook": {
"description": "Only leads that have a Facebook page.",
"type": "boolean"
},
"has_owner_name": {
"description": "Only leads that have the owner's name.",
"type": "boolean"
}
},
"additionalProperties": false,
"description": "Search filters, all optional. Combine as needed; more filters means fewer leads."
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"count": {
"type": "number"
},
"exact": {
"type": "boolean"
},
"capped_at": {
"type": [
"number",
"null"
]
},
"filters": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"ignored_filters": {
"description": "Filters the catalog could not apply, if any.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"count",
"exact",
"filters"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢preview_leads(filters, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"filters": {
"type": "object",
"properties": {
"industry": {
"description": "Exact industry name from list_industries, e.g. \"Construction & Contractors\".",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"category": {
"description": "Specific category, e.g. \"Roofing contractor\" (find names with list_industries and its search argument).",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"keyword": {
"description": "Business name contains this text (case-insensitive).",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"state": {
"description": "2-letter US state code, or a comma-separated list such as \"TX,OK\".",
"type": "string",
"minLength": 2,
"maxLength": 120
},
"city": {
"description": "Exact city name (case-insensitive). Use together with state.",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"zip": {
"description": "5-digit ZIP code, or a comma-separated list of ZIP codes.",
"type": "string",
"minLength": 5,
"maxLength": 300
},
"has_email": {
"description": "Only leads that have an email address.",
"type": "boolean"
},
"has_cell": {
"description": "Only leads that have a mobile phone number.",
"type": "boolean"
},
"has_phone": {
"description": "Only leads that have any phone number.",
"type": "boolean"
},
"has_website": {
"description": "Only leads that have a website.",
"type": "boolean"
},
"has_facebook": {
"description": "Only leads that have a Facebook page.",
"type": "boolean"
},
"has_owner_name": {
"description": "Only leads that have the owner's name.",
"type": "boolean"
}
},
"additionalProperties": false,
"description": "Search filters, all optional. Combine as needed; more filters means fewer leads."
},
"limit": {
"description": "How many sample rows (1 to 10, default 5).",
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"count": {
"type": "number",
"description": "Total leads matching the filters."
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": [
"number",
"string",
"null"
]
},
"business": {
"type": [
"string",
"null"
]
},
"owner_first": {
"type": [
"string",
"null"
]
},
"owner_last": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"cell": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"phone_type": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"facebook": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"zip": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
"description": "Masked sample rows (email, phone and last name are partly hidden)."
},
"shown": {
"type": "number"
},
"filters": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"ignored_filters": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"count",
"rows",
"shown",
"filters"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢quote_leads(filters, quantity, after_id)
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.
Input Schema
{
"type": "object",
"properties": {
"filters": {
"type": "object",
"properties": {
"industry": {
"description": "Exact industry name from list_industries, e.g. \"Construction & Contractors\".",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"category": {
"description": "Specific category, e.g. \"Roofing contractor\" (find names with list_industries and its search argument).",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"keyword": {
"description": "Business name contains this text (case-insensitive).",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"state": {
"description": "2-letter US state code, or a comma-separated list such as \"TX,OK\".",
"type": "string",
"minLength": 2,
"maxLength": 120
},
"city": {
"description": "Exact city name (case-insensitive). Use together with state.",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"zip": {
"description": "5-digit ZIP code, or a comma-separated list of ZIP codes.",
"type": "string",
"minLength": 5,
"maxLength": 300
},
"has_email": {
"description": "Only leads that have an email address.",
"type": "boolean"
},
"has_cell": {
"description": "Only leads that have a mobile phone number.",
"type": "boolean"
},
"has_phone": {
"description": "Only leads that have any phone number.",
"type": "boolean"
},
"has_website": {
"description": "Only leads that have a website.",
"type": "boolean"
},
"has_facebook": {
"description": "Only leads that have a Facebook page.",
"type": "boolean"
},
"has_owner_name": {
"description": "Only leads that have the owner's name.",
"type": "boolean"
}
},
"additionalProperties": false,
"description": "Search filters, all optional. Combine as needed; more filters means fewer leads."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 25000,
"description": "How many leads (1 to 25,000). If fewer match, you get what matches."
},
"after_id": {
"description": "Continue after this lead id (use next_after_id from an earlier order to get new leads).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"quantity"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"matched": {
"type": "number",
"description": "Leads matching the filters."
},
"quantity": {
"type": "number",
"description": "How many leads the price is for."
},
"price_cents": {
"type": "number"
},
"price_usd": {
"type": "number"
},
"payment_methods": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"method": {
"type": "string"
},
"how": {
"type": "string"
}
},
"additionalProperties": {}
},
{
"type": "string"
}
]
}
},
"expires_in_s": {
"type": [
"number",
"null"
]
},
"filters": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"ignored_filters": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"matched",
"quantity",
"price_cents",
"price_usd",
"filters"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🔴buy_leads(filters, quantity, max_price_usd, after_id, fresh, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"filters": {
"type": "object",
"properties": {
"industry": {
"description": "Exact industry name from list_industries, e.g. \"Construction & Contractors\".",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"category": {
"description": "Specific category, e.g. \"Roofing contractor\" (find names with list_industries and its search argument).",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"keyword": {
"description": "Business name contains this text (case-insensitive).",
"type": "string",
"minLength": 1,
"maxLength": 120
},
"state": {
"description": "2-letter US state code, or a comma-separated list such as \"TX,OK\".",
"type": "string",
"minLength": 2,
"maxLength": 120
},
"city": {
"description": "Exact city name (case-insensitive). Use together with state.",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"zip": {
"description": "5-digit ZIP code, or a comma-separated list of ZIP codes.",
"type": "string",
"minLength": 5,
"maxLength": 300
},
"has_email": {
"description": "Only leads that have an email address.",
"type": "boolean"
},
"has_cell": {
"description": "Only leads that have a mobile phone number.",
"type": "boolean"
},
"has_phone": {
"description": "Only leads that have any phone number.",
"type": "boolean"
},
"has_website": {
"description": "Only leads that have a website.",
"type": "boolean"
},
"has_facebook": {
"description": "Only leads that have a Facebook page.",
"type": "boolean"
},
"has_owner_name": {
"description": "Only leads that have the owner's name.",
"type": "boolean"
}
},
"additionalProperties": false,
"description": "Search filters, all optional. Combine as needed; more filters means fewer leads."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 25000,
"description": "How many leads (1 to 25,000). If fewer match, you get what matches."
},
"max_price_usd": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100000,
"description": "REQUIRED spending cap in US dollars. Nothing is bought if the price is higher."
},
"after_id": {
"description": "Continue after this lead id (use next_after_id from an earlier order to get new leads).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"fresh": {
"description": "Skip leads this account already received for the same search (default true when an API key is used).",
"type": "boolean"
},
"payment_method": {
"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.",
"type": "string",
"enum": [
"auto",
"credits",
"checkout",
"stripe_spt"
]
},
"shared_payment_token": {
"description": "Stripe Shared Payment Token (spt_...), only with payment_method \"stripe_spt\".",
"type": "string",
"minLength": 8,
"maxLength": 200
},
"email": {
"description": "Email for the receipt and for recovering the order.",
"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,}$"
},
"idempotency_key": {
"description": "Optional. Send the same value when retrying after a timeout so you are never charged twice for one purchase.",
"type": "string",
"minLength": 8,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_.:-]+$"
}
},
"required": [
"quantity",
"max_price_usd"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"description": "The order id. Keep it secret."
},
"status": {
"type": "string",
"description": "awaiting_payment, paid, fulfilled, expired, canceled, refunded or failed."
},
"kind": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": [
"number",
"null"
]
},
"matched": {
"type": [
"number",
"null"
]
},
"delivered": {
"type": [
"number",
"null"
]
},
"unit_price_cents": {
"type": [
"number",
"null"
]
},
"price_cents": {
"type": [
"number",
"null"
]
},
"price_usd": {
"type": [
"number",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"payment_method": {
"type": [
"string",
"null"
]
},
"checkout_url": {
"description": "Open this page to pay (a person must do it).",
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
},
"download": {
"anyOf": [
{
"type": "object",
"properties": {
"json": {
"type": [
"string",
"null"
]
},
"csv": {
"type": [
"string",
"null"
]
},
"ndjson": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"leads": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": [
"number",
"string",
"null"
]
},
"business": {
"type": [
"string",
"null"
]
},
"owner_first": {
"type": [
"string",
"null"
]
},
"owner_last": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"cell": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"phone_type": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"facebook": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"zip": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
"description": "At most 25 leads, only when fulfilled. Use the download links for the full set."
},
"leads_shown": {
"type": "number"
},
"leads_total": {
"type": "number",
"description": "How many leads the order holds."
},
"leads_truncated": {
"type": "boolean",
"description": "True when more leads exist than the 25 shown inline."
},
"next_after_id": {
"type": [
"number",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"paid_at": {
"type": [
"string",
"null"
]
},
"livemode": {
"type": [
"boolean",
"null"
]
},
"notes": {
"description": "Plain sentences from the API about this order, for example that the same search already has an unpaid order.",
"type": "array",
"items": {
"type": "string"
}
},
"next_step": {
"type": "string",
"description": "What to do next, in plain words."
},
"url_elicitation": {
"description": "Whether the checkout link was also offered through URL-mode elicitation.",
"anyOf": [
{
"type": "string",
"enum": [
"sent",
"not_supported",
"declined",
"completed"
]
},
{
"type": "null"
}
]
}
},
"required": [
"order_id",
"status",
"leads",
"leads_shown",
"leads_total",
"leads_truncated",
"next_step"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_order(order_id)
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.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 8,
"maxLength": 80,
"pattern": "^[A-Za-z0-9_-]+$",
"description": "The order id returned by buy_leads, like \"ord_...\". Keep it secret: it grants the download."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"description": "The order id. Keep it secret."
},
"status": {
"type": "string",
"description": "awaiting_payment, paid, fulfilled, expired, canceled, refunded or failed."
},
"kind": {
"type": [
"string",
"null"
]
},
"quantity": {
"type": [
"number",
"null"
]
},
"matched": {
"type": [
"number",
"null"
]
},
"delivered": {
"type": [
"number",
"null"
]
},
"unit_price_cents": {
"type": [
"number",
"null"
]
},
"price_cents": {
"type": [
"number",
"null"
]
},
"price_usd": {
"type": [
"number",
"null"
]
},
"currency": {
"type": [
"string",
"null"
]
},
"payment_method": {
"type": [
"string",
"null"
]
},
"checkout_url": {
"description": "Open this page to pay (a person must do it).",
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
},
"download": {
"anyOf": [
{
"type": "object",
"properties": {
"json": {
"type": [
"string",
"null"
]
},
"csv": {
"type": [
"string",
"null"
]
},
"ndjson": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"leads": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": [
"number",
"string",
"null"
]
},
"business": {
"type": [
"string",
"null"
]
},
"owner_first": {
"type": [
"string",
"null"
]
},
"owner_last": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"cell": {
"type": [
"string",
"null"
]
},
"phone": {
"type": [
"string",
"null"
]
},
"phone_type": {
"type": [
"string",
"null"
]
},
"website": {
"type": [
"string",
"null"
]
},
"facebook": {
"type": [
"string",
"null"
]
},
"address": {
"type": [
"string",
"null"
]
},
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"zip": {
"type": [
"string",
"null"
]
},
"industry": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
"description": "At most 25 leads, only when fulfilled. Use the download links for the full set."
},
"leads_shown": {
"type": "number"
},
"leads_total": {
"type": "number",
"description": "How many leads the order holds."
},
"leads_truncated": {
"type": "boolean",
"description": "True when more leads exist than the 25 shown inline."
},
"next_after_id": {
"type": [
"number",
"null"
]
},
"created_at": {
"type": [
"string",
"null"
]
},
"paid_at": {
"type": [
"string",
"null"
]
},
"livemode": {
"type": [
"boolean",
"null"
]
},
"notes": {
"description": "Plain sentences from the API about this order, for example that the same search already has an unpaid order.",
"type": "array",
"items": {
"type": "string"
}
},
"next_step": {
"type": "string",
"description": "What to do next, in plain words."
},
"url_elicitation": {
"description": "Whether the checkout link was also offered through URL-mode elicitation.",
"anyOf": [
{
"type": "string",
"enum": [
"sent",
"not_supported",
"declined",
"completed"
]
},
{
"type": "null"
}
]
}
},
"required": [
"order_id",
"status",
"leads",
"leads_shown",
"leads_total",
"leads_truncated",
"next_step"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢account_status
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).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"email": {
"type": [
"string",
"null"
]
},
"plan": {
"description": "The monthly plan, or null when the account has only prepaid credits.",
"type": [
"string",
"null"
]
},
"plan_usage": {
"description": "Leads used today against the plan's daily allowance (plan customers only).",
"anyOf": [
{
"type": "object",
"properties": {
"plan": {
"type": [
"string",
"null"
]
},
"daily_cap": {
"type": [
"number",
"null"
]
},
"used_today": {
"type": [
"number",
"null"
]
},
"remaining_today": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"credits_usd": {
"description": "Prepaid credit balance in dollars.",
"type": [
"number",
"null"
]
},
"credits_cents": {
"type": [
"number",
"null"
]
},
"key_prefix": {
"description": "The first characters of the API key in use (never the whole key).",
"type": [
"string",
"null"
]
},
"spend_limit_daily_usd": {
"description": "This key's daily spend limit, or null for none.",
"type": [
"number",
"null"
]
},
"spent_today_usd": {
"type": [
"number",
"null"
]
},
"links": {
"type": "object",
"properties": {
"credits": {
"type": "string"
},
"orders": {
"type": "string"
},
"pricing": {
"type": "string"
},
"agents": {
"type": "string"
},
"docs": {
"type": "string"
}
},
"required": [
"credits",
"orders",
"pricing",
"agents",
"docs"
],
"additionalProperties": false
}
},
"required": [
"links"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🔴add_credits(amount_usd, idempotency_key)
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.
Input Schema
{
"type": "object",
"properties": {
"amount_usd": {
"type": "number",
"minimum": 10,
"maximum": 1000,
"description": "Top-up amount in US dollars, 10 to 1000."
},
"idempotency_key": {
"description": "Optional. Send the same value when retrying after a timeout so you are never charged twice for one purchase.",
"type": "string",
"minLength": 8,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_.:-]+$"
}
},
"required": [
"amount_usd"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"checkout_url": {
"type": "string",
"description": "A person must open this page to pay."
},
"session_id": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
},
"amount_usd": {
"type": [
"number",
"null"
]
},
"balance_usd": {
"type": [
"number",
"null"
]
},
"next_step": {
"type": "string"
},
"url_elicitation": {
"anyOf": [
{
"type": "string",
"enum": [
"sent",
"not_supported",
"declined",
"completed"
]
},
{
"type": "null"
}
]
}
},
"required": [
"checkout_url",
"next_step"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟡create_account(email, agent_name, use_case, idempotency_key)
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.
Input Schema
{
"type": "object",
"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."
},
"agent_name": {
"description": "Name of your agent or app.",
"type": "string",
"minLength": 1,
"maxLength": 80
},
"use_case": {
"description": "What you will use the leads for.",
"type": "string",
"minLength": 1,
"maxLength": 300
},
"idempotency_key": {
"description": "Optional. Send the same value when retrying after a timeout so you are never charged twice for one purchase.",
"type": "string",
"minLength": 8,
"maxLength": 128,
"pattern": "^[A-Za-z0-9_.:-]+$"
}
},
"required": [
"email"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"created": {
"type": "boolean"
},
"api_key": {
"description": "Shown once. Store it now.",
"type": [
"string",
"null"
]
},
"key_prefix": {
"type": [
"string",
"null"
]
},
"credits_usd": {
"type": [
"number",
"null"
]
},
"account": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"mcp_config": {
"anyOf": [
{
"type": "object",
"properties": {
"claude_code": {
"type": "string"
},
"cursor_mcp_json": {
"type": "object",
"properties": {},
"additionalProperties": {}
},
"generic_headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"claude_code",
"cursor_mcp_json",
"generic_headers"
],
"additionalProperties": {}
},
{
"type": "null"
}
]
},
"message": {
"type": "string"
},
"next_actions": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": {}
}
}
},
"required": [
"created",
"message",
"next_actions"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}🟢get_free_sample(email, name, phone)
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.
Input Schema
{
"type": "object",
"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": "Where to email the sample: the person's own address."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Name of the person asking for the sample."
},
"phone": {
"description": "Ignored: no text message is sent from this tool.",
"type": "string",
"minLength": 7,
"maxLength": 30
}
},
"required": [
"email",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"sent": {
"type": "boolean"
},
"email": {
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"sent",
"email",
"message"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {}
}Community
Evidence