Docs · MCP

Connect Apsity to your AI

Use Apsity tools — keyword search, app lookup, market research — directly inside Claude Desktop, Cursor, Claude Code, or any MCP-compatible client. 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+

Daily 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:

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.”

Multi-region scan

“Search 'budget tracker' across US, JP, and KR using apsity. Compare what types of apps dominate each market and suggest a localization strategy.”

Deep analysis

“Use apsity:keyword_search for 'photo editor' in US. For the Top 5 apps, call apsity:app_lookup and summarize what each app actually does and what feature gaps exist.”

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.