appstore-rejections-mcp
Provides tools for searching and retrieving Apple App Store rejection reasons, solutions, guidelines, and real-world cases.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@appstore-rejections-mcp How do I fix an App Store rejection for missing privacy policy?"
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.
appstore-rejections-mcp
An MCP (Model Context Protocol) server that gives AI assistants access to a curated database of Apple App Store rejection reasons, solutions, and real-world cases.
Built on a database of 48 rejection reasons, 51 solutions, 554 real-world cases, and all 130 Apple Review Guideline subsections.
Website • npm • GitHub • Contributing
Tools
Tool | Description |
| Semantic search — paste Apple's rejection message or describe the issue |
| Full details for a specific rejection reason (Apple's message, tags, categories) |
| Step-by-step fixes with code examples, difficulty, and success rates |
| Look up Apple Review Guidelines by number (e.g. |
| Top rejection reasons ranked by frequency |
| Real-world cases filtered by reason, app category, or appeal status |
Related MCP server: App Store Connect MCP Server
Installation
Claude Code (Recommended - Easiest)
Run this command in your terminal:
claude mcp add --transport stdio appstore-rejections -- npx -y appstore-rejections-mcpThat's it! Reload Claude Code and the MCP server will auto-connect.
Cursor
Add to your Cursor config file:
macOS/Linux:
~/.cursor/mcp.jsonWindows:
%APPDATA%\Cursor\mcp.json
{
"mcpServers": {
"appstore-rejections": {
"command": "npx",
"args": ["-y", "appstore-rejections-mcp"]
}
}
}Save the file, restart Cursor, and it will auto-connect.
Claude Desktop (Legacy - Global)
Add to your Claude Desktop config:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"appstore-rejections": {
"command": "npx",
"args": ["-y", "appstore-rejections-mcp"]
}
}
}Usage Examples
Once connected, your AI assistant can:
Search for a rejection reason:
"My app was rejected for guideline 4.3, what does that mean?"
Get solutions:
"How do I fix an App Store rejection for missing privacy policy?"
Review your app before submission:
"Review my iOS app codebase for potential App Store rejections"
Look up guidelines:
"What does Apple guideline 5.1.1 say?"
Find real-world cases:
"Show me cases where Finance apps were rejected and the developer appealed"
Data Coverage
48 documented rejection reasons with Apple's actual message templates
51 solutions with implementation steps and code examples
554 real-world cases sourced from Reddit, Stack Overflow, Apple Forums, and developer blogs
130 Apple Review Guideline subsections across all 5 sections
50 app categories tracked
Semantic search powered by pgvector embeddings
Requirements
Node.js >= 18
Quick Start
For Claude Code Users
claude mcp add --transport stdio appstore-rejections -- npx -y appstore-rejections-mcpThen in Claude Code, ask:
"Check my iOS app for potential App Store rejections"
For Everyone Else
See Installation section above for Cursor, Claude Desktop, and other setup methods.
Real-World Example
User asks Claude Code:
"My iOS app was rejected for guideline 4.3. What does that mean and how do I fix it?"
Claude uses the MCP tools to:
Look up guideline 4.3
Find related rejection reasons
Get step-by-step solutions
Show real cases where developers fixed similar issues
Provide code examples and best practices
How It Works
The MCP server connects your AI assistant to:
48 Rejection Reasons - Apple's actual rejection messages and patterns
51 Solutions - Step-by-step fixes with difficulty ratings
554 Real Cases - Community experiences and appeals
130 Guidelines - Full Apple Review Guideline subsections
Semantic Search - Powered by vector embeddings for smart matching
For Developers
Building from Source
git clone https://github.com/RobertoJoseph/appstore-rejections-mcp.git
cd appstore-rejections-mcp
npm install
npm run buildEnvironment Variables (Optional)
For custom Supabase instance:
SUPABASE_URL=your-url
SUPABASE_ANON_KEY=your-keySee CONTRIBUTING.md for more details.
Community
Found a bug? Open an issue
Have an idea? Start a discussion
Want to contribute? See CONTRIBUTING.md
Questions? Email: roberto.josephselim@gmail.com
Changelog
v1.0.2 - Cleaned up README, clearer installation instructions v1.0.1 - Fixed invalid API key error v1.0.0 - Initial release
Built By
Roberto Joseph - LinkedIn • Twitter • TikTok
License
MIT - See LICENSE file for details
Made with ❤️ for iOS developers everywhere 🚀
Available Tools
6 toolsget_casesGet Real-World Rejection CasesA
Get real-world App Store rejection cases from developers who experienced them. Filter by rejection reason, app category, or appeal status. Cases include the developer's message, Apple's response, and resolution.
Inputs: limit, app_category, was_appealed, rejection_reason_id.
get_guidelineGet Apple Review GuidelineA
Look up a specific Apple App Store Review Guideline by section or subsection number. Examples: '2.1', '4.3', '5.1.1'. Returns the guideline text and any related rejection reasons.
Inputs: guideline_number (required).
get_rejection_reasonGet Rejection Reason DetailsA
Get full details about a specific App Store rejection reason including Apple's message template, affected categories, guideline reference, and tags. Use search_rejections first to find the ID.
Inputs: id (required).
get_solutionsGet Solutions for RejectionA
Get all solutions for a specific App Store rejection reason. Returns step-by-step fixes with implementation details, code examples, difficulty level, and success rates.
Inputs: rejection_reason_id (required).
list_common_rejectionsList Common App Store RejectionsA
List the most common App Store rejection reasons, sorted by frequency. Useful for understanding what reviewers look for most.
Inputs: limit.
search_rejectionsSearch App Store RejectionsA
Search for App Store rejection reasons using natural language. Paste Apple's rejection message or describe the issue. Returns matching rejection reasons ranked by relevance with solutions.
Inputs: query (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clear primary purpose, and the descriptions are specific enough to avoid major selection errors. Some overlap exists because search_rejections also returns solutions, which could make get_solutions seem redundant, and list_common_rejections overlaps slightly with search_rejections.
Tool names consistently follow a verb_noun snake_case pattern using get, search, and list as actions. This is predictable and makes the toolset easy for an agent to navigate.
Six tools is well-scoped for a specialized App Store rejection knowledge base. There are no redundant tools, and the count feels appropriate for the domain's read-only reference purpose.
The toolset covers the full reference workflow: searching rejection reasons, retrieving detailed reasons, accessing solutions, looking up guidelines, listing common rejections, and exploring real cases. No significant dead ends or missing core operations are apparent for a read-only reference server.
Maintenance
Related MCP Connectors
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Hosted iOS app intelligence and creative research MCP server.
MCP server for building and testing AI agents with multi-model experimentation and insights.
Related MCP Servers
- AlicenseAqualityNot gradedmaintenanceAn intelligent MCP server that serves as a guardian of development knowledge, providing AI assistants with curated access to latest documentation and best practices.41MIT
- AlicenseAqualityFmaintenanceAn MCP server that gives AI assistants structured access to App Store Connect data. Built for ASO analysis, download tracking, and performance monitoring.71MIT
- AlicenseAqualityCmaintenanceAn open-source MCP server for live Apple App Store competitor research, enabling AI agents to search apps, fetch metadata, compare competitors, and retrieve reviews and top charts as structured JSON.7MIT
- AlicenseBqualityCmaintenanceAn unofficial MCP server for the App Store Connect API that enables automation of app management, reviews, TestFlight, analytics, and release processes through natural language.63431 npm2MIT