{"data":{"name":"co.datacandy/leads","title":"Data Candy: US business leads","description":"Count, preview and quote US business leads for free, then buy them with a spending limit.","version":"1.0.0","websiteUrl":"https://datacandy.co/agents","repositoryUrl":null,"remotes":[{"type":"streamable-http","url":"https://datacandy.co/mcp","headers":[{"description":"Bearer dc_live_... API key; optional, only for account tools","isSecret":true,"name":"Authorization"}]}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-11-17T21:34:10.081Z","updatedAt":"2026-11-17T21:34:10.081Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"co.datacandy/leads","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-17T21:34:10.081Z","title":"Data Candy: US business leads","description":"Count, preview and quote US business leads for free, then buy them with a spending limit.","websiteUrl":"https://datacandy.co/agents","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"account_status","title":"Account status","description":"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).","inputSchema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"title":"Account status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"1479fd317fb28f64f91a4c82b247268dfaba40f8f3867800c344f20972074ba6","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"},{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"add_credits","title":"Add credits","description":"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.","inputSchema":{"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},"annotations":{"title":"Add credits","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"5087bbded8fd4f191c9ac55af0d3df252f932a3d3a1d4c0e1ae2418bd5586013","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"},{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"buy_leads","title":"Buy leads","description":"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.","inputSchema":{"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},"annotations":{"title":"Buy leads","readOnlyHint":false,"destructiveHint":true,"idempotentHint":false,"openWorldHint":true},"definitionHash":"0364989389e2b9ef67dce5bd4e27864cad1ce11cd5c6b514430e90b69998b5f8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"},{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"count_leads","title":"Count leads","description":"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.","inputSchema":{"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},"annotations":{"title":"Count leads","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"28b04c095e41213334cf89a77d70396c4a0576cc7b2203609ca4ae03feb41314","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"},{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"create_account","title":"Create an account and API key","description":"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.","inputSchema":{"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},"annotations":{"title":"Create an account and API key","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"0f88f0cb8d110d5b67e49183d966ac5a68be01f20253ede7ff8269892500d442","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"},{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"database_overview","title":"Database overview","description":"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.","inputSchema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false},"annotations":{"title":"Database overview","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"99337ebc2940b54a5d449097566000ddf38fda7d4f83f70d661ff4dab84a066d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"},{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"get_free_sample","title":"Email a free sample","description":"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.","inputSchema":{"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},"annotations":{"title":"Email a free sample","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"5bd669381fd262e1cbb0f1896cabdc1552c971c9e080818dca1c1bf71e186f76","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"},{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"get_order","title":"Get an order","description":"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.","inputSchema":{"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},"annotations":{"title":"Get an order","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"3fbb1161e5412f259a9e3337e0c05c38fc1527a6be875b506a819fbeaec86160","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"},{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"list_industries","title":"List industries and categories","description":"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.","inputSchema":{"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},"annotations":{"title":"List industries and categories","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"60847b0fa864490cd071e71987bf2fff571f1d2492676c751016753b1311687e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"},{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"list_locations","title":"List states and cities","description":"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.","inputSchema":{"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},"annotations":{"title":"List states and cities","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"d16dd9400001bb194ff36f6de0af399f000445a0fee6d90fdc80beb58a6ec479","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"},{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"preview_leads","title":"Preview leads","description":"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.","inputSchema":{"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},"annotations":{"title":"Preview leads","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"061369ebc66de4e336ad855dab0ab55fa67f59103986259ea5a92bfa452fe7bd","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"},{"serverName":"co.datacandy/leads","endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","name":"quote_leads","title":"Quote a purchase","description":"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.","inputSchema":{"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},"annotations":{"title":"Quote a purchase","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"a72b3dd861ed13a4e217d8a190fb025ed115e3d66f8b802aff0e6b6245f4d9a4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-18T03:46:42.928Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"d1ae09860b5dd7ee30d274b0be5eb2d791cec26a257e47a8aeef6d896ddb5b37","protocol":"streamable-http","status":"indexed","toolCount":12,"observedAt":"2026-11-18T03:46:42.928Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"co.datacandy/leads":{"url":"https://datacandy.co/mcp"}}},"Cursor":{"mcpServers":{"co.datacandy/leads":{"url":"https://datacandy.co/mcp"}}},"VS Code":{"servers":{"co.datacandy/leads":{"type":"http","url":"https://datacandy.co/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://datacandy.co/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:co.datacandy%2Fleads","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/co.datacandy%2Fleads","name":"co.datacandy/leads","description":"Count, preview and quote US business leads for free, then buy them with a spending limit.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://datacandy.co/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://datacandy.co/agents","repositoryUrl":null,"version":"1.0.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"co.datacandy/leads","status":"online","lastCheckedAt":"2026-11-20T04:16:02.576Z","lastSuccessfulCheck":"2026-11-20T04:16:02.576Z","latencyMs":257,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T04:16:02.576Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T04:16:02.576Z"},"security":null,"timestamps":{"createdAt":"2026-11-17T21:34:10.081Z","updatedAt":"2026-11-17T21:34:10.081Z","observedAt":"2026-11-20T04:16:02.576Z"},"compatibility":{"serverVersion":"1.0.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}