Connect your AI assistant

Use MapBulk tools from a client that supports remote MCP.

MCP connection

{
  "mcpServers": {
    "mapbulk": {
      "url": "https://api.mapbulk.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Add the connection

On Scale or Max, use the MCP HTTP endpoint with your API key. Clients have different configuration formats; check your client’s remote MCP setup instructions.

Ask for a search

Example: find roofing contractors in Orlando and include email enrichment. Review the requested location, result count and credit ceiling before running.

Return for the results

A new client session can inspect the same search. The dashboard shows the same account state and leads.

Use all eleven tools

list_business_categories, search_businesses, get_search_job, get_search_results, list_leads, get_search_issues, cancel_search, retry_search, get_usage, enrich_businesses, export_results.

Keep the same results across your tools.Open API, MCP & CLI

Next guideHow credits work