MCP Server

Use your Brandop AI workspace from Claude, ChatGPT, Cursor, VS Code, Claude Code and Antigravity.

Last updated October 9, 2026

What the MCP server does

The Brandop AI MCP server connects one workspace to an MCP client. MCP is the Model Context Protocol.

From the chat, the client reads site health scores, AI visibility results, pages, schema, tasks, traffic and Content Studio articles. It also starts scans, generates schema, manages questions, question tags and competitors, and creates tasks and articles.

AI visibility is the share of AI answers to your tracked questions that name your brand or cite your site. Each scan measures it and compares it with the previous scan.

Server URL

Use this URL in every client. Sign-in uses OAuth. When you allow access, you choose one workspace.

https://test.brandop.ai/api/mcp

Connect a client

Brandop AI tests these clients. Other clients that follow the MCP standard can also work. We do not test them.

Claude

Open Customize, then Connectors.
Select Add, then Add custom connector.
Enter a name and paste the MCP server URL. Complete the steps and select Add.
Select Connect. Sign in to Brandop AI and choose a workspace.

On Team and Enterprise plans, an owner adds the connector in Organization settings, then Connectors. Members then select Connect.

ChatGPT

Open Plugins in ChatGPT.
Select the plus button, then Add custom MCP server.
Enter a name and paste the MCP server URL. Set the authentication to OAuth.
Read the risk warning. Select I understand and want to continue, then Create as a plugin.
Sign in to Brandop AI and choose a workspace.

Your ChatGPT account and workspace policies control custom MCP servers. ChatGPT asks you to confirm each action that makes a change.

Cursor

1
Add this server to .cursor/mcp.json in your project. For all projects, use ~/.cursor/mcp.json.
.cursor/mcp.json
```
{
  "mcpServers": {
    "brandop": {
      "url": "https://test.brandop.ai/api/mcp"
    }
  }
}
```
When Cursor asks you to sign in, sign in to Brandop AI and choose a workspace.

VS Code

Add this server to .vscode/mcp.json in your workspace folder.

.vscode/mcp.json

{
  "servers": {
    "brandop": {
      "type": "http",
      "url": "https://test.brandop.ai/api/mcp"
    }
  }
}

Start the server. When VS Code asks you to sign in, sign in to Brandop AI and choose a workspace.
Use the Brandop AI tools in GitHub Copilot Chat.

Claude Code

Run this command in your terminal.

Terminal

claude mcp add --transport http brandop https://test.brandop.ai/api/mcp

In Claude Code, run /mcp. Sign in to Brandop AI in your browser and choose a workspace.

Antigravity

In Antigravity, open Customizations from the left menu. At the top right, select Installed.
2
In the MCP Servers section, select Copy Config File Path to copy the path of the configuration file. Open the file and add this server.
mcp_config.json
```
{
  "mcpServers": {
    "brandop": {
      "serverUrl": "https://test.brandop.ai/api/mcp"
    }
  }
}
```
Save the file. In the MCP Servers list, select Authenticate next to the Brandop AI server.
Sign in to Brandop AI in your browser and choose a workspace. Copy the code that appears, paste it into Antigravity and select Submit.

Permissions and approvals

The client acts with the role of the member who made the connection. The tool list shows the roles for each tool.
Actions that use quota or change the live site first show a preview with the cost. They run only after you approve them in the chat.
In your MCP client, you can set each tool to always allow, ask first or block.
Each connection uses one workspace. To use another workspace, connect again and choose it.
Your connections are in Settings, then MCP connections. Owners and admins can disconnect any connection. Members can disconnect their own connections.

Tools

The server has 41 tools. Read tools only read data. Write tools change data.

Read tools (19)

