MCP Client Guide

Connect AISEO to any AI agent

One API key. 19 SEO tools. Works with OpenClaw, Claude Desktop, Cursor, Cline, Claude Code, or any MCP-compatible client. Pick your agent and follow the guide.

Choose your AI agent

Each client connects to the same AISEO MCP endpoint. The setup is nearly identical — just the config location changes.

OpenClaw

The viral AI agent with 250k+ followers

Popular

OpenClaw uses mcporter to connect to MCP servers. Add AISEO to your mcporter config and your agent gets instant access to 19 SEO tools — sync data, generate insights, create content, and publish to Shopify, all through natural language.

Best for

Autonomous SEO workflows, content creation, hands-free publishing

  • Natural language tool calling — ask your agent to check rankings or write a brief
  • Supports ${VAR} interpolation for secrets
  • Verify with: mcporter list aiseo --schema
  • 500+ community MCP servers alongside AISEO
Learn more about OpenClaw
mcporter.json
// config/mcporter.json
{
  "mcpServers": {
    "aiseo": {
      "url": "https://app.aiseo.guru/api/mcp",
      "headers": {
        "Authorization": "Bearer ${AISEO_API_KEY}"
      }
    }
  }
}

Claude Desktop

Anthropic's official desktop app

Claude Desktop has native MCP support built in. Add AISEO as a server in your Claude Desktop settings and Claude can directly query your SEO data, generate content briefs, and analyze your keyword rankings mid-conversation.

Best for

Interactive SEO analysis, conversational strategy sessions, quick data lookups

  • Ask Claude about your rankings, traffic, and content gaps
  • Generate deliverables directly in conversation
  • Deep reasoning on SEO strategy with real data
  • Works alongside other MCP servers (GitHub, Notion, etc.)
