MCP Integration - Searchable Docs

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI coding assistants to connect to external tools and data sources. Searchable’s MCP server lets you access your AEO/SEO data, visibility reports, and content directly from AI assistants like:

Cursor - AI-powered code editor
Claude Code - Anthropic’s CLI tool
Windsurf - AI development environment
Any MCP-compatible client

With the Searchable MCP, you can ask your AI assistant questions like “What’s my brand’s visibility score?” or “Show me critical AEO/SEO issues on my site” without leaving your development environment.

Plan Requirement: MCP integration requires a paid Searchable plan (Starter, Professional, or Scale). API keys cannot be created on the Free plan.

Setup Guide

Step 1: Get Your API Key

Open Settings

Navigate to Settings, then under Workspace go to Integrations in your Searchable dashboard.

Create API Key

Click Create API Key and give it a descriptive name (e.g., “Cursor MCP”).

Copy the Key

Copy your API key (starts with sea_). Store it securely - you won’t be able to see it again.

Keep your API key secret. Never commit it to version control or share it publicly.

Step 2: Configure Your AI Assistant

Cursor
Claude Code
Windsurf

Add the following to your Cursor MCP configuration file (.cursor/mcp.json in your project or global config):

{
  "mcpServers": {
    "searchable": {
      "url": "https://searchable-mcp-production.searchable.workers.dev/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your Searchable API key.

Run the following command to add the Searchable MCP server:

claude mcp add searchable \
  --transport sse \
  --url "https://searchable-mcp-production.searchable.workers.dev/sse" \
  --header "Authorization: Bearer YOUR_API_KEY"

Or add to your Claude Code config (~/.claude/claude_code_config.json):

{
  "mcpServers": {
    "searchable": {
      "url": "https://searchable-mcp-production.searchable.workers.dev/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "searchable": {
      "url": "https://searchable-mcp-production.searchable.workers.dev/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Step 3: Verify Connection

After configuration, restart your AI assistant. You should see “Searchable” appear in your available MCP servers. Test the connection by asking:

List my Searchable projects

You should see a list of your projects with their names and domains.

Available Tools

The Searchable MCP provides 9 tools for accessing your project data:

Project Management

list_projects

Description: List all Searchable projects for the authenticated user.Returns: Project names, domains, descriptions, and IDs.Example prompt: “List all my Searchable projects”

AI Visibility

get_visibility_summary

Description: Get AI visibility summary for a project.Returns: Overall visibility score, mention rate, citations, and how the brand appears across AI platforms (ChatGPT, Claude, Perplexity, Gemini).Parameters:

projectId (required) - Project ID
days (optional) - Analysis period (default: 30)

get_visibility_details

Description: Get detailed visibility breakdown by platform.Returns: Per-platform visibility rates, responses, mentions, and citations for ChatGPT, Claude, Perplexity, and Gemini.Parameters:

projectId (required) - Project ID
days (optional) - Analysis period (default: 30)

Site Audits

get_website_issues

Description: Get current website issues from Searchable’s site auditor.Returns: Issues grouped by severity (critical, high, medium, low) with descriptions and affected pages.Parameters:

projectId (required) - Project ID
status (optional) - “open”, “resolved”, or “all” (default: “open”)

get_page_audits

Description: Get page audit scores for a project.Returns: Technical, content, and AEO (AI Engine Optimization) scores for each monitored page.Parameters:

projectId (required) - Project ID

get_monitored_pages

Description: Get list of all monitored pages for a project.Returns: Page URLs, types, issue counts, and tracking status.Parameters:

projectId (required) - Project ID

get_issue_details

Description: Get detailed information about issues of a specific type.Returns: Unique issue types, affected pages, and fix recommendations.Parameters:

projectId (required) - Project ID
issueType (required) - “technical” or “content”

Content & Articles

list_articles

Description: List articles for a project.Returns: Article titles, status, topics, keywords, and metadata.Parameters:

projectId (required) - Project ID
status (optional) - “draft”, “published”, or “all” (default: “all”)
limit (optional) - Max articles (default: 50, max: 100)

get_article

Description: Get a single article with full content.Returns: Complete article including HTML/markdown content, outline, FAQs, AEO/SEO metadata, and all details.Parameters:

articleId (required) - Article ID

Example Prompts

Once connected, try these prompts with your AI assistant:

Visibility Analysis

What's the AI visibility score for my project?

How does my brand appear across different AI platforms?

Show me the visibility breakdown for ChatGPT vs Claude

Site Audit

What critical AEO/SEO issues does my site have?

Show me the page audit scores for my website

What technical issues should I fix first?

Content Management

List all my draft articles

Get the full content of my latest article

How many articles have I published this month?

Use Cases

Automated Issue Fixing

One of the most powerful use cases is retrieving AEO/SEO issues and having your AI assistant automatically fix them in your codebase:

Get all critical issues for my site and fix them in my codebase

Your AI assistant will:

Fetch issues from Searchable (missing meta descriptions, alt text, heading structure, etc.)
Locate the relevant files in your project
Apply the fixes automatically
Show you what changed for review

This turns hours of manual AEO/SEO work into a single prompt.

For Developers

Query AEO/SEO issues while debugging frontend code
Have your AI assistant automatically fix issues in your codebase
Check if code changes impact page audit scores
Review article content without leaving your IDE

For AEO/SEO Teams

Get quick visibility summaries during standups
Pull audit data for reports
Monitor issue resolution progress

For Content Teams

Review article status and metadata
Access full article content for editing
Track content performance metrics

Troubleshooting

Connection failed

Verify your API key is correct and starts with sea_
Check that the URL is exactly https://searchable-mcp-production.searchable.workers.dev/sse
Ensure your API key hasn’t been revoked
Restart your AI assistant after configuration changes

No projects returned

Confirm you have projects in your Searchable account
Check that the API key belongs to the correct workspace
Verify workspace membership allows project access

Tools not appearing

Restart your AI assistant completely
Check the MCP server configuration syntax
Look for error messages in your assistant’s logs
Verify the transport type is set to “sse”

Authentication errors

Regenerate your API key in Searchable settings
Ensure the Authorization header includes “Bearer ” prefix
Check for extra spaces or characters in the key

Security

API Key Best Practices

Rotate keys regularly - Generate new keys periodically
Use project-specific keys - Create separate keys for different use cases
Revoke unused keys - Remove keys you no longer need
Never share keys - Each user should have their own key

Data Access

The MCP server only provides read access to your Searchable data. It cannot:

Modify your projects or settings
Delete any data
Access other users’ projects
Perform actions on your behalf

API Reference

Server Details

Property	Value
Endpoint	`https://searchable-mcp-production.searchable.workers.dev/sse`
Transport	Server-Sent Events (SSE)
Protocol	MCP 1.0
Authentication	Bearer token

Rate Limits

100 requests per minute per API key
Requests exceeding the limit return 429 status
Rate limits reset after 60 seconds

Support

Need help with the MCP integration?

Documentation

Browse all integrations

Support

Contact our team

Getting Started

Using Searchable

Integrations

Advanced Features

​What is MCP?

​Setup Guide

​Step 1: Get Your API Key

​Step 2: Configure Your AI Assistant

​Step 3: Verify Connection

​Available Tools

​Project Management

list_projects

​AI Visibility

get_visibility_summary

get_visibility_details

​Site Audits

get_website_issues

get_page_audits

get_monitored_pages

get_issue_details

​Content & Articles

list_articles

get_article

​Example Prompts

​Visibility Analysis

​Site Audit

​Content Management

​Use Cases

​Automated Issue Fixing

​For Developers

​For AEO/SEO Teams

​For Content Teams

​Troubleshooting

​Security

​API Key Best Practices

​Data Access

​API Reference

​Server Details

​Rate Limits

​Support

Documentation

Support

What is MCP?

Setup Guide

Step 1: Get Your API Key

Step 2: Configure Your AI Assistant

Step 3: Verify Connection

Available Tools

Project Management

AI Visibility

Site Audits

Content & Articles

Example Prompts

Visibility Analysis

Site Audit

Content Management

Use Cases

Automated Issue Fixing

For Developers

For AEO/SEO Teams

For Content Teams

Troubleshooting

Security

API Key Best Practices

Data Access

API Reference

Server Details

Rate Limits

Support