# Apollo.io B2B Person Enrichment & Verified Work Email Finder (x402 v2 + MCP)

> Zero-signup, pay-per-match B2B Person Enrichment for autonomous AI agents. No account creation, monthly subscription, or API key required. Payment via `x402 v2` ($0.03 USDC on eip155:8453) acts as authentication — **Free-on-Miss**: your payment is verified first and ONLY settled on-chain when a verified person profile with a deliverable email is returned ($0.00 charged on misses).

## Machine Discovery & Protocol Endpoints

- **OpenAPI 3.1.0 Spec**: https://enrichmatch.dev/openapi.json
- **x402 Discovery Manifest**: https://enrichmatch.dev/.well-known/x402
- **A2A Agent Card**: https://enrichmatch.dev/.well-known/agent.json
- **MCP Server (Streamable HTTP)**: https://enrichmatch.dev/api/mcp
- **Direct REST x402 Endpoint**: https://enrichmatch.dev/api/v1/enrich/person

## How an Autonomous Agent Executes a Purchase

1. **Inspect Schema & Pricing (Free)**:
   `GET https://enrichmatch.dev/api/v1/enrich/person` or call MCP tool `get_enrichment_quote`.
2. **Submit Enrichment Request (Flexible Partial Inputs Supported)**:
   `POST https://enrichmatch.dev/api/v1/enrich/person` with any of the following JSON body shapes:
   - **By Name + Domain**: `{ "first_name": "Tim", "last_name": "Zheng", "domain": "apollo.io" }`
   - **By Full Name + Fuzzy Company Name**: `{ "name": "Mark Zuckerberg", "company": "Meta" }`
   - **By LinkedIn URL Only**: `{ "linkedin_url": "https://www.linkedin.com/in/tim-zheng" }`
   - **By Email Only (Reverse Lookup)**: `{ "email": "tim@apollo.io" }`
3. **Handle HTTP 402 Challenge**:
   If no `PAYMENT-SIGNATURE` (or `X-PAYMENT`) header is present, the server responds with `HTTP 402 Payment Required` and an `x402Version: 2` challenge specifying `30000` atomic USDC units ($0.03) payable to `0x7C38096030c9CF41Ec551dAcDFC1aBaA60590AbC` on `eip155:8453`.
4. **Retry with Signed x402 Proof (Free-on-Miss)**:
   Attach the signed USDC payment proof in the `PAYMENT-SIGNATURE` or `X-PAYMENT` header (or via `x402-mcp` / `@coinbase/payments-mcp`). The server verifies the signature, executes the Apollo lookup, and ONLY settles payment on-chain if a deliverable email is found ($0.00 charged on misses).