Data Candy: US business leads

Count, preview and quote US business leads for free, then buy them with a spending limit.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
97%
Integridad del esquema
85%
Calidad de los nombres
93%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~7,275Tokens (definiciones de herramientas)
~6.2 KBTamaño de respuesta típico
Impacto significativo en la atención (5.68% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "leads": {
      "url": "https://datacandy.co/mcp"
    }
  }
}

Puntos de conexión remotos

https://datacandy.co/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (12)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.

Esquema de entrada

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Esquema de salida

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

Esquema de entrada

{
  "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
}

Esquema de salida

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

Esquema de entrada

{
  "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
}

Esquema de salida

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

Esquema de entrada

{
  "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
}

Esquema de salida

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

Esquema de entrada

{
  "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
}

Esquema de salida

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

Esquema de entrada

{
  "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
}

Esquema de salida

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

Esquema de entrada

{
  "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
}

Esquema de salida

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

Esquema de entrada

{
  "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
}

Esquema de salida

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

Esquema de entrada

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Esquema de salida

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

Esquema de entrada

{
  "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
}

Esquema de salida

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

Esquema de entrada

{
  "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
}

Esquema de salida

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

Esquema de entrada

{
  "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
}

Esquema de salida

{
  "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": {}
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada12 herramientas