# HappyKeywords

> HappyKeywords is an MCP server for marketing and seo. App Store keyword research and listing audits from an agent, via a Mac app. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** macOS
- **Website:** https://happykeywords.com/docs/mcp
- **Repository:** https://github.com/yurybreiapps-jpg/happykeywords-mcp
- **MCP Registry name:** io.github.yurybreiapps-jpg/happykeywords
- **Categories:** marketing and SEO
- **Listing updated:** 2026-11-14

## About

HappyKeywords is a Mac ASO app, and its MCP server is built into it, so the agent works with the data stored on your machine. The README counts 112 tools in groups such as apps, keywords and ranks (41), Optimize (33), AI and jobs (18), top earners (7), App Store Connect (5), Audit (4) and Upload (4). Long jobs run inside the app, and the agent follows them with `wait`.

An agent can track apps, check ranks in 50 or more countries, run the Audit that scores a listing and what to fix first, write and localize name, subtitle and keyword options, and upload them into a draft version in App Store Connect with a preview first and Undo after. Nothing is ever submitted for review. App Store Connect keys stay in the macOS Keychain and no tool can read them.

It needs the app installed in /Applications and macOS 14 or later. Tools list without a license, but calls need the 7-day free trial or a license; early access is a $29 one-time payment, rising on fixed dates. Setup is one click in Settings or a command for Claude Code, Codex or Cursor.

## Features

- **Rank checks:** Track where an app ranks across 50 or more countries.
- **Listing audit:** Score a listing and see what to fix first.
- **Optimize drafts:** Write name, subtitle and keyword options and localize them.
- **Safe upload:** Preview, upload into a draft version, then Undo; never submits for review.
- **Local data:** Everything runs on your Mac with keys held in the Keychain.
- **112 tools:** Covers keywords, ranks, top earners, audit, optimize and upload.

## Good for

- Find which keywords an app lost ranks on
- Decide the next keyword to target
- Write and localize App Store metadata in German and French
- Find hot niches and product ideas in a country store

## Install

### Claude Code (Terminal)

```sh
claude mcp add happykeywords -- npx -y https://github.com/yurybreiapps-jpg/happykeywords-mcp/releases/download/v1.0.0/happykeywords.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "happykeywords": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/yurybreiapps-jpg/happykeywords-mcp/releases/download/v1.0.0/happykeywords.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "happykeywords": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/yurybreiapps-jpg/happykeywords-mcp/releases/download/v1.0.0/happykeywords.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "happykeywords": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/yurybreiapps-jpg/happykeywords-mcp/releases/download/v1.0.0/happykeywords.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "happykeywords": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/yurybreiapps-jpg/happykeywords-mcp/releases/download/v1.0.0/happykeywords.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "happykeywords": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/yurybreiapps-jpg/happykeywords-mcp/releases/download/v1.0.0/happykeywords.mcpb"
      ]
    }
  }
}
```

## Tools

- `audit_get`: Reads an app's Audit score and findings.
- `listing_get`: Reads an app's current store listing.

## FAQ

### What does it cost?

A 7-day free trial with no card, then a one-time license; early access is $29 with no subscription.

### Does it submit my app for review?

No. Uploads go into a draft version and nothing is ever submitted for review.

### What do I need?

macOS 14 or later and the HappyKeywords app in /Applications.

### Where are my keys kept?

App Store Connect keys stay in the macOS Keychain, and no MCP tool can read them.

### Is HappyKeywords free?

HappyKeywords is a paid product with a free trial.

### How do I add HappyKeywords to Claude Code?

Run this command in your terminal: claude mcp add happykeywords -- npx -y https://github.com/yurybreiapps-jpg/happykeywords-mcp/releases/download/v1.0.0/happykeywords.mcpb

### What are the best alternatives to HappyKeywords?

The closest alternatives to HappyKeywords are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and ASOScan.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [ASOScan](https://ai-powered.com/mcp/asoscan): ASOScan is an MCP server for marketing and seo.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Daniels AI Design Studio](https://ai-powered.com/mcp/daniels-ai-design-studio): Daniels AI Design Studio is an MCP server for design and media.

---
Source: https://ai-powered.com/mcp/happykeywords
