Connect with AI
Use ShuttleSEO inside ChatGPT, Claude, and coding agents
Connect ShuttleSEO to 
your AI assistant to use live keyword data in the workflow you already use.
Connect ShuttleSEO to Codex
Give Codex keyword context while it audits content, writes pages, or plans SEO improvements.
Use this when you want keyword data while editing a repo or planning SEO changes from Codex.
- 1Add the remote MCP serverRun this command in your terminal. It stores ShuttleSEO as a remote MCP server for Codex.
codex mcp add shuttleseo --url https://shuttleseo.com/api/mcp - 2Restart CodexClose and reopen Codex so the new MCP server is loaded before your next session.
- 3Authenticate on first useThe first ShuttleSEO tool call opens the OAuth flow. Sign in with your ShuttleSEO account, then return to Codex.
Prompt examples
Use ShuttleSEO to find low-competition keywords for a landing page about AI invoice automation.
Use ShuttleSEO to check how many searches I have left this month.
Research Google keyword ideas for the current product page and suggest SEO sections to add.
Find YouTube keyword ideas for this topic, then turn them into content briefs.
If your assistant starts writing code instead
If it suggests curl, bash, scripts, API keys, or artifacts, the MCP tool is probably not active in that chat or the OAuth session expired. Reconnect ShuttleSEO from Apps, Connectors, or MCP settings, then ask it to use the ShuttleSEO MCP tool directly.
MCP details
Endpoint
https://shuttleseo.com/api/mcp
Tools
search_keywords
Search keyword ideas. Free accounts get suggestions only; paid accounts get volume, competition, CPC, metric filters, and monthly usage in the response.
get_usage
Check the connected account's plan, monthly search limit, searches used, searches remaining, and reset date.
Auth
OAuth with ShuttleSEO
Free access
No metrics, no metric filters, no cache hit. Suggestions only.
| Parameter | Type | Use |
|---|---|---|
| query | Required | Seed keyword or topic to research. |
| source | Optional | google, youtube, amazon, local, or all. |
| country | Optional | Country code such as us, fr, gb, de, or jp. |
| limit | Optional | Number of keyword ideas to return. |
| minVolume / maxVolume | Optional | Filter by monthly search volume. |
| minCompetition / maxCompetition | Optional | Filter by competition score. |
| includeTerms / excludeTerms | Optional | Force or remove terms from results. |