Connect AI Assistants

Use ChatGPT, 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
`get_seo_triage_packet`	One-call weekly triage: health, urgent issues, ranked actions
`get_content_decay_candidates`	Pages losing traffic and the keywords bleeding clicks
`get_page_audit_packet`	Per-page technical + content audit with a 0-100 score
`get_keyword_opportunity_report`	Single-keyword deep dive with a suggested action

Setup for ChatGPT or Claude.ai (web)

These connect straight to a URL and sign in with your Koala SEO account through OAuth - no API key to copy.

ChatGPT (Plus, Pro, Business, Enterprise, or Edu - Developer Mode, currently in beta):

Go to Settings → Apps & Connectors → Advanced → Developer mode, then add a connector.
Server URL: https://koalaseo.net/api/mcp
Sign in when prompted. ChatGPT registers itself with Koala SEO automatically the first time.

On Plus and Pro, ChatGPT connects in read-only mode - fine here, since every Koala SEO tool only reads data. Write access is a Business/Enterprise/Edu-only ChatGPT restriction, not something this server needs.

Claude.ai (Pro, Max, Team, or Enterprise - not available on the Free plan):

Go to Settings → Connectors, then Add custom connector (Team/Enterprise: an Owner adds it once under Organization Settings, then members connect individually).
Server URL: https://koalaseo.net/api/mcp
Sign in when prompted.

Either way, you can disconnect at any time from that same Settings screen in ChatGPT or Claude.

Setup for Claude Desktop

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

json

{
	"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:

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:

json

{
	"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"
"Run the SEO triage packet for example.com - what should I fix this week?"
"Which pages are decaying and which keywords are bleeding clicks?"
"Audit https://example.com/pricing - indexing, speed, and keyword coverage"

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"