AppInsight (App Store / Play Store) MCP server for AI agents

App Market Intelligence MCP provides comprehensive market intelligence by analyzing data from both the Apple App Store and Google Play Store. This server gives you insights about apps, market trends, competitors, and user feedback across major mobile app marketplaces through a Model Context Protocol (MCP) interface.

Installation Options

Using NPX

The simplest way to install and run the MCP server is using NPX:

npx -y @jeromyfu/app-insight-mcp

Using Smithery

To install App Market Intelligence for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @JiantaoFu/appinsightmcp --client claude

Using Docker

You can also run the server using Docker:

docker run -i --rm app-insight-mcp

If you need to build the Docker image first:

docker build -t app-insight-mcp -f Dockerfile .

Configuration

Claude Desktop Configuration

To add this MCP server to Claude Desktop, modify your claude_desktop_config.json file:

NPX Configuration

{
  "mcpServers": {
    "app-insight-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@jeromyfu/app-insight-mcp"
      ]
    }
  }
}

Docker Configuration

{
  "mcpServers": {
    "app-insight-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "app-insight-mcp"
      ]
    }
  }
}

Available Tools

App Store Tools

app-store-details: Get detailed information about an App Store app
app-store-list: Retrieve apps from iTunes collections
app-store-search: Search for apps on the App Store
app-store-developer: Get apps by a developer
app-store-privacy: Get privacy details for an app
app-store-suggest: Get search suggestions
app-store-similar: Get similar apps
app-store-reviews: Get app reviews
app-store-ratings: Get app ratings
app-store-version-history: Get app version history

Google Play Tools

google-play-details: Get detailed app information
google-play-list: Retrieve apps from collections
google-play-search: Search for apps
google-play-developer: Get apps by developer
google-play-suggest: Get search suggestions
google-play-reviews: Get app reviews
google-play-similar: Get similar apps
google-play-permissions: Get app permissions
google-play-datasafety: Get data safety information
google-play-categories: Get list of categories

Usage Examples

Starting the Server Manually

If you've cloned the repository, you can start the server with:

node src/server.js

Using the Tools

Each tool is invoked by passing a JSON object with a name and params fields. Here are some examples:

Get Top Free iOS Apps

{
  "name": "app-store-list",
  "params": {
    "collection": "topfreeapplications",
    "num": 10
  }
}

Get Top Paid Android Games

{
  "name": "google-play-list",
  "params": {
    "collection": "TOP_PAID",
    "category": "GAME",
    "num": 10
  }
}

Testing

Test with MCP Inspector

To test the server with MCP Inspector:

npm run test:inspector

Test with mcp-cli

To test with mcp-cli:

npx @wong2/mcp-cli npx -y "app-insight-mcp"

Error Handling

All tools include robust error handling and will return appropriate error messages if:

Required parameters are missing
API calls fail
Rate limits are hit
Invalid IDs or parameters are provided

Your requests will receive clear feedback when issues arise, making it easier to troubleshoot problems.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "app-insight-mcp" '{"command":"npx","args":["-y","@jeromyfu/app-insight-mcp"]}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "app-insight-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@jeromyfu/app-insight-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

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

2. Add this to your configuration file:

{
    "mcpServers": {
        "app-insight-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@jeromyfu/app-insight-mcp"
            ]
        }
    }
}

3. Restart Claude Desktop for the changes to take effect