# Connect BlazeHive to Claude, ChatGPT and Cursor (MCP) | BlazeHive Docs

> Add one URL to Claude, ChatGPT, Claude Code, Cursor or another MCP app, sign in, and manage your BlazeHive content plan, pages and Search Console data from chat.

[Docs](/docs/) / Use from an AI assistant 

#  Use BlazeHive from your AI assistant 

Add one URL to Claude, ChatGPT, Cursor or another MCP app. Sign in to BlazeHive, click Approve, and ask about your websites in plain words.

## MCP server URL

`https://mcp.blazehive.io/mcp` Copy 

Enter it exactly, including `/mcp`. Other addresses fail. 

* No API key, client ID or secret
* You sign in with your BlazeHive account
* Works with your plan and your permissions

**Added BlazeHive with the old api.blazehive.io address?**  The old address `api.blazehive.io/mcp` no longer works. Remove the connector and add it again with the URL above. 

 You need a BlazeHive account with at least one website set up in the app. 

## Connect your app

Pick your app. Every app opens the same BlazeHive approval page.

![](/logos/claude.svg) Claude ![](/logos/openai.svg) ChatGPT ![](/logos/claude.svg)\>\_ Claude Code C Cursor  Other apps 

### Claude (web, Desktop and mobile)

1. Step 1  
### Add a custom connector  
 In your AI app  
In Claude, open **Settings → Connectors → Add custom connector**.
2. Step 2  
### Paste the URL  
`https://mcp.blazehive.io/mcp` Copy  
Leave the client ID and secret empty.
3. Step 3  
### Approve  
 In BlazeHive  
Claude opens BlazeHive. Check that the page says "Sends you back to Claude (claude.ai)", then click **Approve**.
4. Step 4  
### Check it works  
Ask "Which websites do I have in BlazeHive, and what's the status of each?" The BlazeHive dashboard shows inside the chat.

### ChatGPT

 BlazeHive is not in the ChatGPT app directory yet. Until it is, add it in developer mode. 

1. Step 1  
### Turn on developer mode  
 In your AI app  
