# PGYER

> PGYER is an open-source MCP server for developer tools. Upload Android, iOS and HarmonyOS builds to PGYER and manage versions from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, iOS, Android, API
- **Website:** https://www.pgyer.com
- **Repository:** https://github.com/pgyer/pgyer-mcp-server
- **MCP Registry name:** io.github.PGYER/pgyer-mcp-server
- **Categories:** developer tools
- **Listing updated:** 2026-11-15

## About

PGYER, also known as Pugongying, is a beta app distribution service popular in China, and this server brings its upload and version management into an assistant. From version 2.0 the npm package is only a launcher: the server itself comes from PGYER's @pgyer/cli through `pgyer mcp`, with identical tools.

upload_app sends an .apk, .ipa or .hap file, waits for processing and returns the download page, QR code and version, with options for install method, password, update notes, validity period and short link. get_upload_status checks a build after a timeout, while list_apps, get_app and list_versions read apps and history. set_latest_version and update_app_settings change existing state, and update_app_settings supports a dry run.

There are no tools to delete apps or versions, and install passwords are never returned. You need Node.js 20.19 or newer and an API key from your account, set as PGYER_API_KEY. The README advises raising Codex's 60 second tool timeout for large uploads. The package is MIT licensed, and the README is in Chinese.

## Features

- **Upload builds:** Sends APK, IPA or HAP files and returns download page, QR code and version.
- **Browse apps and versions:** Lists apps with latest versions and pages through history.
- **Version flagging:** Sets or clears the latest-version marker.
- **Settings update with dry run:** Changes short link, install method, password and validity while leaving other settings alone.
- **No destructive tools:** Nothing deletes apps or versions, and passwords are not returned.

## Good for

- Ship a nightly Android build to testers from a chat
- Check which version is marked latest
- Change an app's install password and expiry
- Look up a download page from its short link

## Install

### Claude Code (Terminal)

```sh
claude mcp add pgyer-mcp-server --env PGYER_API_KEY='<PGYER_API_KEY>' -- npx -y pgyer-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pgyer-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "pgyer-mcp-server"
      ],
      "env": {
        "PGYER_API_KEY": "<PGYER_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pgyer-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "pgyer-mcp-server"
      ],
      "env": {
        "PGYER_API_KEY": "<PGYER_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pgyer-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pgyer-mcp-server"
      ],
      "env": {
        "PGYER_API_KEY": "<PGYER_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pgyer-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "pgyer-mcp-server"
      ],
      "env": {
        "PGYER_API_KEY": "<PGYER_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pgyer-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "pgyer-mcp-server"
      ],
      "env": {
        "PGYER_API_KEY": "<PGYER_API_KEY>"
      }
    }
  }
}
```

## Tools

- `upload_app`: Uploads an .apk, .ipa or .hap file and returns the download page, QR code and version.
- `get_upload_status`: Checks the processing result of an upload by build key.
- `list_apps`: Lists apps in the account with their latest versions.
- `get_app`: Returns details of an app by key or short link.
- `list_versions`: Lists the version history of an app.
- `set_latest_version`: Sets or clears the latest-version marker on a version.
- `update_app_settings`: Changes app settings such as short link, install method and validity, with a dry-run option.

## FAQ

### What do I need?

Node.js 20.19 or newer and a PGYER API key from the account API page.

### Which file types can I upload?

Android .apk, iOS .ipa and HarmonyOS .hap.

### Can it delete an app?

No. There is no delete tool.

### What licence is it under?

MIT.

### Is PGYER free?

Yes. PGYER is open source, so you can use and self-host it for free.

### How do I add PGYER to Claude Code?

Run this command in your terminal: claude mcp add pgyer-mcp-server --env PGYER_API_KEY='<PGYER_API_KEY>' -- npx -y pgyer-mcp-server

### What are the best alternatives to PGYER?

The closest alternatives to PGYER are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/pgyer
