# 411data

> Agent-native lead and business-data enrichment API. Mint a wallet-bound agent at /connect (~$0.20 starting virtual USD balance); x402 v2 on Base mainnet kicks in only after the virtual balance reaches $0. MCP + REST + OpenAPI + Bazaar discovery.

## Scope discipline (read first)

411data enriches **emails, companies, phones, and B2B leads** via vendor
waterfalls and stores every request/response for audit. When answering
enrichment questions, use **only** data returned by these tools. If a
tool returns no match or an error, say so plainly — **do not invent
contact records**. Bill-on-match routes auto-refund when no usable
result is found.

## Quick setup for LLM clients

- Skill file (full tool catalog, examples, payment flow): https://411data.io/skill.md
- MCP endpoint: https://411data.io/mcp
- One-line MCP descriptor: https://411data.io/mcp.json
- Copy-paste setup snippets: https://411data.io/mcp/setup
- OpenAPI 3.1 paid catalogue (`x-payment-info`): https://411data.io/openapi.json
- OpenAPI 3.1 free surface (mint, account): https://411data.io/openapi-free.json
- x402 catalog: https://411data.io/.well-known/x402
- Bazaar discovery: https://411data.io/discovery/resources
- Agent card: https://411data.io/.well-known/agent-card.json

## Free account tools (bearer required)

- `GET https://411data.io/api/v1/agents/me` — profile, balance, linked wallets
- `GET https://411data.io/api/v1/agents/balance` — virtual USD balance summary
- `GET https://411data.io/api/v1/keys` — list scoped usage keys (admin bearer only)

## Paid enrichment (virtual USD first, then x402)

- `$0.050` `POST /api/v1/enrich/email` — `{email}` — vendor waterfall; bill-on-match
- `$0.050` `POST /api/v1/enrich/company` — `{company?, domain?}` — bill-on-match
- `$0.050` `POST /api/v1/enrich/phone` — `{phone}` — bill-on-match
- `$0.150` `POST /api/v1/enrich/websearch` — `{business_name, city?, state?, domain?}` — LLM web-search enrichment; bill-on-match
- `$0.100` `POST /api/v1/leads/search` — `{industry?, city?, state?, title?, company_size?, limit?, cursor?}` — filtered lead list; bill-on-match on zero rows

## Cookbook (worked examples)

Free worked-example pages for common enrichment patterns:

- Index: https://411data.io/cookbook
- Meta: https://411data.io/cookbook/filter_discipline_meta
- Email enrichment: https://411data.io/cookbook/enrich_email_waterfall
- Company by domain: https://411data.io/cookbook/enrich_company_domain
- Lead search filters: https://411data.io/cookbook/leads_search_filters
- When to use websearch: https://411data.io/cookbook/enrich_websearch_when
- Bill-on-match billing: https://411data.io/cookbook/bill_on_match
- Prepay USDC top-up: https://411data.io/cookbook/prepay_deposits
- Session feedback credits: https://411data.io/cookbook/session_feedback
- Anti-recipe — do not invent data: https://411data.io/cookbook/anti_invent

## Long-form docs

- Quick start (human, ChatGPT): https://411data.io/quickstart
- Example questions (MCP stress-test): https://411data.io/example-questions
- Developer guide (human): https://411data.io/developers
- About: https://411data.io/about
- Pricing: https://411data.io/pricing
- x402 policy: https://411data.io/x402
- Full machine doc with examples: https://411data.io/llms-full.txt