Skip to main content
Glama
appstore-rejections-mcp

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.

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

search_rejections

Semantic search — paste Apple's rejection message or describe the issue

get_rejection_reason

Full details for a specific rejection reason (Apple's message, tags, categories)

get_solutions

Step-by-step fixes with code examples, difficulty, and success rates

get_guideline

Look up Apple Review Guidelines by number (e.g. 2.1, 4.3, 5.1.1)

list_common_rejections

Top rejection reasons ranked by frequency

get_cases

Real-world cases filtered by reason, app category, or appeal status

Related MCP server: App Store Connect MCP Server

Installation

Run this 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 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 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:

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

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

  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


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 custom Supabase instance:

SUPABASE_URL=your-url
SUPABASE_ANON_KEY=your-key

See CONTRIBUTING.md for more details.


Community


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 tools
get_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

    A4.2/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      An 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.
      7
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      An unofficial MCP server for the App Store Connect API that enables automation of app management, reviews, TestFlight, analytics, and release processes through natural language.
      63
      431 npm
      2
      MIT