Integrations

How to Use the MCP Server

By SMB Sales Boost Team.

✓ 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%.

Claim Up to $250 in Free Credits

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.

  1. Get your API key - Open Dashboard > API and create or copy your API key
  2. Open Claude Desktop settings - Go to Settings > Developer > Edit Config
  3. 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"
      }
    }
  }
}
  1. Restart Claude Desktop to load the new server
  2. 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

Long-Running Requests

Enrichment

Filter Presets and Keywords

Email Schedules

Export Formats

Export History

Export Blacklist

Credits and Billing

AI Features

Integrations

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

Purchasing (No Authentication Required)

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

Requirements


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%.

Claim Up to $250 in Free Credits


Related Articles