Enables OpenAI Codex or ChatGPT to access LeadBrew's B2B lead database through REST API calls for lead search, company lookup, and usage tracking.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@LeadBrew MCP Server Find CTOs at fintech companies in New York"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
LeadBrew MCP Server is a Model Context Protocol server that gives AI coding assistants access to the LeadBrew B2B lead database. Search for leads, get contact information, and find companies—all through natural language.
Millions of B2B Leads - Access verified business contacts with emails and phone numbers
Company Database - Search companies by industry, size, and location
Real-time Search - Find leads by name, title, company, or industry
Free Tier - 100 leads/day included with every account
Works Everywhere - Compatible with Claude Code, Cursor, Windsurf, and more
Related MCP server: Prospeo MCP Server
Sign up at leadbrew.co
Go to Settings → API Access
Click Generate API Key
Save your API Key and API Secret
# Clone the repository
git clone https://github.com/FlatNineOrg/leadbrew-mcp.git
cd leadbrew-mcp
# Install dependencies
npm install
# Build the server
npm run buildSee configuration instructions for your specific assistant.
Add to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"leadbrew": {
"command": "node",
"args": ["/path/to/leadbrew-mcp/dist/index.js"],
"env": {
"LEADBREW_API_KEY": "lb_your_api_key_here",
"LEADBREW_API_SECRET": "your_api_secret_here"
}
}
}
}Add to your Cursor MCP settings (Settings → MCP Servers):
{
"leadbrew": {
"command": "node",
"args": ["/path/to/leadbrew-mcp/dist/index.js"],
"env": {
"LEADBREW_API_KEY": "lb_your_api_key_here",
"LEADBREW_API_SECRET": "your_api_secret_here"
}
}
}Add to your Windsurf configuration:
{
"mcpServers": {
"leadbrew": {
"command": "node",
"args": ["/path/to/leadbrew-mcp/dist/index.js"],
"env": {
"LEADBREW_API_KEY": "lb_your_api_key_here",
"LEADBREW_API_SECRET": "your_api_secret_here"
}
}
}
}Add to your VS Code settings:
{
"cline.mcpServers": {
"leadbrew": {
"command": "node",
"args": ["/path/to/leadbrew-mcp/dist/index.js"],
"env": {
"LEADBREW_API_KEY": "lb_your_api_key_here",
"LEADBREW_API_SECRET": "your_api_secret_here"
}
}
}
}For OpenAI-based assistants, use the REST API directly. See REST API examples.
Tool | Description |
| Search for leads by name, company, industry, position, country |
| Get full lead details including emails and phone numbers |
| Search for companies by name, industry, size |
| Get company details with employee list |
| Check your API quota and usage statistics |
You: Find CTOs at fintech companies in New York
AI: [Searches using leadbrew_search_leads]
Found 156 leads matching your criteria:
**John Smith**
Position: Chief Technology Officer
Company: PayFlow Inc (Fintech)
Country: US
LinkedIn: https://linkedin.com/in/johnsmith
Lead ID: TGVhZGJyZXdtaWtlXzEyMzQ1
**Sarah Johnson**
Position: CTO
Company: BlockPay Solutions (Fintech)
Country: US
LinkedIn: https://linkedin.com/in/sarahjohnson
Lead ID: TGVhZGJyZXdtaWtlXzY3ODkw
... and 154 more resultsYou: Get the contact details for John Smith
AI: [Uses leadbrew_get_lead with the lead ID]
**John Smith**
Position: Chief Technology Officer
Company: PayFlow Inc (Fintech)
Country: US
LinkedIn: https://linkedin.com/in/johnsmith
Emails:
- john.smith@payflow.com
- jsmith@payflow.io
Phones:
- +1 (555) 123-4567You: Find 10 marketing directors at SaaS companies with 50-200 employees
AI: [Searches with position="Marketing Director", industry="SaaS", min_size=50, max_size=200]
Found 89 leads. Here are the first 10:
1. **Emily Chen** - Marketing Director at CloudMetrics (Software/SaaS)
2. **Michael Brown** - Director of Marketing at DataSync Pro (SaaS)
3. **Jessica Williams** - Marketing Director at AppFlow Systems (SaaS)
...You: Tell me about Stripe's team
AI: [Uses leadbrew_get_company with include_employees=true]
**Stripe**
Website: stripe.com
Industry: Financial Technology
Size: 8,000+ employees
LinkedIn: https://linkedin.com/company/stripe
Employees in database: 234
Sample employees:
- Patrick Collison (CEO)
- John Collison (President)
- Claire Hughes Johnson (COO)
- David Singleton (CTO)
- Dhivya Suryadevara (CFO)You: How many leads do I have left today?
AI: [Uses leadbrew_usage]
**LeadBrew API Usage**
Today's Usage:
Leads used: 45/100
Leads remaining: 55
Requests made: 12
Last 7 Days:
Total leads: 312
Total requests: 89Search for B2B leads with various filters.
Parameters:
Parameter | Type | Description |
| string | Search query for lead name |
| string | Filter by company name |
| string | Filter by industry |
| string | Filter by job title |
| string | Country code (US, UK, DE, etc.) |
| number | Results per page (1-25) |
| number | Page number |
Get detailed information about a specific lead.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | Lead ID from search results |
Returns: Full lead profile including emails and phone numbers.
Search for companies in the database.
Parameters:
Parameter | Type | Description |
| string | Company name search |
| string | Filter by industry |
| string | Country code |
| number | Minimum employee count |
| number | Maximum employee count |
| number | Results per page (1-25) |
| number | Page number |
Get company details with optional employee list.
Parameters:
Parameter | Type | Required | Description |
| string | Yes | Company ID or LinkedIn handle |
| boolean | No | Include employee list |
Check your API usage and quota.
Parameters:
Parameter | Type | Description |
| number | Days of history (1-90) |
Limit | Value |
Daily lead quota | 100 leads |
Max per request | 25 leads |
Company searches | Unlimited |
Rate limit reset | Midnight UTC |
You can also use the LeadBrew REST API directly:
curl -X GET "https://leadbrew.co/api/v1/leads?q=john&industry=Technology&limit=10" \
-H "X-API-Key: lb_your_api_key" \
-H "X-API-Secret: your_api_secret"See examples/rest-api.md for more REST API examples.
Make sure your environment variables are set correctly:
LEADBREW_API_KEY should start with lb_
LEADBREW_API_SECRET should be 64 characters
You've used your daily quota of 100 leads. The limit resets at midnight UTC.
Check that:
Your API key is active (not revoked)
The key and secret match
No extra spaces in your configuration
Documentation: leadbrew.co/api-docs
Issues: GitHub Issues
Email: support@leadbrew.co
MIT License - See LICENSE for details.
Get detailed information about a specific company including employee list.
Inputs: id (required), include_employees.
Get detailed information about a specific lead including email addresses and phone numbers. Requires the lead ID from a previous search.
Inputs: id (required).
Search for companies in the LeadBrew database. Returns company info including name, website, industry, and size.
Inputs: q, page, limit, country, +3 more.
Search for B2B leads/contacts in the LeadBrew database. Returns name, position, company, and LinkedIn profile. Use the lead ID to get full contact details including email and phone.
Inputs: q, page, limit, company, +3 more.
Check your LeadBrew API usage and remaining quota for today.
Inputs: days.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool targets a distinct resource/action: search vs get for companies and leads, plus a separate usage check. No overlap or ambiguity.
All tools follow a consistent 'leadbrew_verb_noun' pattern with underscores, making them predictable and easy to parse.
With 5 tools, the set is well-scoped for a B2B lead generation data provider—covering search and detail retrieval for companies and leads, plus quota monitoring.
The tool set covers core search and detail retrieval for both leads and companies, plus usage tracking. Lacks mutation endpoints (e.g., add/update lead), but this is appropriate for a read-focused API.
Search B2B people, companies and local businesses and build lead lists from your AI assistant.
Search companies, enrich contacts, and reveal emails and phones from your AI agent.
Find B2B leads with verified work emails and mobile numbers from your AI assistant.
Verify and find B2B emails, search leads and run bulk jobs from your AI assistant.
