Connect AI Assistants

Use Claude, Cursor, Windsurf, or any MCP-compatible AI assistant to query your Search Console data with natural language.

What is MCP?

The Model Context Protocol (MCP) is a standard that lets AI assistants connect to external data sources. Instead of copying data back and forth, your AI can query Koala SEO directly.

Koala SEO exposes the following MCP tools:

Tool	Description
list_sites	See all your verified properties
get_period_summary	Overview of clicks, impressions, CTR, position
get_top_keywords	Best performing queries
get_best_trends	Keywords with the biggest improvement
get_worst_trends	Keywords with the biggest decline
get_quick_wins	Keywords ranking 11-20 with potential
get_ctr_opportunities	Low CTR keywords in top positions

Setup for Claude Desktop

1. Get your API key from Settings → API Keys
2. Add to your Claude config (~/.config/claude/config.json on macOS/Linux):

{
	"mcpServers": {
		"koala-seo": {
			"command": "npx",
			"args": [
				"-y",
				"mcp-remote",
				"https://koalaseo.net/api/mcp",
				"--header",
				"Authorization: Bearer YOUR_API_KEY_HERE"
			]
		}
	}
}

Setup for Cursor

Create or edit ~/.cursor/mcp.json:

{
	"mcpServers": {
		"koala-seo": {
			"url": "https://koalaseo.net/api/mcp",
			"headers": {
				"Authorization": "Bearer YOUR_API_KEY_HERE"
			}
		}
	}
}

Setup for Windsurf

Add to your Windsurf MCP configuration:

{
	"mcpServers": [
		{
			"name": "koala-seo",
			"type": "http",
			"url": "https://koalaseo.net/api/mcp",
			"auth": {
				"type": "bearer",
				"token": "YOUR_API_KEY_HERE"
			}
		}
	]
}

Using the REST API

If you prefer building your own integration, Koala also provides a REST API. All endpoints are under /api/v1 and require Bearer token authentication.

See the MCP & REST API page for the full API reference.

Example Prompts

Once connected, try asking your AI assistant:

• "What are my top 10 keywords by clicks this month?"
• "Show me keywords that are declining and might need attention"
• "Which pages have the best CTR? What can I learn from them?"
• "Find quick wins — keywords ranking 11-20 with good impressions"
• "Compare my traffic this month vs last month"

Tips

• Be specific about timeframes — "last 30 days" vs "this week"
• Mention your site — "For example.com, show me..."
• Ask for analysis — "What should I focus on?" instead of just data
• Request summaries — "Give me a weekly report"