Docs · MCP

Connect Apsity to your AI

Bring Apsity into Claude Desktop, Cursor, Claude Code, or any MCP-compatible client — ask about your revenue, reviews, keyword rankings, and competitor moves in plain English, plus run public App Store research. Available on Starter and Pro plans.

1. What is MCP?

Model Context Protocol is an open standard from Anthropic that lets AI assistants call external tools. With Apsity's MCP server, you can ask Claude to search the App Store, analyze competitors, and brainstorm new app ideas — all grounded in live data, no copy-pasting required.

Think of it as giving Claude direct read access to Apsity's analytics, secured by an API key tied to your subscription.

2. Available tools

Tool	Description	Plan
keyword_search	Search any keyword for Top 50 apps in 20 countries	STARTER+
app_lookup	Full metadata for a specific app (description, screenshots, etc.)	STARTER+
list_supported_countries	20 supported country codes for multi-region searches	STARTER+
keyword_search_history	Recent unique keywords + countries you've searched	STARTER+
list_my_apps	List your Apsity-connected apps (entry point for other tools)	STARTER+
get_revenue	Revenue summary + daily series for an app or all apps (USD)	STARTER+
get_downloads	Pure download counts (excludes redownloads, IAP, subs)	STARTER+
get_country_breakdown	Downloads + revenue per country, top 30	STARTER+
revenue_compare	Compare two equal-length periods (e.g. this week vs last)	STARTER+
get_keyword_rankings	Tracked keyword ranks with recent history	STARTER+
list_my_keywords	Compact list of every tracked keyword + latest rank	STARTER+
get_reviews	Recent reviews + sentiment stats (filter by rating/sentiment)	STARTER+
summarize_reviews	Curated negative/positive/low-rated buckets for fast triage	STARTER+
list_my_competitors	List tracked competitor apps with rating + version	STARTER+
get_competitor_rankings	Competitor keyword ranks (by keyword+country)	STARTER+
get_meta_changes	Competitor metadata change log (name/subtitle/icon/version)	STARTER+
get_subscription_trend	Active subscriber daily series (for subscription apps)	STARTER+
get_growth_insights	AI-generated insights produced by Apsity crons	STARTER+
get_plan_usage	Current plan limits and consumption (apps, keywords, etc.)	STARTER+

All tools require STARTER or PRO. Daily public keyword search limits: STARTER 100/day · PRO unlimited.

3. Issue an API key

Sign in to Apsity and go to Settings.
Scroll to MCP API Keys.
Enter a name (e.g. claude-desktop) and click Generate.
Copy the key starting with ask_ immediately — it's only shown once.

Note: If you're on the Free plan, key issuance is allowed but tool calls will return 401. Upgrade to Starter or Pro to actually use the MCP server.

4. Claude Desktop

Edit your config file. Path:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this entry inside mcpServers:

{
  "mcpServers": {
    "apsity": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://apsity.com/api/mcp/mcp",
        "--header",
        "Authorization: Bearer ask_YOUR_KEY"
      ]
    }
  }
}

Save the file, then fully quit and restart Claude Desktop (Cmd+Q on Mac). The Apsity tools will appear under the tools menu in any new conversation.

5. Claude Code (CLI)

One-liner to register:

claude mcp add apsity \
  https://apsity.com/api/mcp/mcp \
  --transport http \
  -H "Authorization: Bearer ask_YOUR_KEY"

Verify with claude mcp list. Inside Claude Code, type /mcp to see the connected server.

6. Cursor & other clients

Cursor and other Streamable-HTTP-capable clients can connect directly without mcp-remote:

{
  "mcpServers": {
    "apsity": {
      "url": "https://apsity.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer ask_YOUR_KEY"
      }
    }
  }
}

7. Example prompts

Once connected, try these in your AI client:

Weekly review

“Using apsity, pull last week's revenue and downloads for all my apps and compare them to the prior week. Flag any app with a >20% drop and dig into the country breakdown.”

Review triage

“Call apsity:summarize_reviews for the past 30 days. Group the negative themes, then propose 3 product changes that would address the top cluster.”

Competitor watch

“Use apsity:get_meta_changes for the last 14 days. For each rival that changed subtitle or screenshots, summarize what they shifted and whether it aligns with a feature push.”

Keyword health

“Run apsity:get_keyword_rankings. List keywords whose rank dropped 5+ positions in the last week, then suggest replacements via apsity:keyword_search.”

Discovery

“Use apsity to search for 'meditation' in the US App Store. Show me the Top 50 apps and group them by category. Identify 3 underserved niches.”

Idea generation

“Help me brainstorm 5 new app ideas for indie iOS developers. Use apsity to validate each idea against current App Store competition. Be ruthless about saturation.”

8. Troubleshooting

The tool returns 401 Unauthorized: Either the key is wrong/expired, or your account is on the Free plan. MCP requires Starter or higher. Verify the key in Settings; upgrade if needed.
Tools don't appear in Claude Desktop: Cmd+Q to fully quit Claude Desktop, then re-open. Settings changes only apply on restart.
'Daily search limit reached': Starter plan is 100 searches/day. Pro is unlimited. Resets at 00:00 UTC. Upgrade to Pro on the Plan page.
Connection refused / fetch failed: Check that you're using https://apsity.com/api/mcp/mcp (the trailing /mcp is required). For local development, use http://localhost:3000/api/mcp/mcp instead.
Can I revoke a key?: Yes — Settings → MCP API Keys → Revoke. The key stops working immediately on the next request.