Which integrations are available for this server?

Provides App Store Optimization tools for keyword research, competitor analysis, review sentiment, metadata optimization, and direct management of App Store Connect metadata.

How do I use aso-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@aso-mcp suggest keywords for a meditation app" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

aso-mcp

by KenanAtmaca

Overview Schema Related Servers Score Discussions

TypeScript

Local

ASO MCP Server

npm version License: MIT Node.js MCP

App Store Optimization toolkit for AI assistants. Keyword research, competitor analysis, review sentiment, and metadata optimization. All through the Model Context Protocol.

No API key required. Works out of the box with real App Store data. Supports 155+ countries.

Quick Start

npx aso-mcp

Or install globally:

npm install -g aso-mcp

Related MCP server: mcp-appstore

Why aso-mcp?

20 specialized ASO tools: from keyword discovery and ranking trends to App Store Connect metadata management
Real App Store data: live search results, ratings, reviews, and suggestions
Custom scoring engine: proprietary algorithm independent of Apple Search Ads API issues
No API key needed: zero configuration, install and go
Smart caching: SQLite-backed cache for fast repeated queries
Rate limiting: built-in request management to avoid Apple throttling
Multi-country: analyze keywords across 155+ App Store markets

Integration

Claude Desktop

Add to your config file:

OS	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "aso-mcp": {
      "command": "aso-mcp"
    }
  }
}

{
  "mcpServers": {
    "aso-mcp": {
      "command": "npx",
      "args": ["tsx", "/ABSOLUTE/PATH/TO/aso-mcp/src/server.ts"],
      "cwd": "/ABSOLUTE/PATH/TO/aso-mcp"
    }
  }
}

Claude Code

claude mcp add -s user aso-mcp -- npx aso-mcp

Other MCP Clients

Any MCP-compatible client (ChatGPT, Cursor, Windsurf, etc.) can connect via stdio transport. Point it to the aso-mcp command.

Tools

Phase 1: Keyword Research

Tool	Description
`search_keywords`	Traffic/difficulty scores + top-ranking apps for a keyword
`suggest_keywords`	Keyword suggestions by app ID (category, similar, competition strategies)
`get_app_details`	Full ASO info for an app + metadata analysis

Phase 2: Competitor Analysis & Optimization

Tool	Description
`analyze_competitors`	Metadata comparison of top apps for a keyword + keyword gap
`optimize_metadata`	Title/subtitle/keyword field suggestions with character limit checks
`analyze_reviews`	Sentiment analysis, complaint and feature request extraction
`track_ranking`	App's ranking position across multiple keywords (each run saves a local snapshot)
`get_ranking_history`	Position trends over time from saved snapshots: daily positions, change, improving/declining per keyword
`keyword_gap`	Keyword difference between two apps + opportunity analysis

Phase 3: Localization & Reporting

Tool	Description
`localized_keywords`	Keyword performance comparison across different countries
`get_aso_report`	Comprehensive ASO report: scores + competitors + reviews in one call

Phase 4: ASO Generation

Tool	Description
`discover_keywords`	Keyword discovery from scratch for a new app
`generate_aso_brief`	Complete ASO brief with keyword pool, competitor patterns, and metadata suggestions

Phase 5: App Store Connect

Directly read and update your app's metadata on App Store Connect without leaving the AI assistant.

Tool	Description
`connect_setup`	Configure & validate App Store Connect API credentials
`connect_get_app`	Find app by bundle ID, get ASC ID + version status
`connect_get_metadata`	Read current metadata (title, subtitle, keywords, description) for a locale
`connect_update_metadata`	Update metadata with character limit validation + before/after diff
`connect_batch_update_metadata`	Batch update metadata for multiple locales in one call (max 40 locales)
`connect_list_localizations`	List all locales and metadata completeness status

Requires an App Store Connect API Key:

Option A: Environment variables

export ASC_ISSUER_ID="your-issuer-id"
export ASC_KEY_ID="your-key-id"
export ASC_PRIVATE_KEY_PATH="/path/to/AuthKey_XXXXX.p8"

Option B: Use the setup tool

"Set up App Store Connect with issuer ID xxx, key ID yyy, and key at /path/to/AuthKey.p8"

Credentials are saved to ~/.aso-mcp/connect-config.json for future sessions.

Utility

Tool	Description
`clear_cache`	Clears the local data cache for fresh App Store results

Usage Examples

Just ask your AI assistant naturally:

"How competitive is the 'fitness' keyword in the US?"

"Analyze Spotify's competitors and find keyword opportunities"

"Generate an ASO report for com.spotify.client"

"Compare 'music' and 'podcast' keywords across US, UK, and DE markets"

"Do a keyword gap analysis: Spotify vs Apple Music"

"Analyze Shazam's user reviews"

"Suggest title and subtitle for my fitness app targeting: workout, training, exercise"

"Discover keywords for a new calorie tracking app"

"Update my app's subtitle to 'AI Workout Planner' on App Store Connect"

"Show all locales and metadata status for my app"

Scoring Algorithm

The server calculates its own scores, independent of Apple Search Ads API:

Score	Description
Visibility	Based on rating, review count, and ranking position
Competitive	Difficulty derived from the strength of top-ranking apps
Opportunity	High traffic + low difficulty = high opportunity
Overall	Weighted combination of all scores (0-10)

When the aso npm package fails to reach Apple (503 errors), the server automatically falls back to custom scoring using search result analysis. Scores are always available.

Development

git clone https://github.com/kenanatmaca/aso-mcp.git
cd aso-mcp
npm install

npm run dev          # Run with tsx (development)
npm run build        # Compile TypeScript
npm run inspect      # MCP Inspector UI

# Tests
npx tsx test.ts              # Core tests (17)
npx tsx test-phase3.ts       # Localization & report tests (4)
npx tsx test-generation.ts   # ASO generation tests (8)

Tech Stack

TypeScript + Node.js 22+
MCP SDK: Model Context Protocol
app-store-scraper: App Store data
aso: ASO scoring with automatic fallback
better-sqlite3: Cache layer
Zod: Schema validation

License

MIT

Author

Kenan Atmaca

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/KenanAtmaca/aso-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server