FlashLeads MCP Server

# Quick Start Guide Get started with FlashLeads MCP Server in 5 minutes. ## Step 1: Get Your API Key 1. Go to [FlashLeads](https://flashleads.io) 2. Sign up or log in 3. Navigate to Settings → API Keys 4. Click "Create New API Key" 5. Copy your API key (starts with `fl_...`) ## Step 2: Install ```bash # Clone the repository git clone https://github.com/yourusername/flashleads-mcp-server cd flashleads-mcp-server # Install dependencies npm install # Build the project npm run build ``` ## Step 3: Configure Claude Desktop 1. Open Claude Desktop config file: - **MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` 2. Add this configuration: ```json { "mcpServers": { "flashleads": { "command": "node", "args": ["/FULL/PATH/TO/flashleads-mcp-server/build/index.js"], "env": { "FLASHLEADS_API_KEY": "fl_your_actual_api_key_here" } } } } ``` 3. **Important**: Replace `/FULL/PATH/TO/` with the actual path on your system 4. **Important**: Replace `fl_your_actual_api_key_here` with your real API key ## Step 4: Restart Claude Desktop 1. Completely quit Claude Desktop 2. Reopen Claude Desktop 3. Look for the 🔌 icon in the bottom right - it should show "flashleads" as connected ## Step 5: Try It Out! Ask Claude: ``` "Find me 10 coffee shop leads in Seattle" ``` Claude will: 1. Use `run_web_harvest` to start searching 2. Use `get_web_harvest_status` to check progress 3. Use `get_web_harvest_leads` to retrieve results 4. Present the leads to you with all contact information ## Example Prompts - "Find 20 restaurant leads in New York City" - "Get me Italian restaurant contacts in Los Angeles" - "Search for coffee shops in Seattle and show me their websites and phone numbers" - "Find plumbing companies in Texas" ## Troubleshooting ### Tools not showing up in Claude 1. Check the config file path is correct 2. Ensure the full path to `build/index.js` is correct (use `pwd` command to get it) 3. Restart Claude completely 4. Check Claude's logs for errors ### "Invalid API Key" error 1. Verify your API key is correct (starts with `fl_`) 2. Check the key hasn't expired in FlashLeads settings 3. Ensure there are no extra spaces in the config file ### "Rate limit exceeded" error - Default limit is 100 requests/hour - Wait for the hour to reset - Or contact support for higher limits ## What's Next? - Read the full [README.md](README.md) for all tool details - Check out more examples in the documentation - Join our community for support ## Support Need help? Email us at support@flashleads.io