HappyKeywords

io.github.yurybreiapps-jpgPublished by GitHub account yurybreiapps-jpgv1.0.0Updated Nov 13, 2026

App Store keyword research (ASO): ranks in 50+ countries, demand, difficulty. Needs the Mac app.

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

App Store keyword research (ASO) from a Mac app: ranks in 50+ countries, keyword demand and difficulty, listing audits and localization.

What you can do
  • Track apps and competitors with daily ranks across 50+ countries
  • Look up estimated demand and difficulty for keywords
  • Run a listing Audit and get prioritized fixes
  • Write and localize name, subtitle and keyword options
  • Upload listing changes to an App Store Connect draft version
  • Explore hot niches and product ideas, with long jobs followed via wait
When to use it
Useful when you market or develop iOS apps and want an assistant to pick keywords, compare ranks across countries, audit a listing, or draft localized metadata without leaving the chat.
Requirements
macOS 14 or later (Apple silicon or Intel) with the HappyKeywords app installed in /Applications; the MCP server runs as a local stdio process started from the app. A 7-day trial or a one-time license is needed for tool calls. App Store Connect access is configured inside the app.
Before you install
Paid after the trial: a one-time license is required for tool calls. Upload tools write to your App Store Connect draft version, though a preview must be approved first and nothing is submitted for review. App Store Connect keys are kept in the macOS Keychain and are not readable by MCP tools.

Installation

In SourceWeft

  1. Open HappyKeywords in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

HappyKeywords MCP server

App Store keyword research (ASO) from your AI agent. Ask Claude Code, Codex, Cursor, Claude or any MCP app which keywords to target, where your app ranks in 50+ countries, and what to fix in your listing.

The MCP server is built into HappyKeywords, a Mac app. This repo holds the setup and the tool list, plus a small bundle that starts the app's server; the app's source isn't here. Docs: https://happykeywords.com/docs/mcp

Watch: a one-minute demo

[Claude Code asks HappyKeywords which App Store keyword to go after next]

Claude Code reads an app's real ranks, demand and difficulty from HappyKeywords and picks the keyword to go after next. Watch on YouTube · Vertical version

What it does

  • Track your apps and competitors in 50+ countries, with daily ranks
  • Estimated demand and difficulty for every keyword (0–100 estimates from App Store search results, not Apple's search counts)
  • An Audit that scores your listing out of 100 and says what to fix first
  • Write and localize name, subtitle and keyword options
  • Upload them into your draft version in App Store Connect: a preview first, Undo after. Nothing is ever submitted for review.
  • Hot niches and product ideas before you build

112 tools. Long jobs run inside the app; the agent follows them with wait.

Requirements

  • macOS 14 or later (Apple silicon or Intel)
  • HappyKeywords in /Applications: download at https://happykeywords.com/?ref=github-mcp
  • 7-day free trial, no card. Then a one-time license ($29 in Early Access). No subscription.
  • Tools list without a license; tool calls need the trial or a license.

Connect

One click: in HappyKeywords, open Settings → AI apps (MCP) and press Add next to your agent.

Claude desktop, as a bundle: download happykeywords.mcpb from the latest release and open it. The bundle only starts the MCP server inside the installed app (source in bundle/).

Or by hand:

Claude Code

sh
claude mcp add-json --scope user happykeywords '{"type":"stdio","command":"/Applications/HappyKeywords.app/Contents/MacOS/HappyKeywords","args":["--mcp"]}'

Codex

sh
codex mcp add happykeywords -- "/Applications/HappyKeywords.app/Contents/MacOS/HappyKeywords" --mcp

Cursor, Claude desktop and other MCP apps (~/.cursor/mcp.json, claude_desktop_config.json)

json
{  "mcpServers": {    "happykeywords": {      "command": "/Applications/HappyKeywords.app/Contents/MacOS/HappyKeywords",      "args": ["--mcp"]    }  }}

Try asking

  • Which of my apps lost ranks since the last check?
  • Where is my app outside the top 10 in Germany, and what would it take to get in?
  • Run the Audit for my app and tell me what to fix first.
  • Write three name and subtitle options, then localize the best one into German and French.
  • Find hot niches in the US App Store and show me product ideas for the best one.

Tools

GroupTools
Apps, keywords and ranks41
App Store Connect5
AI and jobs18
Top earners7
Audit4
Optimize33
Upload4

Full list with inputs: https://happykeywords.com/docs/mcp#tools

Privacy

Everything runs on your Mac. App Store Connect keys stay in the macOS Keychain, and no MCP tool can read them. Uploads happen only after you approve the preview.

Support

https://happykeywords.com/contact

Source: README.md at commit 35c5807

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the package type cannot run in the sandbox.

Version history

1
  1. v1.0.0LatestNov 13, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.