Connect
Set up MCP
The agents are exposed as MCP tools over streamable HTTP. Any MCP client — Cursor, Claude, the MCP Inspector — can list them, read their schemas and call them on your behalf.
Quick install
On Claude, ChatGPT, Perplexity, Gemini, or your preferred answer engine, ask:
Please install the Botify MCP from https://mcp.botify.com/mcp
Endpoint
Transport is streamable-http. Use the exact URL below, with no trailing slash.
https://mcp.botify.com
Authentication
Send your Botify API token as a bearer token. OAuth is enabled on this instance: clients that support it can discover the authorization server through the protected-resource metadata and obtain an access token, which is used the same way.
Authorization: Bearer <YOUR_BOTIFY_API_TOKEN>
Cursor
Add the server to ~/.cursor/mcp.json (or .cursor/mcp.json in a
project), then reload the window.
{
"mcpServers": {
"botify-agents": {
"url": "https://mcp.botify.com",
"headers": {
"Authorization": "Bearer <YOUR_BOTIFY_API_TOKEN>"
}
}
}
}
Claude Desktop
Claude Desktop speaks stdio, so bridge it with mcp-remote in
claude_desktop_config.json.
{
"mcpServers": {
"botify-agents": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.botify.com",
"--header",
"Authorization: Bearer <YOUR_BOTIFY_API_TOKEN>"
]
}
}
}
Try it with the MCP Inspector
The official inspector is the quickest way to check the connection and browse the tools.
npx @modelcontextprotocol/inspector
In the inspector, choose the Streamable HTTP transport, paste
https://mcp.botify.com and set the Authorization header.
Tools available over MCP
31 tools are published to MCP. Each one
takes an organization, a project, an item and an
optional config. The list_projects tool is MCP-only and helps the
model resolve the first two.
- Action Board
action_board - Agentic Catalog Sources
agentic_catalog_sources - Batch Run
batch_run - Botify Config
botify_config - Calculator
calculator - Credit Consumption
get_credit_usage - Google Ads Keyword Suggestions
google_ads_keyword_suggestions - Google AI Mode
google_ai_mode - Google Knowledge Graph
google_knowledge_graph - Google People Also Ask
google_people_also_ask - Google SERP
google_serp - Google Trends
google_trends - Google URL Inspection
google_url_inspection - HTML Executor
html_code_executor - HTML Fetch
html_fetch - HTML Grep
html_grep - HTML PageWorkers Preview
html_pageworkers_preview - HTML Structured Data
html_structured_data - Knowledge
knowledge - List Annotations
list_annotations - Organic Keyword Suggestions
organic_keyword_suggestions - PageWorkers Generic URLs Actions
pageworkers_generic_urls_actions - Perplexity
perplexity - Project Memory
project_metadata - SearchGPT
searchgpt - URL Details from Botify SiteCrawler
site_crawler_url_details - Tables Insert
tables_insert - Tables Load
tables_load - Tables Query
tables_query - Tables Schema
tables_schema - Keywords performance for URL (From Google Search Console)
url_keywords