Keyword research MCP guide for Claude, ChatGPT, and Cursor
Set up a keyword research MCP server, then work through five copyable prompts. You start from the queries your site already gets in Google Search Console and finish by picking a page to improve.
What is a keyword research MCP?
MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools. A keyword research MCP server gives the assistant tools for search volume, keyword ideas, ranked keywords, and live SERP results. The assistant fetches the data and analyzes it in the same conversation.
CalmSEO is a hosted MCP server with these tools plus read-only access to your Google Search Console data.
Set up CalmSEO in your AI client
- Create a free CalmSEO account. Connect Google Search Console from the dashboard to run steps 1 and 5.
- Add the MCP server URL https://mcp.calmseo.com/mcp to your client.
- Claude web and Claude Desktop: add a custom connector. See the Claude setup docs or the longer guide to connecting Search Console to Claude.
- Claude Code: run this command.
claude mcp add calmseo --transport http https://mcp.calmseo.com/mcp - ChatGPT: create an app in developer mode. See the ChatGPT setup docs or the guide to connecting Search Console to ChatGPT.
- Cursor: add CalmSEO to your MCP configuration. See the Cursor setup docs or the guide to SEO in Cursor with Search Console data.
- Sign in to CalmSEO when your client asks, then test the connection with Use CalmSEO to list my Search Console properties.
A five-step keyword research workflow
Each step lists the tools your assistant calls, what they return, and what they cost. Replace example.com, competitor.com, and the target query with your own. Run the steps in one conversation so the assistant keeps earlier results in context.
Step 1. Pull the queries your site already gets
Search Console lists the queries your pages already appear for, including ones you never targeted.
- get_gsc_top_queries returns top queries for a property with clicks, impressions, CTR, and average position (up to 250 rows). Cost: free.
- query_gsc_search_analytics returns the same metrics with custom dimensions and filters, such as query plus page (up to 25,000 rows). Cost: free.
Use CalmSEO to list my Search Console properties. Then get the top 100 queries for sc-domain:example.com over the last 90 days with clicks, impressions, CTR, and average position. Flag queries with an average position between 8 and 30.Search Console data usually lags by two to three days, so end the date range a few days before today.
Step 2. Check search volume for those queries
Impressions count how often Google shows your site for a query. Search volume shows how many people search for it each month. Use it to prioritize the list.
- get_keyword_search_volume returns Google Ads monthly search volume, CPC, competition, and top-of-page bid range for up to 1,000 keywords per call, with optional monthly history. Cost: 15 credits per call.
Check Google search volume, CPC, and competition for those queries in a single call, for the United States in English. Show a table with volume, Search Console impressions, and position for each query.The cost is per call, so send all keywords at once. Very new terms often have no Google Ads volume yet. For those, use Search Console impressions as the demand signal. To check up to 10 keywords without an account, use the free keyword volume checker.
Step 3. Expand with ranked keywords or keyword ideas
Next, look beyond your own queries. Ranked keywords show what a competitor's site or a specific page ranks for. Keyword ideas turn a few seed terms into a longer list.
- get_ranked_keywords returns keywords a domain, subdomain, or URL ranks for in Google, with search volume, keyword difficulty, ranking position, ranking URL, and estimated traffic. Cost: 5 credits for up to 100 results, 20 credits for up to 1,000.
- find_keyword_ideas returns related keywords for up to 50 seed terms, with search volume, CPC, competition, and keyword difficulty. Cost: 15 credits for up to 50 results, 25 for up to 250, 50 for up to 1,000.
Get the top 100 ranked keywords for competitor.com in the United States. List the ones that fit my site and are missing from my Search Console queries above, grouped by topic.Step 4. Check the SERP for your target query
Pick one query and see what ranks for it. The page types on page one show what content Google expects for that search.
- search_serp returns live Google or Bing organic results with position, domain, title, URL, and snippet, plus a count of the result types on the page. Cost: 1 credit for the top 10, 2 for the top 20, 3 for the top 100.
Run a Google SERP search for "your target query" in the United States on desktop. Tell me which kinds of pages rank (guides, tools, directories, product pages) and whether my site appears in the top 10.Use a plain keyword. The tool does not support search operators such as site:, inurl:, and intitle:. The free SERP checker shows the same top 10 in your browser.
Step 5. Decide which page to improve
Updating a page that already gets impressions for the query is often the quickest gain. Search Console shows which page that is.
- get_gsc_page_queries returns the queries that drove impressions and clicks for one page URL. Cost: free.
- audit_page returns an on-page check of a single URL with title, meta description, H1, canonical, link counts, and failed checks. Cost: 5 credits.
Use Search Console to find which of my pages gets impressions for "your target query". Get all queries for that page, audit it, and compare it with the top results from the SERP check. Tell me whether to update that page or create a new one, and list specific changes to the title, H1, and sections.What a full run costs
The prompts above use 26 credits: 15 for search volume, 5 for 100 ranked keywords, 1 for a top 10 SERP check, and 5 for the page audit. Swap ranked keywords for 50 keyword ideas and the total is 36. Search Console calls are free. Each paid call reports the credits it used and your remaining balance.
Keyword research with DataForSEO MCP and other SEO MCP servers
DataForSEO publishes its own MCP server with many of its API endpoints, including keyword data, SERP, and DataForSEO Labs. You connect it with your DataForSEO API credentials and pay DataForSEO per request. It suits people who already have a DataForSEO account or need endpoints CalmSEO does not offer. It does not read Search Console data, so starting from your own queries requires a separate Search Console MCP server.
SEO suites such as Ahrefs, Semrush, and Similarweb offer MCP access to their own data. Plan availability varies by provider.
CalmSEO uses professional SEO data providers and offers a smaller set of tools with compact responses and monthly credits. Search Console and the paid keyword tools share one MCP endpoint, so the whole workflow above runs in one conversation. For a detailed comparison, see the DataForSEO MCP alternative page.
Pricing
Search Console tools are free. Keyword, SERP, audit, and backlink tools use credits from your plan.
For trying it out
Get started- 30 credits to start
- Enough for one full SEO fix run
- Search Console tools with basic limits
- MCP and REST API access
- OAuth-secured
For occasional research
Get started- 300 credits / month
- About 20 search volume checks (up to 1,000 keywords each), 300 SERP checks, or 60 page audits
- Search Console tools with higher limits
- MCP and REST API access
- Email support
For growing workflows
Get started- 1,500 credits / month
- About 100 search volume checks (up to 1,000 keywords each), 1,500 SERP checks, or 300 page audits
- Search Console tools with higher limits
- MCP and REST API access
- Email support
For agencies
Get started- 3,500 credits / month
- About 233 search volume checks (up to 1,000 keywords each), 3,500 SERP checks, or 700 page audits
- Search Console tools with higher limits
- MCP and REST API access
- Priority support
What each tool costs
Dollar amounts use the Lite rate of $10 for 300 credits. Search Console tools are free.
- SERP check (top 10 results)
- 1 credit, about $0.03
- Page audit
- 5 credits, about $0.17
- Ranked keywords (up to 100)
- 5 credits, about $0.17
- Search volume check (up to 1,000 keywords)
- 15 credits, about $0.50
- Keyword ideas (up to 50)
- 15 credits, about $0.50
- Backlink summary
- 5 credits, about $0.17
- Backlinks or link gap (up to 100)
- 5 credits, about $0.17
Frequently asked questions
Which MCP servers can do keyword research?+
CalmSEO, DataForSEO's MCP server, and the MCP servers from SEO suites such as Ahrefs, Semrush, and Similarweb all provide keyword data. They differ in data sources, setup, and pricing. CalmSEO combines search volume, keyword ideas, ranked keywords, and SERP results with your Google Search Console data in one server.
Does it work with Claude Code and Cursor?+
Yes. In Claude Code, run claude mcp add calmseo --transport http https://mcp.calmseo.com/mcp and sign in when prompted. In Cursor, follow the Cursor setup docs. Any client that supports remote MCP servers with OAuth can connect.
Can I use it in ChatGPT?+
Yes, through ChatGPT developer mode. Create an app with the CalmSEO MCP URL and choose OAuth. The ChatGPT setup docs cover each step.
What does keyword research with CalmSEO cost?+
Search Console tools are free. The other tools cost 1 to 50 credits per call, and the five-step workflow on this page uses 26. The Free plan starts with 30 credits. Paid plans start at $10 per month for 300 credits.
Do I need Google Search Console to use it?+
No. Search volume, keyword ideas, ranked keywords, SERP checks, and page audits work without it. You need it for steps 1 and 5 of the workflow, which use your own Search Console data.
Can I use it for local keyword research?+
Yes. Search volume, keyword ideas, ranked keywords, and SERP checks accept a location and language. The default is the United States in English.
Where does the keyword data come from?+
Search Console data comes from Google's Search Console API through your own read-only connection. Search volume comes from Google Ads data. Keyword ideas, ranked keywords, and SERP results come from professional SEO data providers.
Can I export results?+
The assistant can format results as a table, a CSV, or any format your client supports. CalmSEO returns structured data and has no separate export feature.
Start keyword research from your Search Console data
30 free credits + free Google Search Console tools. No card required.