Set up the MCP server

Keywordee includes an MCP server, so AI agents such as Claude or Cursor can research, track and tag keywords for you. It runs on your Mac and works only while Keywordee is open on that Mac. Prefer a terminal? The keywordee command-line tool does the same for your scripts.

1. Turn it on

Open Keywordee › Settings › AI Agents and switch on Let AI agents use Keywordee on this Mac. The status line says whether the server is running. It stays off until you switch it on, and remembers your choice.

Setting	Value
Address	`http://127.0.0.1:7420/mcp`
Token	The connection token in Settings (use Copy)

If something else uses port 7420, type another port (1024 to 65535) in Port and press Return. Regenerate… makes a new token and disconnects every agent using the old one.

Keep the token private: anyone with it can read and change your keywords while Keywordee is running.

2. Connect your agent

Run this in Terminal, with the token from Settings:

claude mcp add --transport http keywordee \
  http://127.0.0.1:7420/mcp \
  --header "Authorization: Bearer <your token>"

In Settings › AI Agents, click Add to Claude Desktop…. Keywordee asks first, then adds a keywordee entry to Claude Desktop’s config file and keeps your other settings. Restart Claude Desktop afterwards.

Claude Desktop starts local servers as commands, so the entry runs npx mcp-remote …. That needs Node.js on your Mac. Your token is stored in that config file: regenerate it in Settings if the file is ever shared, and use Add to Claude Desktop… again to update the entry.

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "keywordee": {
      "url": "http://127.0.0.1:7420/mcp",
      "headers": { "Authorization": "Bearer <your token>" }
    }
  }
}

Any other MCP client works too: point it at http://127.0.0.1:7420/mcp (Streamable HTTP) and set the header Authorization: Bearer <your token>.

More detail: Connect Claude and Connect Cursor.

3. Try it

Ask your agent in plain words. A few to start with:

“Find keyword gems for my habit tracker on iPhone and Android in the UK.”
“Compare popularity and difficulty for ‘meditation’ on the App Store and Google Play in the US.”
“Which of my tracked keywords dropped more than 5 places this week?”
“Suggest 20 keywords for my budgeting app in Germany, and track the best 5.”

Tools your agent can use

Tool	What it does
`list_tracked_apps`	The apps tracked on this Mac, with platform, storefront and keyword count.
`keyword_metrics`	Popularity and difficulty for up to 100 terms in a storefront, on either store, plus your app’s rank.
`rank_history`	How tracked keywords’ rank, popularity and difficulty changed over a number of days.
`suggest_keywords`	Keyword ideas from a seed term and/or a tracked app.
`find_gems`	Untracked keywords that pass your gem rules.
`track_keywords`	Track keywords for an app, optionally with a tag.
`tag_keywords`	Add or remove tags, or replace the note, on tracked keywords.
`export`	Your tracked keywords as JSON or CSV.

The full list, with which tools need an active license, is in the MCP tools reference.