# B2B Lead Enrichment MCP API

The MCP-native API that AI agents use to enrich B2B company profiles with structured data.

## Live Production URL

```
https://lead-enrichment-mcp.agent-infra.workers.dev
```

**Status**: Live and accepting requests

## Quick Start

```bash
# Test the API
curl https://lead-enrichment-mcp.agent-infra.workers.dev/health

# Enrich a company (replace with your API key)
curl -X POST https://lead-enrichment-mcp.agent-infra.workers.dev/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"enrich_lead","arguments":{"domain":"stripe.com"}}}'
```

## Pricing

| Tier | Monthly | Price | Overage |
|------|---------|-------|---------|
| Free | 100 enrichments | $0 | N/A |
| Pro | 10,000 enrichments | $49/month | $0.05/enrichment |
| Enterprise | Unlimited | Contact us | Custom |

**Billing**: Only for successful, high-confidence enrichments (confidence > 0.6). No charge for failed or low-quality enrichments.

## Get an API Key

1. Visit [https://lead-enrichment-mcp.agent-infra.workers.dev](https://lead-enrichment-mcp.agent-infra.workers.dev)
2. Sign up for free tier or upgrade
3. Copy your API key

## MCP-Native for AI Agents

This API is built on the Model Context Protocol (MCP), making it natively discoverable and callable by AI agents like Claude, Cursor, and ChatGPT.

### Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "lead-enrichment": {
      "command": "npx",
      "args": ["-y", "@anthropic-ai/mcp-server-lead-enrichment"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}
```

### Cursor

Add in Cursor Settings > MCP > Add New Server:

```json
{
  "mcpServers": {
    "lead-enrichment": {
      "type": "http",
        "url": "https://lead-enrichment-mcp.agent-infra.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}
```

### VS Code Copilot

Create `.vscode/mcp.json`:

```json
{
  "servers": {
    "lead-enrichment": {
      "transport": "streamable-http",
        "url": "https://lead-enrichment-mcp.agent-infra.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}
```

### ChatGPT GPTs

Use the OpenAPI schema:
```
https://lead-enrichment-mcp.agent-infra.workers.dev/openapi.json
```

## API Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `/mcp` | MCP JSON-RPC endpoint |
| GET | `/health` | Health check |
| GET | `/.well-known/mcp-server.json` | MCP Server Card |
| GET | `/openapi.json` | OpenAPI 3.1 spec |
| GET | `/docs` | Human-readable docs |
| GET | `/test/enrich?domain=stripe.com` | Test endpoint (auth required) |

## Example Response

For `stripe.com`:

```json
{
  "companyName": "Stripe, Inc.",
  "industry": "Fintech",
  "employeeCount": "5000+",
  "revenue": "$1B+",
  "technologies": [
    "React",
    "Ruby on Rails",
    "PostgreSQL",
    "Redis",
    "Kubernetes",
    "AWS"
  ],
  "intentSignals": [
    "Recently hired 3 Sales VPs in Q2 2026",
    "Expanding EU operations with new Dublin office"
  ],
  "confidenceScore": 0.95,
  "enrichedAt": "2026-06-19T12:00:00.000Z",
  "insights": [
    "High buying intent: Recently hired multiple sales VPs indicating expansion phase",
    "Enterprise-grade requirements suggest need for robust security and compliance features",
    "European expansion signals potential need for multi-currency and regional compliance"
  ]
}
```

## The `enrich_lead` Tool

### When to Use

- Qualify a lead before outreach
- Research a company before a sales call
- Enrich a list of companies for a campaign
- Understand a prospect's technology stack
- Detect buying intent signals

### Input

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `domain` | string | Yes | Company domain (e.g., "stripe.com") |
| `attributes` | string[] | No | Data types: firmographic, technographic, intent, contacts |
| `requiredFields` | string[] | No | Fields that must be present |

## Error Handling

All errors follow RFC 9457 Problem Details format:

```json
{
  "type": "https://api.lead-enrichment-mcp.com/errors/rate-limit-exceeded",
  "title": "Rate Limit Exceeded",
  "detail": "You have exceeded the rate limit...",
  "status": 429,
  "extensions": {
    "code": "RATE_LIMIT_EXCEEDED",
    "retry_after": 60
  }
}
```

## Rate Limits

| Tier | Burst | Sustained |
|------|-------|-----------|
| Free | 10 req/sec | 5 req/sec |
| Pro | 50 req/sec | 20 req/sec |

## Development

```bash
# Install dependencies
npm install

# Start local dev server
npm run dev

# Deploy
npm run deploy
```

## Tech Stack

- **Hono** (TypeScript) - Fast, lightweight web framework
- **Cloudflare Workers** - Edge runtime
- **Zod** - Schema validation with .describe() annotations
- **MCP SDK** - Model Context Protocol
- **Stripe** - Metered billing

## License

MIT