# Keyword.com MCP Server

- **OpenAPI Version:** `3.2.0`
- **API Version:** `1.0.0`

# MCP Server

The Keyword.com MCP server connects any MCP-compatible AI assistant — ChatGPT (via the Keyword.com app), Claude Code, Codex, Cursor, and any other MCP-compatible client — directly to your Keyword.com data. Ask questions in plain language; your assistant fetches the data, analyzes it, and responds.

## What you can do

Use it to:

- Track Google rankings, history, and Share of Voice movement
- Surface anomalies, recent gainers / losers, and at-risk keywords
- Investigate top-ranking pages, search intents, and SERP features
- Mine competitor keywords and rank distributions
- Monitor AI Visibility across LLM engines (ChatGPT, Perplexity, Gemini, AI Overviews) — citations, sentiment, mentions
- Add, update, refresh, and delete keywords in bulk
- Manage projects, groups, tags, and share-link settings

Example prompts:

- *"How are my keywords trending this week?"*
- *"Which competitors gained share of voice in the last 90 days?"*
- *"Which keywords had unusual rank movement in the last 7 days?"*
- *"How visible is keyword.com across ChatGPT and Perplexity this month?"*
- *"Add these 50 keywords to my Acme project, US mobile."*

## How it works

The MCP exposes 67 tools to your AI assistant. When you ask a question, the assistant picks the right tool(s), the MCP fetches the data from Keyword.com, and the assistant frames the answer. Read tools run silently; write tools prompt you for approval before firing.

## Connection details

- **Server URL:** `https://app.keyword.com/mcp` (hosted by Keyword.com)
- **Transport:** Streamable HTTP
- **Authentication:** OAuth 2.0 (browser consent)
- **Tools:** 67 — covering SERP rank tracking, AI Visibility, keyword research, tag management, alerts, Google Places lookups, sharing-link admin, and feedback

No binary to install or update. The MCP server is operated by Keyword.com.

## Authentication

OAuth 2.0. The first tool call opens a browser to a Keyword.com consent page. After approval, a short-lived token is stored in your AI client and auto-refreshes. No API keys to copy or paste.

## Read and write access

Write tools require approval per call from your AI client before they run. **Destructive operations** (`delete_project`, `delete_keywords`) cannot be undone via the MCP — review the plan before approving. `archive_project` is reversible via `restore_project` and is the safer alternative when the user wants to pause tracking.

Keyword.com sees the same scope of data your account has access to. We never see, log, or train on the prompts you send to your AI assistant; we only see the tool calls and respond with the requested data.

## Supported platforms

ChatGPT (via the Keyword.com app, available in the ChatGPT apps directory), Claude Code (CLI), Codex, and Cursor. See [Setup](#mcp/tag/setup) for the ChatGPT app and per-client install snippets. Any other [MCP-compatible client](https://modelcontextprotocol.io/clients) can connect by pointing at the server URL with OAuth.

## Requirements

An active Keyword.com account. The MCP is included with every plan, including the 14-day free trial.

## Support

Email <support@keyword.com>. For programmatic access without an AI client, see the [REST API reference](/docs).