Connect Business Monster to Claude, ChatGPT, Cursor or any other MCP client. Ask for the businesses you want in plain language and get their phone, website, verified email and social profiles back, with a ready-to-open file.
The setup prompt tells your assistant how to connect itself. Paste it into the chat and follow the sign-in window it opens.
Install the Business Monster MCP server in this client so I can find business leads (Google Maps businesses with phone, website, verified email and social profiles) directly from our chat.
Server URL: https://api.businessmonster.co/mcp
Keep the URL exactly as shown.
Identify which client you are in, then follow the matching section:
### Claude
Guide me through the UI: Go to Customize › Connectors. Click + and choose Add custom connector. Name: Business Monster. URL: the one below. Click Add. In a chat click +, hover Connectors and switch it on.
### Claude Desktop
Open Settings › Developer and click Edit Config: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Add the block below exactly as it is. Restart Claude Desktop.
{
"mcpServers": {
"business-monster": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.businessmonster.co/mcp"]
}
}
}
Restart Claude Desktop after saving. Node.js must be installed for the mcp-remote bridge.
### Claude Code
Run in terminal:
claude mcp add business-monster https://api.businessmonster.co/mcp -t http
On first use it opens a browser for sign-in. Check it with claude mcp list, remove it with claude mcp remove business-monster. For an unattended server add --header "Authorization: Bearer bm_live_YOUR_KEY" instead.
### Cursor
Create ~/.cursor/mcp.json for every project, or .cursor/mcp.json inside one. Paste the block below, then reopen Cursor and check Settings › Tools & MCP.
{
"mcpServers": {
"business-monster": {
"url": "https://api.businessmonster.co/mcp"
}
}
}
One-click install (send me this link): cursor://anysphere.cursor-deeplink/mcp/install?name=business-monster&config=eyJuYW1lIjoiYnVzaW5lc3MtbW9uc3RlciIsInVybCI6Imh0dHBzOi8vYXBpLmJ1c2luZXNzbW9uc3Rlci5jby9tY3AifQ%3D%3D
Then ask me to reload MCP (Settings → Tools & MCP → enable Business Monster).
### ChatGPT
Guide me through the UI: Profile icon › Settings › Apps. If there is no Create app button, enable Developer mode in advanced settings. Create app. Name: Business Monster. MCP Server URL: the one below. Authentication: OAuth. In a chat click +, choose Developer mode and pick Business Monster.
### Codex
Run the command, or edit ~/.codex/config.toml by hand. For one project use .codex/config.toml.
Run in terminal:
codex mcp add business-monster --url "https://api.businessmonster.co/mcp"
[mcp_servers.business-monster]
url = "https://api.businessmonster.co/mcp"
Then run: codex mcp login business-monster
### VS Code
Create .vscode/mcp.json in your workspace, or run MCP: Add Server from the command palette.
{
"servers": {
"business-monster": {
"type": "http",
"url": "https://api.businessmonster.co/mcp"
}
}
}
One-click install (send me this link): vscode:mcp/install?%7B%22name%22%3A%22business-monster%22%2C%22url%22%3A%22https%3A%2F%2Fapi.businessmonster.co%2Fmcp%22%7D
VS Code uses servers, not mcpServers. It opens a browser for sign-in.
### Copilot CLI
Run the command, or edit ~/.copilot/mcp-config.json by hand.
Run in terminal:
copilot mcp add --transport http business-monster "https://api.businessmonster.co/mcp"
{
"mcpServers": {
"business-monster": {
"type": "http",
"url": "https://api.businessmonster.co/mcp",
"tools": ["*"]
}
}
}
Copilot CLI does not read .vscode/mcp.json.
### OpenCode
Create ~/.config/opencode/opencode.json, or opencode.json in the project root, which wins.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"business-monster": {
"type": "remote",
"url": "https://api.businessmonster.co/mcp",
"enabled": true
}
}
}
The transport is "remote". OpenCode has no "http" type and rejects it.
### Antigravity
Open the MCP Store from the … menu at the top of the agent panel. Click Manage MCP Servers, then View raw config. Paste the block into ~/.gemini/antigravity/mcp_config.json.
{
"mcpServers": {
"business-monster": {
"serverUrl": "https://api.businessmonster.co/mcp"
}
}
}
Antigravity expects serverUrl, not url.
### Grok
Guide me through the UI: Go to grok.com/connectors. Click New Connector, then Custom. Name: Business Monster. MCP Server URL: the one below.
### Grok Build
Run the command, or edit ~/.grok/config.toml. For one project use .grok/config.toml.
Run in terminal:
grok mcp add --transport http business-monster "https://api.businessmonster.co/mcp"
[mcp_servers.business-monster]
url = "https://api.businessmonster.co/mcp"
Remote servers trigger an OAuth browser flow on first use; check with grok mcp doctor business-monster.
### Kimi Code CLI
Create ~/.kimi-code/mcp.json, or .kimi-code/mcp.json in the project, which overrides it. Paste the block, then run /mcp-config in the Kimi TUI to review it.
{
"mcpServers": {
"business-monster": {
"url": "https://api.businessmonster.co/mcp"
}
}
}
Kimi has no mcp subcommand and infers the transport from the url, so do not add a type field.
### Kiro
Go to Kiro › MCP Servers. Click + Add and paste the block below.
{
"mcpServers": {
"business-monster": {
"url": "https://api.businessmonster.co/mcp"
}
}
}
One-click install (send me this link): kiro://kiro.mcp/add?name=business-monster&config=%7B%22url%22%3A%22https%3A%2F%2Fapi.businessmonster.co%2Fmcp%22%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D
Or use the same JSON shape as Cursor in Kiro's MCP settings.
### Factory Droid
Run the command, or edit ~/.factory/mcp.json by hand. Authenticate from a session with /mcp.
Run in terminal:
droid mcp add business-monster "https://api.businessmonster.co/mcp" --type http
{
"mcpServers": {
"business-monster": {
"type": "http",
"url": "https://api.businessmonster.co/mcp",
"disabled": false
}
}
}
--type defaults to stdio, so it must be passed for a remote server.
### Qoder
Run the command. -s user installs it globally; without it the CLI writes to the current project.
Run in terminal:
qoder mcp add business-monster "https://api.businessmonster.co/mcp" -t http -s user
One-click install (send me this link): qoder://aicoding.aicoding-deeplink/mcp/add?name=business-monster&config=JTdCJTIydXJsJTIyJTNBJTIyaHR0cHMlM0ElMkYlMkZhcGkuYnVzaW5lc3Ntb25zdGVyLmNvJTJGbWNwJTIyJTdE
-s user installs it globally; the CLI otherwise defaults to the current project.
### Z.AI
Open a workspace, then Settings › MCP Servers › New MCP Server. Pick a scope, name it business-monster and change the type from stdio to HTTP. Enter the server URL below, then click Add and make sure it is enabled.
https://api.businessmonster.co/mcp
{
"mcpServers": {
"business-monster": {
"type": "http",
"url": "https://api.businessmonster.co/mcp"
}
}
}
ZCode defaults new servers to stdio, so switch the type to HTTP. On a 401 an "Open authorization" button appears on the server row; ZCode never opens the browser on its own, so tell me to click it.
### n8n
Add an MCP Client node to your workflow. Endpoint: the server URL below. Transport: HTTP Streamable. Authentication: Header Auth, name Authorization, value Bearer bm_live_YOUR_KEY.
https://api.businessmonster.co/mcp
### Other MCP clients
If the client supports remote MCP by URL, use the Server URL above (OAuth on first use).
If it needs a config file, try this generic JSON:
{
"mcpServers": {
"business-monster": {
"url": "https://api.businessmonster.co/mcp"
}
}
}
If it only supports stdio, use this proxy command:
npx -y mcp-remote "https://api.businessmonster.co/mcp"
Steps:
1. Use the section above for this client. If you can write config files or run CLI commands, do that for me; otherwise give clear UI steps and stop after the setup instructions.
2. Start the OAuth sign-in now so I can authorize in the browser — don't wait for the first tool call. I sign in with Google or Facebook and approve once. If OAuth is somehow not supported, point me to https://www.businessmonster.co/dashboard/ to create an API key and tell me where to put it in the config (never ask me to paste a key into this chat).
3. After configuring, ask me to reload or restart the client, then confirm the Business Monster tools are available: search_businesses, get_search, get_search_results, cancel_search, list_searches, get_account, list_available_fields. If you cannot see them, tell me what to check.
4. Tell me my credit balance with get_account, then offer me these three commands as options I can pick (plus a fourth "type my own"). Use the client's native suggestion UI where available, otherwise a plain numbered list:
- "Find 50 dentists in Austin, Texas that have a phone number, and show me their names and numbers."
- "Build me a list of hair salons in Manchester, UK that have an Instagram account."
- "How many credits do I have, and what would 5,000 restaurants in Berlin cost me?"
Notes you should tell me before spending anything:
- Every search spends my credits: 1 credit per business found. Reviews and photos beyond the free first page cost 10 items = 1 credit.
- Nothing is charged for results that are not delivered.
- Ask me to confirm before starting any search larger than about 1,000 businesses.
- There is no file download from the chat; the complete file is in my dashboard at https://www.businessmonster.co/dashboard/.
Docs: https://www.businessmonster.co/api/
https://api.businessmonster.co/mcp
Paste this into your client and it will walk you through signing in. New accounts start with 20 free credits, no card needed. Pick your client below for the exact steps.
Give your client the URL above and nothing else. It opens a browser, you sign in with Google or Facebook as usual, you approve once, and the connection is live. Disconnect any time from the API page in your dashboard.
For servers and scripts that cannot open a sign-in window (n8n, cron jobs, your own backend), send an API key instead: Authorization: Bearer bm_live_YOUR_KEY, or put it in the path as /mcp/k/<key>.
Claude will open a browser window so you can sign in and approve the connection. Nothing to copy but the URL above.
https://api.businessmonster.co/mcp
Claude Desktop runs MCP servers as local processes, so it reaches a remote server through the mcp-remote bridge. Node.js must be installed.
{
"mcpServers": {
"business-monster": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.businessmonster.co/mcp"]
}
}
}
On first use it opens a browser for sign-in. Check it with claude mcp list, remove it with claude mcp remove business-monster. For an unattended server add --header "Authorization: Bearer bm_live_YOUR_KEY" instead.
claude mcp add business-monster https://api.businessmonster.co/mcp -t http
Cursor opens a browser for sign-in the first time you use it.
{
"mcpServers": {
"business-monster": {
"url": "https://api.businessmonster.co/mcp"
}
}
}
Authentication is OAuth: ChatGPT opens a browser so you can sign in and approve. Developer mode needs a Plus, Pro, Business, Enterprise or Education plan.
https://api.businessmonster.co/mcp
In the ChatGPT desktop app: Settings › MCP servers › Add server, choose Streamable HTTP and paste the URL. The CLI, the desktop app and the IDE extension share this file.
codex mcp add business-monster --url "https://api.businessmonster.co/mcp"
[mcp_servers.business-monster] url = "https://api.businessmonster.co/mcp"
VS Code uses servers, not mcpServers. It opens a browser for sign-in.
{
"servers": {
"business-monster": {
"type": "http",
"url": "https://api.businessmonster.co/mcp"
}
}
}
Copilot CLI does not read .vscode/mcp.json. Inspect servers in a session with /mcp.
copilot mcp add --transport http business-monster "https://api.businessmonster.co/mcp"
{
"mcpServers": {
"business-monster": {
"type": "http",
"url": "https://api.businessmonster.co/mcp",
"tools": ["*"]
}
}
}
OpenCode uses type: "remote" rather than http. Check it with opencode mcp list.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"business-monster": {
"type": "remote",
"url": "https://api.businessmonster.co/mcp",
"enabled": true
}
}
}
Antigravity expects serverUrl, not url.
{
"mcpServers": {
"business-monster": {
"serverUrl": "https://api.businessmonster.co/mcp"
}
}
}
On Business and Enterprise plans an admin has to provision the connector before members can add it.
https://api.businessmonster.co/mcp
Inspect with grok mcp list or diagnose with grok mcp doctor business-monster.
grok mcp add --transport http business-monster "https://api.businessmonster.co/mcp"
[mcp_servers.business-monster] url = "https://api.businessmonster.co/mcp"
There is no kimi mcp add command. Transport is inferred from the URL, so no type field is needed.
/mcp-config in the Kimi TUI to review it.{
"mcpServers": {
"business-monster": {
"url": "https://api.businessmonster.co/mcp"
}
}
}
{
"mcpServers": {
"business-monster": {
"url": "https://api.businessmonster.co/mcp"
}
}
}
Do not commit a key into a project-scoped .factory/mcp.json; reference an environment variable instead.
/mcp.droid mcp add business-monster "https://api.businessmonster.co/mcp" --type http
{
"mcpServers": {
"business-monster": {
"type": "http",
"url": "https://api.businessmonster.co/mcp",
"disabled": false
}
}
}
Inspect with qoder mcp list, or reload in a session with /mcp reload.
-s user installs it globally; without it the CLI writes to the current project.qoder mcp add business-monster "https://api.businessmonster.co/mcp" -t http -s user
The second block is for the dialog's Full configuration mode.
https://api.businessmonster.co/mcp
{
"mcpServers": {
"business-monster": {
"type": "http",
"url": "https://api.businessmonster.co/mcp"
}
}
}
Authorization, value Bearer bm_live_YOUR_KEY.https://api.businessmonster.co/mcp
Streamable HTTP, one endpoint, POST only, JSON-RPC 2.0. Protocol versions 2024-11-05 through 2026-07-28 are accepted and the server negotiates whichever you ask for.
{
"mcpServers": {
"business-monster": {
"url": "https://api.businessmonster.co/mcp",
"headers": { "Authorization": "Bearer bm_live_YOUR_KEY" }
}
}
}
If your client only launches local processes, bridge it with mcp-remote. Needs Node.js.
{
"mcpServers": {
"business-monster": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.businessmonster.co/mcp"]
}
}
}
Start a new chat and try one of these. The assistant discovers the tools on its own.
| Tool | What it does |
|---|---|
| search_businesses | Start a Google Maps search for businesses in a place, and return the search object immediately. The search runs in the background; it does NOT return the businesses. |
| get_search | Check status and progress of a search, and optionally wait for it to finish. Returns the search object: status, results_count so far, credits, summary and next_step. - wait_seconds (0-45, default 0) blocks up to that long waiting for the search to reach a final state, so you do not have to poll in a tight loop. |
| get_search_results | Read the businesses found by a search: one compact record each with name, category, address, phone, website, email, rating and social profiles. |
| cancel_search | Cancel a search that has not started collecting yet, and release the credits it reserved. Only works while status is queued. |
| list_searches | List the user's recent searches, newest first, with status, how many businesses each found and how many credits it cost. USAGE: - Use to find the id of an earlier search, or to report spending. USAGE EXAMPLES: - user_input: What did I search for last week? - user_input: Re-download the results of my dentist search. |
| get_account | Show the user's credit balance, the current prices and their limits. credits_available is what can be spent right now; anything reserved by a running search is already subtracted. USAGE: - Use before starting a large search, and whenever the user asks about cost or balance. USAGE EXAMPLES: - user_input: How many credits do I have? - user_input: How much would 5,000 restaurants cost me?. |
| list_available_fields | List the fields a business record can contain, grouped by topic, so you can answer questions like "can you get their Instagram?" without guessing. The compact records from get_search_results carry the common fields; the downloadable file carries all 100+ of them. USAGE: - Use when the user asks what data is available, or whether a particular detail can be collected. USAGE EXAMPLES: - user_input: What information do you get for each business? - user_input: Can you get their opening hours and email?. |
The assistant starts a search from your location and keyword, and tells you the estimated cost.
A few hundred businesses take one to five minutes. The assistant checks the progress for you.
The records appear in the chat, ready to use. The complete file in XLSX, CSV, JSON or XML is in your dashboard.
You stay in control. A connection can only search and read your own results; it cannot buy credits or change your account. Disconnect it, or revoke an API key, from the API page in your dashboard and it stops working immediately.