Agent setup guide

SEO MCP Server custom API setup

Connect the CallAI SEO MCP server: install the @callaiapi/seo plugin in DeepSeek Harness (dsh), or add the URL and your API key to any Streamable HTTP MCP client such as Claude Code or Cursor. Your agent can then query live Google/Bing results with AI Overview sources, keyword volume and difficulty, competitor keyword gaps, backlinks and on-page audits. Data from DataForSEO, billed per call from $1, no subscription.

📋 SEO MCP Server config cheatsheetProduction-ready
MCP URL (Streamable HTTP)
https://api.callaiapi.com/mcp
HeaderCreate it under API Keys in the console
Authorization: Bearer sk-live-your-callai-key
dsh plugin package
@callaiapi/seo

Step-by-step setup

1

Create an API key and top up

Sign in, create a key under API Keys and add any amount (from $1). Each tool call is billed at the DataForSEO cost and every result states what it cost.

2

DeepSeek Harness: install the plugin

Install it into your profile and restart dsh, or find @callaiapi/seo in the plugin shop. The plugin also ships a callai-seo skill that teaches the agent keyword research, competitor gaps and backlink checks.

dsh plugin --profile web add @callaiapi/seo
3

DeepSeek Harness: add your key

Pick one: put it in ~/.dsh/.env (profiles with the credentials service, such as web); set apiKey for callai-seo in the profile's cordis.patch.yml; or export CALLAI_API_KEY when starting dsh (works in every profile). Full guide in the README of github.com/hanshengcc/callai-seo-mcp.

# ~/.dsh/.env
CALLAI_API_KEY=sk-live-your-callai-key

# or ~/.dsh/profiles/web/cordis.patch.yml
- id: callai-seo
  config:
    apiKey: sk-live-your-callai-key
4

Claude Code: one command

Other clients with remote MCP support work the same way: URL https://api.callaiapi.com/mcp plus the Authorization header.

claude mcp add --transport http callai https://api.callaiapi.com/mcp \
  --header "Authorization: Bearer sk-live-your-callai-key"
5

Cursor: add to mcp.json

Add this to .cursor/mcp.json in your project (or ~/.cursor/mcp.json) and restart Cursor.

{
  "mcpServers": {
    "callai": {
      "url": "https://api.callaiapi.com/mcp",
      "headers": { "Authorization": "Bearer sk-live-your-callai-key" }
    }
  }
}
6

Ask

Tools: google_serp, bing_serp, keyword_overview, keyword_ideas, ranked_keywords, domain_overview, keyword_gap, backlinks_summary, referring_domains, page_audit, and dataforseo_request for any other DataForSEO v3 endpoint. Try: "Find long-tail keywords about standing desks in the UK with difficulty under 30 and show who ranks for the top three."

Troubleshooting

❌ Symptom:Tool says Insufficient CallAI balance
💡 Fix: Top up in the console and retry; failed requests are not charged twice.
❌ Symptom:Connection fails or returns 401
💡 Fix: Check the header is Authorization: Bearer plus the full key, the key is active in the console, and it has not hit its spend limit.
❌ Symptom:No mcp__callai__ tools in dsh
💡 Fix: Restart dsh after installing. Without a key the plugin logs [callai-seo] No API key and adds no tools; set the key and restart dsh (a credential saved through dsh reconnects on its own).
API still unreachable after setup?
Use the HTTP status checker to test connectivity and diagnose 403 / 401 errors.
Open status checker →