In ChatGPT settings, turn on **Developer mode**.
2. Step 2  
### Add BlazeHive  
Go to [chatgpt.com/plugins](https://chatgpt.com/plugins), select **+**, paste the URL, name it BlazeHive and create it.  
`https://mcp.blazehive.io/mcp` Copy
3. Step 3  
### Sign in and approve  
 In BlazeHive  
Sign in to BlazeHive in the window ChatGPT opens, then click **Approve**. The page says "Sends you back to ChatGPT (chatgpt.com)".
4. Step 4  
### Use it in a chat  
In a new chat, add BlazeHive from **\+ → More**.

If BlazeHive's tools change, open the connection at chatgpt.com/plugins and select **Refresh**.

To check it works, ask "Which websites do I have in BlazeHive, and what's the status of each?"

### Claude Code

Run this in your terminal:

Terminal Copy 

```
claude mcp add --transport http blazehive https://mcp.blazehive.io/mcp
```

Then, inside Claude Code, run `/mcp` and authenticate BlazeHive. The approval page says "An app on this computer (localhost:PORT)". Click **Approve**. 

To check it works, ask "Which websites do I have in BlazeHive, and what's the status of each?"

### Cursor

Add this to `~/.cursor/mcp.json`:

\~/.cursor/mcp.json Copy 

```
{
  "mcpServers": {
    "blazehive": {
      "url": "https://mcp.blazehive.io/mcp"
    }
  }
}
```

When Cursor opens the BlazeHive approval page, click **Approve**. The page says "The Cursor app on this computer" or "An app on this computer". 

To check it works, ask "Which websites do I have in BlazeHive, and what's the status of each?"

### Other apps

These apps also work with BlazeHive: VS Code (GitHub Copilot), OpenAI Codex CLI, Gemini CLI, Zed and Goose. Add BlazeHive as a remote MCP server over HTTP with this URL. Leave any client ID and secret empty, then click **Approve** when the BlazeHive page opens. 

`https://mcp.blazehive.io/mcp` Copy 

**Not supported yet.**  Windsurf, Mistral Le Chat and Perplexity can't connect yet. For them the approval page shows only **Deny**. 

To check it works, ask "Which websites do I have in BlazeHive, and what's the status of each?"

## The approval screen

Every app sends you to the same page on app.blazehive.io.

1. Step 1  
### Sign in if asked  
Password, Google and magic-link sign-in all bring you back to the approval page.
2. Step 2  
### Check the page  
The page is titled "Connect _your app_ to BlazeHive". Check that **Signed in as** shows your BlazeHive email and **Sends you back to** names the app you came from.
3. Step 3  
### Click Approve  
Click **Approve**. The page shows "Returning you to the app…" and sends you back. Click **Deny** if you didn't start the request.
* Approving lets the app read and change data in every project you have access to, with your permissions.
* The app stays connected. It refreshes its sign-in on its own.
* Note the **Client ID**. Support needs it if you ask them to revoke the app.
* If only **Deny** shows, the app isn't supported.

## Example prompts

Once BlazeHive is connected, ask in plain words. For ideas you can copy, see the example prompts for content plans, keywords, pages, Search Console data, reports and outreach.

[See example prompts ](/docs/mcp/examples/) 

## What it can do

Each tool is marked Read Changes data Uses quota 

### Account and workspaces

List your websites, workspaces and team members. Change email notifications, brand name and color.

Team list: owners only 

Tools (5) 
* `list_projects` Read
* `list_workspaces` Read
* `list_team_members` Read owner only
* `get_account_settings` Read
* `update_account_settings` Changes data

### Project and SEO agent

Check status, and start, pause or resume BlazeHive on a website.

Start needs a paid plan 

Tools (6) 
* `get_project` Read
* `get_pipeline_status` Read
* `start_project` Uses quota
* `pause_project` Changes data
* `resume_project` Changes data
* `update_project_brand` Changes data

### Content plan and rules

See the content plan, add a keyword as a page, move or unschedule pages, and set standing rules.

One traffic page per day, plus at most one FAQOnly queued pages can change 

Tools (6) 
* `get_plan` Read
* `commit_proposal` Uses quota
* `remove_planned_pages` Changes data
* `list_instructions` Read
* `add_instruction` Changes data
* `remove_instruction` Changes data

### Keyword research

Live keyword ideas, and your competitor list (up to 10 domains).

10 searches per website per day 

Tools (3) 
* `research_keywords` Uses quota
* `list_competitors` Read
* `replace_competitors` Changes data

### Pages and publishing

Read and edit pages, publish live or as a draft, unpublish, retry failed pages and set the publish mode.

Retry: Growth or Pro 

Tools (7) 
* `list_pages` Read
* `get_page` Read
* `update_page_content` Changes data
* `publish_page` Changes data
* `unpublish_page` Changes data
* `retry_page` Uses quota
* `set_publish_mode` Changes data

### Landing base

Edit, regenerate and apply the reusable sections of your landing pages.

Regenerate: Growth or Pro 

Tools (4) 
* `get_landing_base` Read
* `update_landing_base` Changes data
* `regenerate_landing_base` Uses quota
* `apply_landing_base` Changes data

### CMS connections

List your CMS connections and run a live test that publishes nothing. Credentials are never shown.

Create or edit connections in the app 

Tools (4) 
* `list_integrations` Read
* `get_integration` Read
* `test_integration` Changes data
* `set_project_integration` Changes data

### Site Health

Read the latest audit and its history, or run a new crawl.

8 crawls per site per month 

Tools (3) 
* `get_site_audit` Read
* `get_site_audit_history` Read
* `run_site_audit` Uses quota

### Google Search Console

Link a property and query clicks, impressions and positions.

Data lags about 3 daysUp to 180 daysConnect Google in the app 

Tools (4) 
* `get_gsc_status` Read
* `list_gsc_properties` Read
* `link_gsc_property` Changes data
* `query_gsc` Read needs an edit seat

### Visibility and growth reports

Read your AI Search Visibility score, and create and share 28 or 90-day growth reports.

4 reports per website per monthNeeds Search Console linked 

Tools (6) 
* `get_visibility_score` Read
* `list_growth_reports` Read
* `get_growth_report` Read
* `create_growth_report` Uses quota
* `share_growth_report` Changes data
* `unshare_growth_report` Changes data

### AI Visibility

Read your AI Visibility report: which AIs name you when buyers ask, and who they pick instead. Change the competitors it compares you with.

Essential and upNew reports come more often on Growth and Pro 

Tools (4) 
* `list_ai_visibility_reports` Read
* `get_ai_visibility_report` Read
* `set_ai_visibility_competitors` Changes data from the next report
* `start_ai_visibility_check` Changes data first check only

### Backlink outreach

Find prospects, preview and send emails, and read and answer replies.

ProDiscovery once per 24 hours 

Tools (11) 
* `get_outreach_state` Read
* `list_prospects` Read
* `list_inbox` Read
* `start_discovery` Uses quota
* `preview_prospect_email` Uses quota
* `send_prospect_email` Uses quota
* `queue_all_prospects` Uses quota
* `reply_to_thread` Uses quota
* `update_prospect` Changes data
* `mark_thread_read` Changes data
* `update_outreach_settings` Uses quota

The groups above hold 63 tools. Two more open the BlazeHive dashboard and page drafts inside apps that support them, such as Claude. Owners and editors can make changes. Client seats are view-only. 

## Done in the BlazeHive app

These are not available over MCP. Do them in BlazeHive.

* Billing, plan changes and buying credits [ Billing ](https://app.blazehive.io/billing)
* Adding websites
* Creating, editing or deleting CMS connections [ Integrations ](https://app.blazehive.io/integrations)
* Connecting or disconnecting Google Search Console [ Integrations ](https://app.blazehive.io/integrations)
* Team invites and role changes [ Team ](https://app.blazehive.io/team)
* Audits of other URLs, deleting reports, deleting your account, file downloads

## Plans and limits

### Plans

* MCP is on every plan, including Free.
* The AI Visibility report starts at Essential.
* Starting BlazeHive on a website, keyword research and changing the content plan need a paid plan.
* Retrying pages and regenerating the landing base need Growth or Pro.
* Sending outreach, previewing emails, discovery and replies need Pro. Without it, `list_prospects` shows a 13-prospect sample with contacts hidden.
* When your plan doesn't include an action, the reply says the action isn't included in the workspace's current BlazeHive plan. Change your plan in the app.

[ Billing ](https://app.blazehive.io/billing) 

### Quotas

| Action             | Limit                         |
| ------------------ | ----------------------------- |
| Keyword research   | 10 per website per day        |
| Growth reports     | 4 per website per month       |
| Site Health crawls | 8 per site per month          |
| Prospect discovery | Once per 24 hours per website |

### Rate limits per minute

Each limit counts requests per user per minute, except Per network, which counts every request from one IP address.

| Tier         | Limit | What counts                                       |
| ------------ | ----- | ------------------------------------------------- |
| All requests | 120   | Every request                                     |
| Reads        | 90    | Tool calls that don't change or spend anything    |
| Writes       | 30    | Tool calls that change or spend something         |
| Paid actions | 10    | Tool calls that spend. These also count as writes |
| Per network  | 1,200 | Every request from one IP address                 |

Messages you may see 
* `Too many requests for this account. Wait a minute before calling more tools.`
* `Too many lookups for this account in the last minute. Wait a minute before trying again.`
* `Too many paid actions for this account in the last minute. Wait a minute before trying again.`
* `Too many changes or paid actions for this account in the last minute. Wait a minute before trying again.`
* `Too many requests from this network. Try again shortly.`

## Troubleshooting

| Problem                                                                          | What to do                                                                                                                                                 |
| -------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Your connector uses api.blazehive.io/mcp                                         | That address now answers 404\. Remove the connector and add it again with https://mcp.blazehive.io/mcp.                                                    |
| The browser shows an invalid\_target error                                       | The URL is not exact. Use https://mcp.blazehive.io/mcp, including /mcp.                                                                                    |
| "This request has expired"                                                       | Requests last 10 minutes and work once. Start the connection again from your AI app.                                                                       |
| "No connection request found"                                                    | Start the connection again from your AI app.                                                                                                               |
| You landed on the BlazeHive dashboard after signing in, not on the approval page | The return path expires after 15 minutes, and is lost when the browser blocks session storage (for example in private mode). Start again from your AI app. |
| You signed in to the wrong account                                               | Click "Not you? Sign out", sign in with the right account, then start again from your AI app.                                                              |
| The approval page shows only Deny                                                | The app isn't supported yet, for example Windsurf, Mistral Le Chat or Perplexity.                                                                          |
| It keeps asking you to reconnect, or shows invalid\_client                       | Remove the connector and add it again.                                                                                                                     |
| "Redirect blocked"                                                               | The app is sending you to an address BlazeHive doesn't connect to.                                                                                         |
| gsc\_not\_connected                                                              | Connect Google on the Integrations page in BlazeHive.                                                                                                      |
| A tool says you can't change something                                           | You are on a client seat, which is view-only.                                                                                                              |
| Search Console numbers look a few days behind                                    | Search Console data lags about 3 days.                                                                                                                     |

## Disconnect

Remove BlazeHive from your AI app's connector or MCP settings.

The BlazeHive web app has no connected-apps screen. To have BlazeHive revoke an app completely, email support with the Client ID from the approval screen. 

Support email

`support@blazehive.io` Copy 

Email text

`Please revoke BlazeHive MCP access for Client ID: <client id>` Copy 

Docs menu · MCP setup guide 

On this page

* [Server URL](#url)
* [Connect your app](#connect)
* [The approval screen](#approve)
* [Example prompts](#prompts)
* [What it can do](#tools)
* [Done in the app](#app-only)
* [Plans and limits](#limits)
* [Troubleshooting](#troubleshooting)
* [Disconnect](#disconnect)

* [  Overview ](/docs/)

1 Publish to your website Pick your platform 

* [ ![](/logos/integrations/wordpress.svg) WordPress ](/docs/wordpress/)
* [ ![](/logos/integrations/replit.svg) Replit ](/docs/replit/)
* [ ![](/logos/integrations/lovable.svg) Lovable ](/docs/lovable/)
* [ ![](/logos/integrations/webhook.svg) Any other site (webhook) ](/docs/webhooks/)

2 Use from an AI assistant Optional, over MCP 

* [ MCP setup guide ](/docs/mcp/)
* [ Example prompts ](/docs/mcp/examples/)
* [ ![](/logos/claude.svg) Claude ](/docs/mcp/#claude)
* [ ![](/logos/openai.svg) ChatGPT ](/docs/mcp/#chatgpt)
* [ ![](/logos/claude.svg)\>\_ Claude Code ](/docs/mcp/#claude-code)
* [ C Cursor ](/docs/mcp/#cursor)
* [ Other MCP apps ](/docs/mcp/#other)

Reference

* [ Webhook payload ](/docs/webhooks/#payload)
* [ Verifying signatures ](/docs/webhooks/#signature)
* [ Delivery and retries ](/docs/webhooks/#delivery)
* [ MCP tools ](/docs/mcp/#tools)
* [ MCP plans and limits ](/docs/mcp/#limits)

On this page

* [Server URL](#url)
* [Connect your app](#connect)
* [The approval screen](#approve)
* [Example prompts](#prompts)
* [What it can do](#tools)
* [Done in the app](#app-only)
* [Plans and limits](#limits)
* [Troubleshooting](#troubleshooting)
* [Disconnect](#disconnect)

* [  Overview ](/docs/)

1 Publish to your website Pick your platform 

* [ ![](/logos/integrations/wordpress.svg) WordPress ](/docs/wordpress/)
* [ ![](/logos/integrations/replit.svg) Replit ](/docs/replit/)
* [ ![](/logos/integrations/lovable.svg) Lovable ](/docs/lovable/)
* [ ![](/logos/integrations/webhook.svg) Any other site (webhook) ](/docs/webhooks/)

2 Use from an AI assistant Optional, over MCP 

* [ MCP setup guide ](/docs/mcp/)
* [ Example prompts ](/docs/mcp/examples/)
* [ ![](/logos/claude.svg) Claude ](/docs/mcp/#claude)
* [ ![](/logos/openai.svg) ChatGPT ](/docs/mcp/#chatgpt)
* [ ![](/logos/claude.svg)\>\_ Claude Code ](/docs/mcp/#claude-code)
* [ C Cursor ](/docs/mcp/#cursor)
* [ Other MCP apps ](/docs/mcp/#other)

Reference

* [ Webhook payload ](/docs/webhooks/#payload)
* [ Verifying signatures ](/docs/webhooks/#signature)
* [ Delivery and retries ](/docs/webhooks/#delivery)
* [ MCP tools ](/docs/mcp/#tools)
* [ MCP plans and limits ](/docs/mcp/#limits)

On this page

* [Server URL](#url)
* [Connect your app](#connect)
* [The approval screen](#approve)
* [Example prompts](#prompts)
* [What it can do](#tools)
* [Done in the app](#app-only)
* [Plans and limits](#limits)
* [Troubleshooting](#troubleshooting)
* [Disconnect](#disconnect)

[ Open BlazeHive ](https://app.blazehive.io/) 

Questions? Email [support@blazehive.io](mailto:support@blazehive.io)
