Integrations
How to Use the MCP Server
✓ Quick Answer
SMB Sales Boost provides an MCP (Model Context Protocol) server that lets AI assistants like Claude search leads, export data, manage filter presets, and more on your behalf. Connect it to Claude Code, Cursor, Claude Desktop (through the mcp-remote bridge) or another MCP client that can send your API key in an Authorization header.
How to Use the SMB Sales Boost MCP Server
The MCP (Model Context Protocol) server lets you use AI assistants to interact with your SMB Sales Boost account through natural language. Ask your assistant to search for leads, export data, manage keyword lists, set up email schedules, and purchase credits - all through conversation.
What Is MCP?
MCP is an open protocol that allows AI assistants to connect to external tools and data sources. SMB Sales Boost's MCP server exposes our API functionality as tools that AI assistants can call on your behalf.
The server runs at https://smbsalesboost.com/mcp (Streamable HTTP) and signs you in with your API key, sent in an Authorization: Bearer header. Any MCP client that connects to remote servers over HTTP and can send a request header works; this guide covers Claude Code, Cursor and Claude Desktop. Connector screens that only offer an OAuth sign-in cannot use an API key.
Find the highest-converting local businesses for outbound sales 🚀 Traditional lead databases give you thousands of leads that don't convert. SMB Sales Boost finds the prospects other databases miss, with email, phone and fresh buying signals, so you can increase sales by 10-20%.
Get Your API Key
Log in, open Dashboard > API and create or copy your API key (it starts with smbk_). Keep it private like a password: anyone who has it can use your account and spend your credits. You can revoke a key in the same place.
Setting Up with Claude Code
For Claude Code (the CLI tool), run this in your terminal with your own API key:
claude mcp add --transport http smb-sales-boost https://smbsalesboost.com/mcp --header "Authorization: Bearer smbk_your_api_key_here"
Then run /mcp inside Claude Code to check that smb-sales-boost is connected.
Setting Up with Cursor
Add the server to ~/.cursor/mcp.json (all your projects) or to .cursor/mcp.json in one project:
{
"mcpServers": {
"smb-sales-boost": {
"type": "http",
"url": "https://smbsalesboost.com/mcp",
"headers": {
"Authorization": "Bearer smbk_your_api_key_here"
}
}
}
}
Keep the key in the global ~/.cursor/mcp.json rather than in a project file you commit to git.
Setting Up with Claude Desktop
Claude Desktop's configuration file starts local MCP servers, so Claude Desktop reaches our remote server through the open-source mcp-remote bridge. The bridge runs with npx, so Node.js must be installed on your computer.
- Get your API key - Open Dashboard > API and create or copy your API key
- Open Claude Desktop settings - Go to Settings > Developer > Edit Config
- Add the SMB Sales Boost MCP server to your configuration (
claude_desktop_config.json):
{
"mcpServers": {
"smb-sales-boost": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://smbsalesboost.com/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer smbk_your_api_key_here"
}
}
}
}
- Restart Claude Desktop to load the new server
- Start asking questions - "Search for plumbing companies in Texas" or "Export my filtered leads to CSV"
Keep Authorization:${AUTH_HEADER} exactly as written, without a space after the colon: mcp-remote fills in the header from the AUTH_HEADER value, which avoids a problem with spaces in arguments on Windows.
Credits
search_leads and export_leads return full contact details: each new lead costs 1 credit, and a lead you already received through any channel is never charged again. preview_leads tests your filters for free, with the contact details masked. Ask the assistant to set maxCredits to cap what one call can spend. A call never spends past a zero balance unless you turned on overage billing or auto top-up (both are off by default), which can charge the card on file.
Long-Running Requests
A tool whose work is still running after about 40 seconds answers with a job id instead of the result. The assistant then calls get_job with that id until the result is ready. It should never repeat export_leads to get the result: a new export call can pick, and charge for, new leads.
Available MCP Tools
The tools by group. The MCP server reference lists every tool with its parameters.
Lead Search and Export
- search_leads - Search and filter leads with keywords, location, date ranges, and more, with full contact details
- preview_leads - Test filters for free: contact details stay masked, except for leads you already bought
- export_leads - Export leads to CSV, JSON, or XLSX (also saved to Export History for 90 days)
- list_schema_types - List available website schema types for filtering
- get_database_settings - Check which lead database your account uses
Long-Running Requests
- get_job - Get the result of a request that was still running
Enrichment
- start_enrichment - Enrich a list of website URLs with business and contact details
- list_enrichments / get_enrichment / download_enrichment - Check your enrichment runs and their cost, and download a finished file
Filter Presets and Keywords
- list_filter_presets / create_filter_preset / delete_filter_preset - Manage saved search filters
- list_keyword_lists / create_keyword_list / update_keyword_list / delete_keyword_list - Manage keyword lists
Email Schedules
- list_email_schedules / create_email_schedule / update_email_schedule / delete_email_schedule - Manage automated email exports
- trigger_email_schedule - Manually trigger an active schedule
Export Formats
- list_export_formats / get_export_format / create_export_format / update_export_format / delete_export_format - Custom export column configurations
- set_default_export_format - Set your default export format
Export History
- list_export_history / download_export - Access past export files (each one can be downloaded for 90 days)
- list_lead_export_history / get_lead_export_history_ids - See the leads you exported
- refresh_lead_export_history / re_export_lead_export_history / refresh_and_export_lead_export_history - Refresh exported leads with newer data and export them again
Export Blacklist
- list_export_blacklist / add_export_blacklist / delete_export_blacklist - Manage domains excluded from exports
Credits and Billing
- purchase_credits - Buy additional credits
- get_auto_top_up / update_auto_top_up - Configure automatic credit replenishment
- get_overage_budget / update_overage_budget - Set a budget for usage past a zero balance, billed daily
- cancel_subscription - Cancel your subscription
- change_plan - Upgrade or downgrade your plan
AI Features
- ai_suggest_categories - Get AI-powered category suggestions
- ai_generate_keywords / ai_keyword_status - AI keyword generation: each call adds new keyword lists for up to 3 categories and never deletes existing ones; several can run at once
- ai_auto_refine_enable / ai_auto_refine_disable / ai_auto_refine_status - AI keyword auto-refinement
Integrations
- list_integration_providers / list_integrations / get_integration - See the available CRMs and webhook tools, and your integrations
- create_webhook_integration - Send lead data to Zapier, n8n, Make, Pipedream, Clay or any HTTPS URL on the events you choose (the signing secret is shown only once)
- update_integration / delete_integration - Rename, pause, resume, re-point or remove an integration
- connect_crm - Get a HubSpot, Salesforce or Pipedrive authorization link to open in your browser (available when the CRM is configured). Signing in to a CRM account that is already connected reconnects it in place: it gets new access, and its events, field mapping and delivery history are kept
- push_lead_to_integration - Push one lead now (1 credit when the lead is new to you)
- test_integration / list_integration_deliveries / retry_integration_delivery - Send a test event, check recent deliveries and resend one
- get_integration_field_mapping / update_integration_field_mapping / reset_integration_field_mapping / test_integration_field_mapping - Choose which CRM field receives each lead field
- list_pipedrive_pipelines / list_pipedrive_deal_fields - Set up Pipedrive deal creation
Integrations send business contact details outside SMB Sales Boost automatically, so the assistant should confirm the destination with you first. When an API key or MCP client creates, connects, re-points or re-enables an integration, or adds events to one, the account owner is emailed for each change. During bursts of more than 10 changes in an hour, further changes are combined into summary emails.
Account
- get_profile / update_profile - View and edit your profile
Purchasing (No Authentication Required)
- purchase - Start a new subscription; your API key is emailed after checkout
- claim_key - Legacy: only for older purchases that came with a claim token
Example Conversations
Finding leads: "Find growing plumbing companies in Florida and Texas"
Exporting data: "Export all restaurant leads in California to a CSV file"
Managing schedules: "Set up a daily email export of new construction companies in New York, and send it to team@mycompany.com"
Credit management: "How many credits do I have left? Purchase 500 more."
Troubleshooting
- 401 Unauthorized - The API key is missing, mistyped or revoked. Check that the header is
Authorization: Bearerfollowed by your key. - 403 Forbidden - API access needs an active paid subscription or free trial. Check your plan in the dashboard.
- 429 Too Many Requests - Too many requests in a short time. Wait as long as the answer says, then try again (see Rate Limits).
- Out of credits - Buy credits in the dashboard, or use
preview_leads, which is free.
Requirements
- An active paid subscription (Starter, Growth, Scale, Platinum, or Enterprise), including the 14-day free trial
- Your SMB Sales Boost API key (Dashboard > API)
- Claude Code, Cursor, Claude Desktop with mcp-remote, or another MCP client that can send an Authorization header
Find the highest-converting local businesses for outbound sales 🚀 Traditional lead databases give you thousands of leads that don't convert. SMB Sales Boost finds the prospects other databases miss, with email, phone and fresh buying signals, so you can increase sales by 10-20%.