Hallucinated metrics
Ask a bare LLM for keyword volumes or a backlink profile and you’ll get confident numbers with no connection to reality.
→ MCP tools return live DataForSEO data your AI can cite.
DataForSEO SEO MCP Server · Model Context Protocol
$1 in Free Credits · No Credit Card · No Subscription · Credits Never Expire
The problem
LLMs will happily invent search volumes and “analyze” rankings they’ve never seen. Grounding them in real data changes everything.
Ask a bare LLM for keyword volumes or a backlink profile and you’ll get confident numbers with no connection to reality.
→ MCP tools return live DataForSEO data your AI can cite.
Exporting from SEO tools, pasting into chats, re-formatting — the “AI workflow” that’s slower than doing it by hand.
→ The assistant queries the data itself, mid-conversation.
Every custom SEO workflow used to mean API integration work before you saw any value.
→ One config line connects Claude or Cursor — no code.
Choose your AI client and follow the instructions to connect with DataForSEO APIs.
Open Claude Desktop and go to Customize → Connectors.
Click Add custom connector and paste the DataForSEO MCP HTTP URL:
https://mcp.dataforseo.com/mcpWhen prompted, approve the Authorization request to access the DataForSEO API.
Start a new chat. Claude will request your approval the first time it calls a DataForSEO tool.
Open the configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonAdd the following configuration to the file:
{
"mcpServers": {
"dataforseo": {
"command": "npx",
"args": ["-y", "dataforseo-mcp-server"],
"env": {
"DATAFORSEO_USERNAME": "your_api_login",
"DATAFORSEO_PASSWORD": "your_api_password"
}
}
}
}
Replace your_api_login and your_api_password with credentials from the API Access dashboard.
Restart Claude Desktop. The DataForSEO tools will appear in your tool list.
Generate a Base64 token from your API login and password (or copy a pre-encoded one from the API Access dashboard via the Send by Email button).
Add the remote DataForSEO MCP server in your terminal:
claude mcp add --header "Authorization: Basic " --transport http dfs-mcp https://mcp.dataforseo.com/mcp
Verify the connection:
claude mcp list
Make sure you have Node.js 18+ installed.
Register the local NPX server with your credentials:
claude mcp add dataforseo \
--env DATAFORSEO_USERNAME=your_api_login \
--env DATAFORSEO_PASSWORD=your_api_password \
-- npx -y dataforseo-mcp-server
Verify the connection:
claude mcp list
In Cursor, open Settings → Tools & Integrations → MCP Tools.
Click Add Custom MCP and paste the remote configuration:
{
"mcpServers": {
"dataforseo": {
"url": "https://mcp.dataforseo.com/mcp",
"headers": {
"Authorization": "Basic "
}
}
}
}
Replace with your Base64-encoded username:password from the API Access dashboard.
Save and reopen the chat. Cursor supports up to 40 active MCP tools — disable any modules you don’t need.
Open the global Cursor MCP configuration:
~/.cursor/mcp.jsonAdd the local NPX configuration:
{
"mcpServers": {
"dataforseo": {
"command": "npx",
"args": ["-y", "dataforseo-mcp-server"],
"env": {
"DATAFORSEO_USERNAME": "your_api_login",
"DATAFORSEO_PASSWORD": "your_api_password"
}
}
}
}
Replace credentials with values from the API Access dashboard and save the file.
Restart Cursor or reload the MCP servers from Tools & Integrations.
Log into the OpenAI platform dashboard, go to Settings → Apps → Advanced Settings and enable the Developer mode.
Go back to Apps and click Create app.
Paste the DataForSEO MCP server URL and give the app a name:
https://mcp.dataforseo.com/mcpSelect the OAuth authentication method and click Create
When prompted, approve the Authorization request to access the DataForSEO API.
Start a new chat. ChatGPT will request your approval the first time it calls a DataForSEO tool.
Install the Gemini CLI globally:
npm install -g @google/gemini-cli
Open the Gemini settings file:
~/.gemini/settings.jsonC:\Users\\.gemini\settings.json Add the DataForSEO MCP server:
{
"selectedAuthType": "gemini-api-key",
"mcpServers": {
"dataforseo": {
"command": "npx",
"args": ["-y", "dataforseo-mcp-server"],
"env": {
"DATAFORSEO_USERNAME": "your_api_login",
"DATAFORSEO_PASSWORD": "your_api_password"
}
}
}
}
Restart the CLI and run /mcp list to confirm DataForSEO is connected.
Install Docker for your operating system.
Pull and run the official DataForSEO MCP image:
docker run -p 3000:3000 \
-e DATAFORSEO_USERNAME=your_api_login \
-e DATAFORSEO_PASSWORD=your_api_password \
dataforseo/mcp:latest
The MCP server is now available locally at:
http://localhost:3000Point your MCP-compatible client to the official DataForSEO remote endpoint:
https://mcp.dataforseo.com/mcpAuthenticate with a Base64-encoded Basic Auth header:
Authorization: Basic
If your client expects a separate SSE endpoint, use https://mcp.dataforseo.com/http.
Make sure Node.js 18+ is installed, then launch the server locally:
npx -y dataforseo-mcp-server
Provide your credentials as environment variables:
export DATAFORSEO_USERNAME=your_api_login
export DATAFORSEO_PASSWORD=your_api_password
Or register the server directly inside your client config:
{
"mcpServers": {
"dataforseo": {
"command": "npx",
"args": ["-y", "dataforseo-mcp-server"],
"env": {
"DATAFORSEO_USERNAME": "your_api_login",
"DATAFORSEO_PASSWORD": "your_api_password"
}
}
}
}
What's inside
Seven DataForSEO APIs, exposed as tools any MCP-compatible agent can call.
Search volume, CPC, difficulty, intent, and suggestions — pulled live from Keywords Data and Labs APIs mid-conversation.
Real search results for any query and location, so competitive analysis is grounded in what Google actually shows.
On-Page API checks through natural language: “audit this page and list the top issues” returns real crawl data.
Link profiles, competitor comparisons, and domain analytics — formatted into tables and recommendations by your agent.
Who it's for
SEO specialists
Keyword clusters, competitor snapshots, and audit summaries in the same chat where you write the strategy.
Content teams
Brief and draft with real search volumes and SERP context — content built on data instead of vibes.
Builders & automators
Wire the MCP server into Claude Code, Cursor, or n8n agents and productize SEO deliverables end to end.
SEO software
Validate data-driven features in a chat before committing engineering time to a full integration.
Pricing
The MCP server is free and open source. You pay only standard pay-as-you-go rates for the data your assistant pulls.
| Endpoint | Price | Turnaround |
|---|---|---|
| MCP server & connection | free — open source on GitHub | npx or hosted HTTP |
| 100 related keywords | ≈ $0.024 in API usage | seconds |
| SERP check (Live) | from $0.002 per query | seconds |
| Backlink summary | $0.024 + $0.000036 per row | ~2 s |
Social proof
"I always recommend DataForSEO. No worries about server capacity, no need for maintenance, and splendid possibilities for rapid development."
"We found DataForSEO online while planning our beta. We were impressed by the responsive team and comprehensive APIs."
"DataForSEO has always been in our toolkit. When exploring an API, you see what it's truly capable of. Documentation is awesome."
Implementation
Every endpoint, parameter, and response field documented with live examples.
Read the docs →
Prototype against the Sandbox for free and fire test calls from the browser before you write a line of code.
Open the Sandbox →
Ask it anything about the API — it answers from the docs and drafts integration scripts for you.
Ask the AI assistant →Real engineers on the other end — during evaluation, integration, and every day after.
Talk to us →MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools. The DataForSEO MCP server exposes seven SEO APIs — SERP, Keywords Data, Labs, Backlinks, On-Page, Business Data, and Domain Analytics — as tools that Claude, Cursor, and other MCP clients can use in conversation.
Add one entry to your MCP config running “npx -y dataforseo-mcp-server” with your DataForSEO credentials, or connect to the hosted endpoint at mcp.dataforseo.com/mcp. The server is open source at github.com/dataforseo/mcp-server-typescript.
Any MCP-compatible client — including Claude Desktop, Claude Code, Cursor, and n8n’s MCP integration.
No. The server itself is free; you pay only the standard pay-as-you-go API rates for data your assistant actually requests — for example, about $0.024 for 100 related keywords.
No. Setup is a config snippet, and everything after that is plain English. Developers can go deeper, but it’s not required.
Register a DataForSEO account — it takes a minute and comes with $1 in free API credits, enough for plenty of test questions. Credits never expire.
The numbers come from DataForSEO APIs, not the model’s imagination — the same data that powers hundreds of SEO tools. The assistant formats and interprets; the data stays real.
Register, drop the config in, and ask your first data-grounded question today.
$1 in Free Credits · No Credit Card · Pay as You Go from $50