Tool	What it does	Roles
`get_workspace_overview` Get workspace overview	Gets the site, plan, your role, usage, limits and running jobs.	All roles
`get_site_health` Get site health	Gets the site scores, the score trend and the task totals.	All roles
`list_pages` List pages	Lists the pages with schema status and scores.	All roles
`get_page_details` Get page details	Gets the scores, issues, Search Console data and open tasks of one page.	All roles
`get_page_schema` Get page schema	Gets the active JSON-LD of one page and lists its earlier versions.	All roles
`list_tasks` List tasks	Lists the improvement tasks with filters and totals.	All roles
`list_members` List workspace members	Lists the workspace members and their roles.	All roles
`get_ai_visibility_report` Get AI visibility report	Gets the AI visibility score, the results per AI provider, the trend and the competitor comparison.	All roles
`list_ai_visibility_scans` List AI visibility scans	Lists the AI visibility scans with summary results.	All roles
`list_ai_visibility_questions` List AI visibility questions	Lists the tracked questions with the results per AI provider.	All roles
`get_ai_visibility_answers` Get AI visibility answers	Gets the stored AI answers of one scan.	All roles
`get_ai_visibility_question_history` Get AI visibility question history	Gets the results of one tracked question in each scan.	All roles
`list_competitors` List competitors	Lists the competitors and how often AI answers show them.	All roles
`list_cited_sources` List cited sources	Lists the third-party pages that AI answers cite.	All roles
`get_traffic_analytics` Get traffic analytics	Gets the schema delivery counts and AI bot visits for a date range.	All roles
`list_content_documents` List Content Studio articles	Lists the Content Studio articles with status and content score.	All roles
`get_content_document` Get Content Studio article	Gets one Content Studio article with its meta data and content score.	All roles
`list_activity` List workspace activity	Lists the workspace activity log.	Owner, Admin
`get_job_status` Get job status	Gets the status and progress of one long-running job.	All roles

Write tools (22)

Tools marked Yes show a preview with the cost first. They run after you approve them in the chat.

Tool	What it does	Roles	Approval
`start_site_crawl` Start site crawl	Crawls the site to find its pages. Uses crawl quota.	All roles	Yes
`generate_page_schemas` Generate page schemas	Generates schema for the given pages and serves it on the live site. Uses crawl quota.	All roles	Yes
`stop_page_schemas` Stop page schemas	Stops serving schema for the given pages.	All roles	Yes
`set_custom_page_schema` Set manually edited page schema	Saves a manually edited schema for one page and serves it.	All roles	Yes
`restore_page_schema` Restore page schema	Removes the manually edited schema of a page, or makes an earlier version current.	All roles	Yes
`start_site_health_scan` Start site health scan	Scans pages for PageSpeed, SEO, GEO and SERP scores.	Owner, Admin	Yes
`start_ai_visibility_scan` Start AI visibility scan	Asks the tracked questions to the AI providers. Uses your AI answer allowance.	All roles	Yes
`add_ai_visibility_question` Add AI visibility question	Adds one question to AI visibility tracking.	Owner, Admin	No
`update_ai_visibility_question` Update AI visibility question	Changes the text of one tracked question.	Owner, Admin	No
`review_ai_visibility_questions` Review AI visibility questions	Approves or rejects tracked questions.	Owner, Admin	No
`create_question_tag` Create question tag	Creates a tag to group AI visibility questions.	All roles	No
`rename_question_tag` Rename question tag	Changes the name of a question tag.	All roles	No
`delete_question_tag` Delete question tag	Deletes a tag and removes it from all questions.	All roles	No
`set_question_tags` Set question tags	Adds, removes or replaces the tags of questions.	All roles	No
`add_competitor` Add competitor	Adds a competitor to track in AI answers.	Owner, Admin	No
`update_competitor` Update competitor	Changes the name, domain, keywords or tracking of a competitor.	Owner, Admin	No
`remove_competitor` Remove competitor	Stops tracking a competitor and keeps its data.	Owner, Admin	No
`create_task` Create task	Adds a manual task to the task list.	All roles	No
`update_task` Update task	Changes the status, priority or assignees of one task.	All roles	No
`suggest_content_topics` Suggest content topics	Suggests article topics for the site. Uses Content Studio tokens.	All roles	Yes
`create_content` Create content	Starts writing one Content Studio article. Uses Content Studio tokens.	All roles	Yes
`create_support_ticket` Create support ticket	Opens a request to the Brandop AI support team.	All roles	No

Limits

MCP access is a plan feature. The plan of the workspace decides if you can connect.
MCP requests use the per-minute request limit of the workspace API. MCP has its own counter.
A tool result has at most 20,000 characters. Long lists come in pages. Use the cursor in the result to get the next page.
Tools work only while the workspace has access. They stop when the plan expires or the payment grace period ends.