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

A
Description quality
97%
Schema completeness
85%
Naming quality
93%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~7,275Tokens (tool definitions)
~6.2 KBTypical response size
Significant attention impact (5.68% of 128k context)

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-http

What it can do

Tool inventory

Tools (12)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded12 tools