🔍 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

$3

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

$3

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

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

$3

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:

`bash


Find your npx path


which npx
`

Then update your config:
`json
{
"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