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
Endpoint
Transport is streamable-http. Point your client at this URL:
https://mcp.botify.com
Authentication
OAuth 2.1, handled entirely by the client: it reads the endpoint's protected-resource metadata (RFC 9728), registers itself with Botify (RFC 7591) and runs an authorization-code flow with PKCE. You sign in and approve once in the browser; the client refreshes its own access token from then on.
Cursor
Add the server to ~/.cursor/mcp.json (or .cursor/mcp.json in a
project), then reload the window and approve the connection in the browser window Cursor
opens.
{
"mcpServers": {
"botify-agents": {
"url": "https://mcp.botify.com"
}
}
}
Claude
In Claude Desktop and on claude.ai, go to Settings → Connectors → Add custom connector and paste the endpoint.
In Claude Code, add the server from the terminal, then run /mcp in the
session and pick it to sign in.
claude mcp add --transport http botify-agents https://mcp.botify.com
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 connect — it runs the same browser sign-in.
Tools available over MCP
52 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 - AI Decisions Gateway
ai_decisions_gateway - AI Responses Gateway
ai_gateway - AI Visibility Campaigns List
ai_visibility_campaigns_list - 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 - Get or create a PageWorkers optimization
pageworkers_get_or_create_optimization - Push items to a PageWorkers optimization
pageworkers_push_items_to_optimization - Perplexity
perplexity - Project Memory
project_metadata - Robots.txt Check
robots_txt_check - Search Console Keywords Groups
search_console_keywords_groups - SearchGPT
searchgpt - Site Crawler URL Detail
site_crawler_url_detail - Sitemaps Detection
sitemaps_detection - Speedworkers Config
speedworkers_config - Speedworkers Inventory
speedworkers_inventory - SpeedWorkers Page History
speedworkers_page_history - SpeedWorkers Page Preview
speedworkers_page_preview - SpeedWorkers Page Snapshot
speedworkers_page_snapshot - Speedworkers Versions
speedworkers_versions - Tables Create
tables_create - Tables Insert
tables_insert - Tables List
tables_list - Tables Load
tables_load - Tables Query
tables_query - Tables Query Export
tables_query_export - Tables Schema
tables_schema - Temporary Storage Grep
tmp_storage_grep - Temporary Storage jq
tmp_storage_jq - Temporary Storage Read
tmp_storage_read - Tool Documentation
tool_documentation - Keywords performance for URL (From Google Search Console)
url_keywords