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.
Full MCP access is included with Lifetime and monthly plans.
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 with volume, competition, CPC, metric filters, and current allowance usage. Requires Lifetime or a monthly plan.
get_usage
Check the connected account's plan, monthly search limit, searches used, searches remaining, and reset date.
Auth
OAuth with ShuttleSEO
Access
Included with Lifetime and monthly plans. Uses the same search allowance as the web app and API.
| 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. |