Appstore Rejections MCP

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

This server is built on a database featuring 48 rejection reasons, 51 solutions, 554 real-world cases, and all 130 Apple Review Guideline subsections.

Website • npm • GitHub • Contributing

✨ Features

Tools

📦 Installation

Claude Code (Recommended - Easiest)

Run the following command in your terminal:

claude mcp add --transport stdio appstore-rejections -- npx -y appstore-rejections-mcp

That's it! Reload Claude Code, and the MCP server will auto-connect.

Cursor

Add the following to your Cursor config file:

• macOS/Linux: ~/.cursor/mcp.json
• Windows: %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 the following to your Claude Desktop config:

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

{
  "mcpServers": {
    "appstore-rejections": {
      "command": "npx",
      "args": ["-y", "appstore-rejections-mcp"]
    }
  }
}

💻 Usage Examples

Once connected, your AI assistant can perform the following tasks:

Basic Usage

• 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"

📚 Documentation

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-mcp

Then in Claude Code, ask:

"Check my iOS app for potential App Store rejections"

For Everyone Else

See the Installation section above for Cursor, Claude Desktop, and other setup methods.

🔧 Technical Details

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:

1. Look up guideline 4.3.
2. Find related rejection reasons.
3. Get step-by-step solutions.
4. Show real cases where developers fixed similar issues.
5. 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.

📄 License

This project is licensed under the MIT license. See the LICENSE file for details.

For Developers

Building from Source

git clone https://github.com/RobertoJoseph/appstore-rejections-mcp.git
cd appstore-rejections-mcp
npm install
npm run build

Environment Variables (Optional)

For a custom Supabase instance, set the following environment variables:

SUPABASE_URL=your-url
SUPABASE_ANON_KEY=your-key

See 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

Made with ❤️ for iOS developers everywhere 🚀