API & MCP Server

Give your AI agents SEO superpowers

AISEO exposes a full MCP server with 19 tools — sync data, generate insights, create content, manage rankings, and publish to your CMS. Connect any AI agent or build custom automations via a standard API.

Get Your API Key Client Setup Guides

Connect in minutes

Three steps to connect your AI agent to your SEO data.

Step 01

Generate an API Key

Go to Settings > API Keys in your AISEO dashboard. Create a key and copy it — you'll use it as a Bearer token.

Step 02

Configure Your Client

Point your MCP client to https://app.aiseo.guru/api/mcp with your API key in the Authorization header.

Step 03

Start Calling Tools

Your AI agent can now sync data, generate insights, create content briefs, and publish — all programmatically.

Standard Protocol

JSON-RPC over HTTP

No SDK required. The MCP endpoint accepts standard JSON-RPC 2.0 requests. Call it with curl, fetch, or any HTTP client. Works with Streamable HTTP transport and legacy SSE for backward compatibility.

  • Streamable HTTP — POST JSON-RPC, get JSON response
  • Legacy SSE — GET for event stream, POST for commands
  • Bearer token auth — same API keys as the dashboard
  • Compatible with Claude Desktop, mcporter, Cursor, and more
terminal
# List available 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","params":{}}'
# Generate insights 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":"generate_insights",
"arguments":{"project_id":"..."}}}'

What you can build

From simple automations to fully autonomous SEO agents.

AI Agent Workflows

Let AI agents autonomously monitor your rankings, generate insights, create content briefs, and publish to your CMS — all without manual intervention.

Custom Automations

Build automated pipelines: sync data daily, generate weekly reports, auto-create content briefs for decaying pages, or trigger audits on a schedule.

Build on Top of AISEO

Use the API to build custom dashboards, integrate SEO data into your existing tools, or create white-label solutions for your clients.

mcpServers config
{
"mcpServers": {
"aiseo": {
"url": "https://app.aiseo.guru/api/mcp",
"headers": {
"Authorization": "Bearer ${AISEO_API_KEY}"
}
}
}
}
Secure by Default

Works with any MCP client

Add AISEO to your MCP client config and your AI agent gets instant access to 19 SEO tools. API keys are hashed and stored securely — revoke them anytime from your dashboard.

  • API keys scoped to your account — each key has its own usage tracking
  • Hashed storage — keys are never stored in plain text
  • Instant revocation — disable a key with one click
  • Environment variable support — keep keys out of config files

19 tools, one endpoint

Everything your AI agent needs to manage SEO — from data syncing to content publishing.

sync_data
Pull latest SEO data from all connected sources
generate_insights
Trigger AI insight analysis for a project
get_insights
Fetch prioritized insights with severity and metrics
get_deliverables
List content briefs, checklists, and plans
generate_deliverable
Create a new deliverable from an insight
write_deliverable
Write content for a deliverable
score_content
Score content against an SEO brief
get_rankings
Fetch keyword rankings and position data
generate_image
Generate AI images for content
queue_publish
Queue content for CMS publishing
get_publish_queue
Check publishing queue status
get_connections
List CMS connections for a project
list_projects
List all projects for the authenticated user
get_activity
Fetch activity log and audit trail
list_shopify_articles
List blog posts from Shopify
find_shopify_page
Find a specific Shopify page
update_shopify_article
Update a Shopify blog post
list_shopify_products
List products from Shopify store
update_shopify_product
Update Shopify product SEO fields

Frequently asked questions

What is MCP?
Model Context Protocol (MCP) is an open standard for connecting AI agents to external tools and data. AISEO exposes a full MCP server so any compatible AI client can access your SEO data and take actions on your behalf.
Which MCP clients work with AISEO?
Any MCP client that supports Streamable HTTP transport — including Claude Desktop, Clawbot/OpenClaw (mcporter), Cursor, and custom implementations. The endpoint also supports legacy SSE transport for backward compatibility.
How do I authenticate?
Generate an API key in your AISEO dashboard at Settings > API Keys. Pass it as a Bearer token in the Authorization header: 'Authorization: Bearer sk_live_...'
Is there a rate limit?
API calls count toward your plan's AI query limits. Pro plans get 50 AI queries/month, Agency plans get unlimited queries.
Can I use regular REST API calls instead of MCP?
Yes. The MCP endpoint accepts standard JSON-RPC 2.0 requests over HTTP POST. You can call any tool with curl or any HTTP client — no MCP SDK required.

Works with every major AI agent

Step-by-step setup guides for OpenClaw, Claude Desktop, Cursor, Memu, Nanobot, Cline, Claude Code, and custom integrations. Side-by-side comparison table included.

OpenClawClaudeCursorMemuNanobotCline
View Client Guide

Automate your SEO workflow

Connect your AI agents to real SEO data. Generate your API key and start building in minutes.

Get Your API Key