Leads Intelligence MCP Server

Connect to your AI assistant for conversational lead management, enrichment orchestration, and contractor matching.

Subscription Requirements

Client	Free Account	Pro/Max	Team/Enterprise
Claude.ai (Web)	No	Yes	Yes
Claude Desktop	Yes (local only)	Yes	Yes
Claude Code (CLI)	Yes	Yes	Yes
Cursor IDE	Yes	Yes	N/A
Continue (VSCode)	Yes	Yes	N/A

---

Claude.ai (Web Client)

Requirements: Claude Pro ($20/mo), Max ($100/mo), Team, or Enterprise subscription

Note: As of May 2025, MCP Integrations are available to Pro users. Previously this was Max-only.

Setup Steps

1. Go to claude.ai and sign in
2. Click your profile icon → Settings
3. Navigate to Integrations (left sidebar)
4. Click + Add Custom Integration
5. Enter:
   • Name: Leads Intelligence
   • URL: Your hosted MCP server URL (see Hosting Options below)
6. Click Save

Hosting Options for Web Client

The Claude.ai web client requires a publicly accessible URL for your MCP server:

Option	Difficulty	Cost
FastMCP Cloud	Easy	Free tier available
Cloudflare Tunnel	Medium	Free
Self-hosted with HTTPS	Advanced	Varies

---

Claude Desktop App

Requirements: Free account works for local servers

macOS Setup

1. Download Claude Desktop
2. Open the config file:

   open ~/Library/Application\ Support/Claude/claude_desktop_config.json

3. Add the MCP server configuration:

   {
     "mcpServers": {
       "leads": {
         "command": "uvx",
         "args": ["--from", "git+https://git.supported.systems/qube/leads.git", "leads-mcp"],
         "env": {
           "SKIP_AUTH": "true",
           "DATABASE_URL": "postgresql+asyncpg://user:pass@host:5432/leads_viewer"
         }
       }
     }
   }

4. Restart Claude Desktop

Windows Setup

1. Download Claude Desktop
2. Open the config file at %APPDATA%\Claude\claude_desktop_config.json
3. Add the same configuration as above
4. Restart Claude Desktop

---

Claude Code (CLI)

Requirements: Works with any Anthropic API key

Quick Setup

# Add the MCP server
claude mcp add leads \
  -e SKIP_AUTH=true \
  -e "DATABASE_URL=postgresql+asyncpg://user:pass@localhost:5432/leads_viewer" \
  -- uvx --from /path/to/leads-viewer leads-mcp

# Or if installed globally
claude mcp add leads -- uvx leads-mcp

Verify Installation

# List MCP servers
claude mcp list

# Check server status (inside Claude Code)
/mcp

---

Cursor IDE

Requirements: Works with free Cursor account

Setup Steps

1. Open Cursor Settings (Cmd+, or Ctrl+,)
2. Search for “MCP” in settings
3. Click Edit in settings.json
4. Add:

   {
     "mcpServers": {
       "leads": {
         "command": "uvx",
         "args": ["--from", "/path/to/leads-viewer", "leads-mcp"],
         "env": {
           "SKIP_AUTH": "true",
           "DATABASE_URL": "postgresql+asyncpg://..."
         }
       }
     }
   }

5. Restart Cursor

---

Continue (VSCode Extension)

Requirements: Works with free VSCode

Setup Steps

1. Install the Continue extension
2. Open Continue config: ~/.continue/config.json
3. Add to the mcpServers section:

   {
     "mcpServers": [
       {
         "name": "leads",
         "command": "uvx",
         "args": ["--from", "/path/to/leads-viewer", "leads-mcp"],
         "env": {
           "SKIP_AUTH": "true",
           "DATABASE_URL": "postgresql+asyncpg://..."
         }
       }
     ]
   }

4. Reload VSCode

---

Environment Variables

Variable	Required	Description
DATABASE_URL	Yes	PostgreSQL connection string (asyncpg format)
SKIP_AUTH	No	Set to true to bypass Keycloak authentication
KEYCLOAK_TOKEN	No	Keycloak access token for authenticated access
LEADS_TOKEN	No	Alternative token variable name
TRACERFY_API_KEY	No	For skip trace enrichment features

Database URL Format

postgresql+asyncpg://username:password@hostname:port/database_name

---

Available Tools

Once connected, you’ll have access to:

Lead Management

• search_leads - Search with filters or natural language
• get_lead - Get full lead details
• create_lead_from_text - Parse natural language into leads
• update_lead - Update lead fields

Enrichment

• cad_lookup - County Appraisal District lookup
• enrich_lead - Run enrichment pipeline
• submit_skip_trace - Queue leads for Tracerfy
• check_skip_trace_balance - Check Tracerfy credits

Contractor Matching

• find_contractors - Match contractors by location/capability
• assign_contractor - Assign contractor to lead
• analyze_coverage - Find coverage gaps

Live Data Resources

• leads://feed/recent - Recent leads
• leads://feed/today - Today’s leads
• leads://analytics/summary - Dashboard stats
• leads://health - System health

---

Troubleshooting

”MCP server not found”

• Ensure uvx is installed: pip install uv
• Check the path to leads-viewer is correct
• Verify DATABASE_URL is accessible

”Authentication failed”

• Set SKIP_AUTH=true for local development
• Or provide a valid KEYCLOAK_TOKEN

”Connection refused”

• Check if the database is running
• Verify firewall allows the connection
• Try psql to test database connectivity directly