Callai Seo MCP Server

CallAI — live SEO data for AI agents

中文说明

CallAI gives your AI agent real search data instead of guesses: live Google and Bing results (including the Google AI Overview and the sites it cites), keyword volume and difficulty, long-tail ideas, competitor keyword gaps, domain traffic, backlinks and on-page audits.

It works two ways:

• DeepSeek Harness (dsh) plugin — this npm package, @callaiapi/seo. Installs the tools plus a callai-seo skill that teaches the agent how to do keyword research, competitor analysis, GEO checks and audits.
• Remote MCP server — https://api.callaiapi.com/mcp, for Claude Code, Cursor, VS Code, Cline, Windsurf and any other MCP client. Nothing to install.

Data comes from DataForSEO. Paid tools bill your CallAI balance per call: top up from $1, no subscription, balance never expires. Every result states what that call cost. Seven free tools need only an API key. Anyone can list the tools without a key.

---

Contents

• 1. Get an API key
• 2. Install in DeepSeek Harness
• 3. Use it in other MCP clients
• 4. What to ask
• 5. Tools reference
• 6. Markets: location and language codes
• 7. Pricing and cost control
• 8. Troubleshooting
• 9. FAQ

---

1. Get an API key

1. Sign up at https://callaiapi.com/register.
2. Top up any amount from $1 (cards, Apple Pay / Google Pay, or USDT on several chains).
3. Create a key under API Keys: https://callaiapi.com/portal?tab=keys. It looks like sk-live-…. You can set a spend limit per key.

2. Install in DeepSeek Harness

Requires dsh 0.2.0 or later.

dsh plugin --profile web add @callaiapi/seo

Use your own profile name instead of web if you run another one (ls ~/.dsh/profiles). You can also install @callaiapi/seo from a plugin shop such as dsh-plugin-shop. Restart dsh afterwards — a newly added plugin is not loaded into a running process.

Give the plugin your key

The plugin looks for the key in this order and uses the first one it finds:

Profile patch, in ~/.dsh/profiles/<profile>/cordis.patch.yml:

- id: callai-seo
  config:
    apiKey: sk-live-your-key

.env file, in ~/.dsh/.env:

CALLAI_API_KEY=sk-live-your-key

Saving the credential through dsh reconnects automatically; changes to the patch file, .env or the environment take effect after a dsh restart.

Check it works

Start a session and ask "Which mcp__callai tools do you have?" — the agent should list 20 tools, and "Audit https://example.com" should come back with real data and a billed_usd line.

Plugin settings

Uninstall

dsh plugin --profile web remove @callaiapi/seo

3. Use it in other MCP clients

Claude Code

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

Cursor — .cursor/mcp.json in your project, or ~/.cursor/mcp.json:

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

VS Code (Copilot agent mode) — .vscode/mcp.json:

{
  "inputs": [
    { "type": "promptString", "id": "callai-key", "description": "CallAI API key", "password": true }
  ],
  "servers": {
    "callai": {
      "type": "http",
      "url": "https://api.callaiapi.com/mcp",
      "headers": { "Authorization": "Bearer ${input:callai-key}" }
    }
  }
}

Windsurf, Cline and other clients — add a remote / Streamable HTTP server with the URL and header above. Clients that only support local (stdio) servers can bridge with mcp-remote:

{
  "mcpServers": {
    "callai": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.callaiapi.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer sk-live-your-key" }
    }
  }
}

4. What to ask

You don't call tools yourself — describe the job and the agent picks the tools. Examples:

• "Find long-tail keywords about standing desks for the UK with difficulty under 30, then check who ranks for the top three."
• "Compare my site example.com with competitor.com: traffic, the keywords they rank for that I don't, and backlink strength."
• "Does Google show an AI Overview for 'best crm for startups'? Which sites does it cite, and is mine one of them?"
• "Audit https://example.com/pricing and give me a fix list."
• "I'm about to buy the expired domain old-brand.com. Check its backlinks and spam score."
• "Get search volume and CPC for these 40 keywords in Germany, German language: …"

5. Tools reference

In dsh the tools appear as mcp__callai__<name>; other clients show <name>. Every result is JSON with billed_usd (what the call cost) and result. Parameters marked * are required. Every tool except the backlink and audit tools also accepts location_code and language_code (section 6).

Free tools

These need an API key but no balance, within a daily allowance of 200 units per account. keyword_suggestions counts 1 unit in seed mode, 3 in questions and 5 in az; the others count 1.

Domains can be given as example.com, www.example.com or a full URL.

6. Markets: location and language codes

Default market: United States (location_code 2840), English (language_code en). Tell the agent the market in plain words ("for Germany, in German") and it sets the codes.

Full list: DataForSEO locations.

7. Pricing and cost control

Calls are billed at the DataForSEO cost plus CallAI's margin; the exact amount is in each result's billed_usd and in your console call log. Typical costs:

A full keyword research session (ideas → metrics → SERP checks for five keywords) usually costs well under $0.10.

To keep spend predictable:

• Set a spend limit on the key in the console; calls stop when it is reached.
• The bundled skill tells the agent to batch keywords, start with small limits, and say before a run that would cost more than about $0.50.
• When the balance runs out, tools return "Insufficient CallAI balance" with the top-up link; nothing is charged for refused calls.

8. Troubleshooting

9. FAQ

Is there a free tier? No. New accounts start at $0 and you top up from $1; there is no subscription and no minimum monthly spend.

Where does the data come from? DataForSEO's live SERP, Labs, Backlinks and On-Page APIs. SERP results are fetched live at call time; keyword metrics and backlink indexes are DataForSEO's latest databases.

What do you store? For billing and your call log: the endpoint, status, cost and timing of each call. Keywords and domains are sent to DataForSEO to answer the request.

Can I call the API without an agent? Yes — the same data is available as a REST API at https://api.callaiapi.com/dataforseo/v3/... with DataForSEO's request format. See https://callaiapi.com/en/dataforseo.

I already have a DataForSEO account. Then you can use DataForSEO directly. CallAI is for people who want pay-as-you-go from $1 without a minimum deposit, one balance shared with LLM APIs, and an agent-ready MCP server.

Links

• Setup guide: https://callaiapi.com/en/integrations/seo-mcp
• Console: https://callaiapi.com/portal
• Issues: https://github.com/hanshengcc/callai-seo-mcp/issues

License

MIT