🔍 Searchable MCP

Connect your Searchable AI visibility data directly to Cursor IDE via MCP (Model Context Protocol).

✨ What You Can Do

Ask Cursor questions about your website's AI visibility and get real data:

• "What's my AI visibility score?" — See how often your brand appears in AI responses
• "How do I rank on ChatGPT vs Claude?" — Compare visibility across platforms
• "What issues are on my website?" — Get critical SEO and content issues
• "Show me my page audit scores" — Technical, content, and AEO scores

🚀 Quick Start

1. Get Your API Key

1. Log in to Searchable
2. Go to Settings → Integrations → Cursor MCP
3. Click Create API Key
4. Copy the key (starts with sea_)

2. Configure Cursor

Add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "searchable": {
      "command": "npx",
      "args": ["-y", "searchable-mcp@latest"],
      "env": {
        "SEARCHABLE_API_KEY": "sea_your_key_here"
      }
    }
  }
}

3. Restart Cursor

That's it! Start asking questions about your AI visibility.

🛠 Available Tools

| Tool | Description | |------|-------------| | list_projects | List all your Searchable projects | | get_visibility_summary | Overall AI visibility score and metrics | | get_visibility_details | Breakdown by platform (ChatGPT, Claude, Perplexity, Gemini) | | get_website_issues | Current issues grouped by severity | | get_page_audits | Technical, content, and AEO scores per page | | get_monitored_pages | All tracked pages with issue counts | | get_issue_details | Deep dive into specific issue types |

📊 Example Output

Visibility Summary:

Brand: Acme Corp
Visibility Score: 67.3 (+5.2 from last week)
Mention Rate: 42.1%
Total AI Responses Analyzed: 1,247

Platform Breakdown:

ChatGPT:    71.2% visibility (523 responses)
Claude:     64.8% visibility (312 responses)
Perplexity: 58.3% visibility (287 responses)
Gemini:     52.1% visibility (125 responses)

🔧 Troubleshooting

"spawn npx ENOENT" error?

If you use nvm, fnm, or volta, Cursor may not find npx. Use the full path instead:

# Find your npx path
which npx

Then update your config:

{
  "searchable": {
    "command": "/path/to/your/npx",
    "args": ["-y", "searchable-mcp@latest"],
    "env": {
      "SEARCHABLE_API_KEY": "sea_xxx"
    }
  }
}

🔒 Security

• API keys are scoped to read-only access
• Keys can be revoked instantly from the Searchable dashboard
• No sensitive data is stored locally

📚 Resources

• Searchable Documentation
• MCP Protocol Spec
• Report Issues

📄 License

MIT © Searchable