Meta Agent Tools
PT

Back to the catalog

B2B Lead Enrichment

Remote MCP server to enrich company profiles with structured B2B data and confidence scores.

Open source Repository Open in the app JSON README (API)

About

Remote MCP server to enrich company profiles with structured B2B data and confidence scores.

Details

Kind
MCP servers
Topic
No topic detected
Publisher
diego-costa-tech
Origin
official
Category
ferramentas
Transport
http
Version
1.0.0
Last push
2026-07-14T11:02:33Z
Repository state
ativo
Language
TypeScript
Added
2026-08-29 03:01:50
Updated
2026-08-29 03:01:50
Origin id
io.github.Diego-Costa-Tech/lead-enrichment-mcp

README

# 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

More