SEO integration
DataForSEO MCP
analyze-seo scores a post's on-page SEO without leaving your site. With WP MCP Pro it can also look up keyword data (search volume, difficulty, CPC, competition and main intent) and backlink counts for a domain or URL, from your own DataForSEO account. An administrator saves the API login and password once with set-seo-data-key; they are stored encrypted and never returned by any tool. Nothing is sent until then. Answers are cached on your site for a day, so a repeat lookup sends nothing, and lookups back off automatically when the provider rate-limits.
In practice
How DataForSEO work goes with an agent.
DataForSEO is an API account, not a plugin on your site, so what WP MCP stores here is a credential and a cache rather than posts or options. An administrator saves the account's API login and password once, sealed with the site's own salts. After that two read-only operations of analyze-seo do the work: keywords returns volume, difficulty, CPC, competition and main intent, and backlinks returns link counts for a domain or a single page. Answers are cached on the site for a day, and a rate-limit reply from the provider starts a cooldown during which nothing is sent at all.
Save my DataForSEO credentials, then check search volume for "wordpress backup plugin" and "wp backup".
An administrator runs set-seo-data-key with login:password, which is checked for shape, encrypted and never echoed back. Then analyze-seo with op keywords returns search_volume, keyword_difficulty, cpc, competition and intent for each term. No post is touched.
Compare these 40 candidate keywords for the Canadian English market and rank them by volume against difficulty.
analyze-seo with op keywords takes up to 100 keywords per call, each at most 80 characters and 10 words, lowercased and de-duplicated. Pass location_code and language_code for the market; the defaults are 2840 (United States) and en. The ranking is done by the agent from the returned numbers.
How strong is the link profile of example.com, and of just the pricing page?
analyze-seo with op backlinks treats a bare domain, or a URL with an empty path, as a domain (www is dropped) and any other URL as a page. It returns rank, backlinks, referring_domains, referring_main_domains, referring_pages, broken_backlinks and spam_score, with subdomains included.
Run that keyword check again, I think the list changed by two terms.
Answers are cached per keyword, location and language for 24 hours, so only the two new keywords are requested from DataForSEO. When every keyword is cached the reply says cached:true and nothing leaves the site.
What your AI can do
Real DataForSEO operations, every write reversible.
- Look up search volume, difficulty, CPC and intent for a list of keywords
- Get backlink, referring domain and page counts for a domain or URL
- Combine the numbers with on-page scores and content edits in one session
- Keep credentials encrypted and out of every response
Example prompts
Example DataForSEO prompts.
Which of these ten keywords has the best volume for its difficulty?
How many referring domains does our homepage have?
Pick a focus keyword for the new pricing post from these candidates.
Under the hood
The DataForSEO calls, under the hood.
set-seo-data-key({ provider: "dataforseo", api_key: "login:password" }), stored encrypted, never returned
analyze-seo({ op: "keywords", keywords: ["mcp server", "wordpress ai"] }), cached a day
Safety and access
What can be undone on DataForSEO, and what costs what.
Recoverable on DataForSEO
- The lookups are read-only, so there is nothing on your posts or pages to roll back.
- Saving a credential with an empty api_key removes the stored one.
- Saving or clearing a credential also drops the cache and any rate-limit cooldown, so a corrected account works on the next lookup.
DataForSEO limits and opt-ins
- Without a saved credential a lookup refuses and sends nothing. If no encryption backend is available the key is not stored at all, rather than stored in plain text.
- A provider rate limit starts a cooldown (the provider's retry-after, 60 seconds when it gives none, capped at an hour). While it runs, no request is sent.
- DataForSEO is the sole provider wired up. Two lookups exist, keywords and backlinks. There is no rank tracking and no SERP fetch.
- set-seo-data-key needs manage_options. The lookups need edit_posts.
Free or Pro: None of this is in the free plugin. analyze-seo, including its on-page score op, and set-seo-data-key are Pro abilities. DataForSEO bills separately: you pay them directly for every request your account makes, and WP MCP adds no markup because there is no shared account. The score op never leaves your site, and only the keywords and backlinks ops contact api.dataforseo.com. Writing the results into titles and descriptions uses update-seo-meta, which is free.
Part of WP MCP Pro
The DataForSEO integration is part of WP MCP Pro.
One Pro licence unlocks the DataForSEO tools and every other Pro integration on this site: Elementor deep editing, the other page builders, the forms adapter pack and more, 133 Pro tools in all. The free plugin still covers the rest of WordPress and the full snapshot and undo engine, so you can try the safety model before you buy.
Frequently asked
DataForSEO MCP: questions, answered.
Does WP MCP resell DataForSEO data?
No. You bring your own DataForSEO account and pay them directly. There is no shared or built-in account.
What leaves my site?
Only the keywords or the domain you ask about, with location and language codes, sent to api.dataforseo.com with your credentials. Nothing is sent until you save credentials.
What format does the credential take?
The API login and API password from your DataForSEO account joined by a colon, as login:password. A value missing either half is refused with a message that names the format, and the refusal never repeats what you typed.
What happens when DataForSEO answers with a rate limit?
WP MCP records a cooldown, using the provider's retry-after when it sends one and 60 seconds otherwise, up to an hour. Until it ends, calls refuse locally with the seconds remaining and no request is sent, so an agent retrying in a loop cannot burn your quota.
With DataForSEO, can the agent ever see my password after I save it?
No. It is stored encrypted and no tool returns it. Error text from the provider or the network layer is also scrubbed of the login, the password and their Basic-auth encoding before it reaches the agent.
What does a keyword with no data look like?
The row comes back with found:false and null volume, difficulty, CPC, competition and intent. That empty answer is cached like any other, so asking again within a day does not send a second request for it.
Related integrations
More integrations for the same agent.
MCP for Yoast SEO
FreeSEO, 3 tools.
MCP for Rank Math
FreeSEO, 3 tools.
MCP for SEOPress
FreeSEO, 3 tools.
MCP for Redirection
FreeSEO, 2 tools.
MCP for The SEO Framework
FreeSEO, 3 tools.
MCP for SureRank
FreeSEO, 3 tools.
Browse the full Integrations hub, or read more on MCP for SEO and the WordPress MCP plugin.