Learn more about Claude Desktop
claude_desktop_config.json
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "aiseo": {
      "url": "https://app.aiseo.guru/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

Claude Code

CLI coding agent by Anthropic

Claude Code is a terminal-based coding assistant that supports MCP servers. Connect AISEO to automate SEO tasks as part of your development workflow — generate schema markup, optimize meta tags, or create content programmatically while you code.

Best for

Developer workflows, automated schema generation, CI/CD SEO checks

  • SEO data available in your terminal coding sessions
  • Automate content generation alongside code changes
  • Project-scoped config via .mcp.json
  • Combine with GitHub MCP for PR-based SEO workflows
Learn more about Claude Code
.mcp.json
// .mcp.json (project root)
{
  "mcpServers": {
    "aiseo": {
      "type": "url",
      "url": "https://app.aiseo.guru/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

Cursor

AI-powered code editor

Cursor's MCP integration lets you pull SEO data directly into your editor. Query keyword rankings while building pages, generate optimized meta tags inline, or have Cursor write schema markup based on your actual content performance.

Best for

Frontend developers, content-aware code generation, inline SEO optimization

  • Query SEO data while writing code
  • Auto-generate meta tags from ranking data
  • Build pages optimized for your actual keywords
  • Combine with database and API MCP servers
Learn more about Cursor
.cursor/mcp.json
// .cursor/mcp.json
{
  "mcpServers": {
    "aiseo": {
      "url": "https://app.aiseo.guru/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_key_here"
      }
    }
  }
}

Cline

Autonomous coding agent for VS Code

Cline is an open-source VS Code extension that connects to MCP servers for external tool access. Add AISEO to give Cline the ability to check your site's SEO health, create content briefs, and optimize pages — all from within VS Code.

Best for

VS Code users, autonomous page optimization, open-source workflows

  • SEO tools inside VS Code
  • Autonomous site auditing and optimization
  • Open-source and extensible
  • Works with any language or framework
Learn more about Cline
Cline MCP Settings
// VS Code Settings > Cline > MCP Servers
{
  "aiseo": {
    "url": "https://app.aiseo.guru/api/mcp",
    "headers": {
      "Authorization": "Bearer sk_live_your_key_here"
    }
  }
}

Memu

Proactive AI assistant that remembers everything

Memu is a proactive AI assistant that builds a local knowledge graph of your preferences, past projects, and habits. Connect AISEO and Memu learns your SEO workflow — it remembers which keywords you care about, your preferred content style, and can proactively suggest actions based on ranking changes.

Best for

Personalized SEO workflows, long-term memory across sessions, proactive alerts

  • Remembers your SEO preferences and content style across sessions
  • Proactive suggestions based on ranking changes
  • Local knowledge graph — your data stays private
  • More cost-efficient than OpenClaw with smarter context management
Learn more about Memu
memu config
# Configure MCP servers for Memu
# See https://memu.pro for setup

mcpServers:
  aiseo:
    url: https://app.aiseo.guru/api/mcp
    headers:
      Authorization: "Bearer ${AISEO_API_KEY}"

Nanobot

Lightweight open-source MCP agent framework

Nanobot is an ultra-lightweight Python agent framework that turns MCP servers into autonomous AI agents. At 1% of OpenClaw's codebase, it's the fastest way to build a dedicated SEO agent that runs on a schedule, responds in Slack/Discord/Telegram, and manages your rankings hands-free.

Best for

Lightweight automations, chat-based SEO bots, scheduled agents, self-hosted deployments

  • Ultra-lightweight — 1% of OpenClaw's codebase
  • Deploy as a Slack, Discord, Telegram, or WhatsApp bot
  • Stateful conversations with memory
  • Schedule recurring SEO tasks (daily syncs, weekly reports)
Learn more about Nanobot
nanobot.yaml
# nanobot.yaml
name: seo-agent
description: Autonomous SEO assistant
mcpServers:
  aiseo:
    url: https://app.aiseo.guru/api/mcp
    headers:
      Authorization: "Bearer ${AISEO_API_KEY}"

# Run it
pip install nanobot-ai
nanobot run

Custom / curl

Build your own integration

No MCP SDK required. AISEO's endpoint accepts standard JSON-RPC 2.0 over HTTP POST. Call it with curl, fetch, Python requests, or any HTTP client to build custom automations, cron jobs, or integrate SEO data into your own tools.

Best for

Custom scripts, cron automations, internal dashboards, white-label integrations

  • No SDK or framework required — just HTTP
  • Build cron jobs for daily sync and reporting
  • Integrate into CI/CD pipelines
  • Create white-label dashboards with your own frontend
terminal
# List all tools
curl -X POST https://app.aiseo.guru/api/mcp \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Sync SEO data for a project
curl -X POST https://app.aiseo.guru/api/mcp \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"sync_data",
       "arguments":{"project_id":"..."}}}'

Side-by-side comparison

All clients connect to the same 19 tools. Here's how they differ.

FeatureOpenClawClaudeCodeCursorClineMemuNanobotCustom
Setup complexityEasyEasyEasyEasyMediumMediumEasyFlexible
Natural language
Autonomous actions
Long-term memory
Publishing to CMS
IDE integration
Chat platforms
Batch automations
Free / open-source

All clients access the same 19 AISEO tools via a single API key.

Common questions

Do I need a different API key for each client?
No. One API key works with any MCP client. Generate it once at Settings > API Keys in your AISEO dashboard and use it everywhere.
Can I use multiple clients at the same time?
Yes. You might use Claude Desktop for strategy conversations, Cursor for code-level SEO optimizations, and OpenClaw for autonomous content workflows — all with the same API key.
Which client should I start with?
If you want hands-free automation, start with OpenClaw. If you want interactive analysis, use Claude Desktop. If you're a developer, Cursor or Claude Code will feel most natural.
Do API calls from MCP clients count toward my plan limits?
Yes. Each tool call counts as one AI query against your plan (Pro: 50/month, Agency: unlimited). Data-fetching tools like get_rankings don't count — only AI-powered tools like generate_insights do.
What MCP transport does AISEO support?
Streamable HTTP (the default for most clients) and legacy SSE for backward compatibility. All modern MCP clients use Streamable HTTP automatically.

Ready to connect your AI agent?

Generate your API key, pick your client, and start automating SEO in minutes.