Pgyer MCP

Upload apps, look up apps and historical builds, set the latest build, and change app settings from any AI client that supports the Model Context Protocol.

The Model Context Protocol (MCP) is an open protocol that lets AI assistants call external tools through a standard interface. Pgyer's MCP server comes with the official command-line tool @pgyer/cli (the pgyer mcp command). It exposes uploading apps and looking up apps and historical builds as MCP tools, which you can call in natural language from Claude Code, Claude Desktop, Cursor, VS Code, Codex, and other clients.

Source code and full documentation: PGYER/pgyer-cli.

For help choosing between the API, CLI, CI/CD plugins, MCP, and Agent Skill, see Automated App Uploads and CI/CD Integration.

Prerequisites

Node.js 20.19 or later (required by npx).
Your Pgyer API key, shown on the API information page. Accounts that have not completed real-name verification must do so first.

Client Configuration

The configurations below start the server with npx -y @pgyer/cli mcp, so nothing needs to be installed first. If you have installed the CLI globally and run pgyer auth login, you can use pgyer mcp instead and leave out PGYER_API_KEY.

Claude Code

claude mcp add pgyer --env PGYER_API_KEY=YOUR_API_KEY -- npx -y @pgyer/cli mcp

Claude Desktop and Cursor

Add this to Claude Desktop's claude_desktop_config.json or Cursor's ~/.cursor/mcp.json:

{
  "mcpServers": {
    "pgyer": {
      "command": "npx",
      "args": ["-y", "@pgyer/cli", "mcp"],
      "env": {
        "PGYER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Codex

codex mcp add pgyer --env PGYER_API_KEY=YOUR_API_KEY -- npx -y @pgyer/cli mcp

For VS Code and other clients, see the CLI documentation.

Existing configurations that run npx -y pgyer-mcp-server start the same server and keep working.

Tools

Tool	What it does
`upload_app`	Uploads an `.apk`, `.ipa`, or `.hap` build with optional release notes, install type, password, install period, and channel, and returns the download page and QR code
`get_upload_status`	Checks the publishing progress of a build key
`list_apps`	Lists the apps in your account
`get_app`	Shows an app's details by App Key or short link
`list_versions`	Lists an app's historical builds
`set_latest_version`	Sets or clears the build shown on the download page
`update_app_settings`	Changes app settings, with an optional preview of the change

The server has no delete tool and never returns install passwords. Tools that change data are marked as such, so clients usually ask you to confirm before calling them.

Example

Once configured, describe the task in natural language, for example:

Example prompt

Upload app/build/outputs/apk/release/app-release.apk to Pgyer with the release notes "Fixed the login crash", using password install with the password 123456.

The assistant calls upload_app and returns the download page and QR code.