App Store Publisher MCP

MCP server to publish Android apps to Samsung Galaxy Store and Huawei AppGallery straight from AI agents — Claude Code, Claude Desktop, Cursor, VS Code, Google Antigravity, and OpenCode.

Wraps the Samsung Galaxy Store Developer (Seller) API and the Huawei AppGallery Connect API as Model Context Protocol tools, so your AI coding agent can check app status, upload binaries, update store listings, submit apps for review, and verify Samsung IAP receipts — without you ever leaving the editor.

Bonus: docs/app-store-publish-apis.md is a field-tested reference for publishing APIs across 7 stores — Samsung Galaxy Store, Huawei AppGallery, RuStore, Amazon Appstore, vivo, OPPO, and APKPure — including auth flows, endpoints, signing code, and the undocumented gotchas below.

Features

• 🏪 Samsung Galaxy Store Seller API — app list & details, arbitrary Content Publish API calls (binaries, metadata, submission, staged rollout), JWT service-account auth handled for you
• 📱 Huawei AppGallery Connect Publishing API — appid lookup, app info, file upload URLs, submission; supports all three Huawei credential types (Connect API client, service-account key JSON, public API key)
• 🧾 Samsung IAP receipt verification — validate purchase receipt JWTs against your IAP public key
• 🔐 Tokens cached and auto-refreshed; credentials stay in a local .env, never in code
• 🤖 Works with any MCP client: Claude Code, Claude Desktop, Cursor, VS Code, Antigravity, OpenCode

Tools

Tool	What it does
samsung_get_access_token	Create/refresh a Seller API access token (JWT RS256 service account)
samsung_get_app_details	GET /seller/contentInfo for a contentId
samsung_api_request	Any Galaxy Store Developer API request (list apps, add binary, submit, …)
samsung_iap_verify_receipt	Verify a Samsung IAP receipt JWT
appgallery_get_access_token / huawei_get_access_token	Connect API client token (the only token type the Publish API accepts)
appgallery_api_request / huawei_api_request	Any AppGallery Connect API request (/api/publish/v2/*)
huawei_get_service_account_token	JWT-bearer token from a service-account key JSON
huawei_sa_api_request	Call Huawei/AGC service APIs with the service-account token
huawei_public_api_request	Call Huawei public APIs with an API key (key= param)

Quick start

git clone https://github.com/qalvinahmad/app-store-publisher-mcp.git
cd app-store-publisher-mcp
npm install
cp .env.example .env   # fill in your credentials

Claude Code

claude mcp add app-store-publisher -- node /path/to/app-store-publisher-mcp/index.js

Claude Desktop / Cursor (mcp.json)

{
  "mcpServers": {
    "app-store-publisher": {
      "command": "node",
      "args": ["/path/to/app-store-publisher-mcp/index.js"]
    }
  }
}

VS Code (~/Library/Application Support/Code/User/mcp.json)

{
  "servers": {
    "app-store-publisher": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/app-store-publisher-mcp/index.js"]
    }
  }
}

Google Antigravity (~/.antigravity/mcp_config.json)

{
  "mcpServers": {
    "app-store-publisher": {
      "command": "node",
      "args": ["/path/to/app-store-publisher-mcp/index.js"]
    }
  }
}

OpenCode (~/.config/opencode/opencode.jsonc)

{
  "mcp": {
    "app-store-publisher": {
      "type": "local",
      "command": ["node", "/path/to/app-store-publisher-mcp/index.js"],
      "enabled": true
    }
  }
}

Getting credentials

Samsung Galaxy Store — Seller Portal → Assistance → API Service → create a service account (requires commercial seller status). You get a service-account ID and a private key → SAMSUNG_SERVICE_ACCOUNT_ID, SAMSUNG_PRIVATE_KEY.

Huawei AppGallery — AppGallery Connect → Users and permissions → API key → Connect API → create a client with Project = N/A (team-level; anything else returns 403) → APPGALLERY_CLIENT_ID, APPGALLERY_CLIENT_SECRET. Optionally add a service-account key JSON and/or an API key from Console → Credentials.

Gotchas we learned the hard way (all verified against the live APIs)

1. Huawei's Publish API only accepts Connect API client tokens. Service-account (JWT-bearer) tokens are rejected with 205524993 "client token auth failed" — no matter which headers you send.
2. Huawei's client token endpoint wants a JSON body. Sending application/x-www-form-urlencoded fails with an empty error body.
3. Huawei service-account JWTs must be RS256. PS256 (which the JSON key format suggests) is rejected with sub_error 20504.
4. Send both headers on Connect API calls: Authorization: Bearer <token> and client_id: <id>.
5. zod v4 breaks single-argument z.record(). If your MCP server's tools/list dies with Cannot read properties of undefined (reading '_zod'), change z.record(z.any()) to z.record(z.string(), z.any()).
6. Samsung tokens: the Seller API JWT needs scopes: ["publishing", "gss"] and the access token must be sent together with a service-account-id header.

Security

• Credentials live only in .env / the service-account JSON — both are gitignored. Use chmod 600 on them.
• Never put store-publishing credentials in app runtime config; they are deploy-time secrets.
• If a key leaks (chat, screenshot, log), rotate it in the store console.

Related documentation

Full 7-store publishing API reference (RuStore signature auth, Amazon Appstore edit flow, vivo HMAC signing with working code, OPPO and APKPure manual-only notes): docs/app-store-publish-apis.md

License

MIT © Alvin Ahmad