PubShip
OfficialProvides tools for Google Play developer workflows, allowing inspection of releases, reviews, Android vitals, and scoped bulk reports, and preparing explicitly authorized changes to apps in Google Play Console.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PubShip show me the latest production release for com.example.app"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PubShip
Google Play developer workflows, from your own computer. Inspect releases, understand reviews and reports, and prepare explicitly authorized changes from your MCP client.
Start locally
Use your own service account with permissions for your apps in Play Console. Keep its private JSON outside this repository. Grant only the permissions needed for your intended operations. Never paste credentials into an assistant conversation.
export GOOGLE_APPLICATION_CREDENTIALS=/absolute/private/path/service-account.json
export GOOGLE_PLAY_PACKAGES=com.example.app
uvx pubshipThis starts the stdio server, which waits for an MCP client. For a credential-free installation check:
uvx pubship --checkThe commands above install the published PyPI package. A source checkout may contain changes that are not yet published; after uv sync, use uv run pubship --check to check the local version.
Related MCP server: google-cloud-mcp
Connect an assistant
Claude Code
claude mcp add --transport stdio pubship -- uvx pubshipSet the environment variables above in the shell launching your client. Restart the client after changing its environment.
Codex
codex mcp add pubship -- uvx pubshipCursor and Gemini CLI
Client manifests in this repository declare the local service-account key path and package names. See client setup for configuration and the Gemini CLI installation command. For agent-assisted installation, read llms-install.md. Provide only the key file path, never its contents.
Generic MCP harness
Configure a stdio server with executable uvx, argument pubship, and your local environment. For clients that require explicit configuration:
{
"mcpServers": {
"pubship": {
"command": "uvx",
"args": ["pubship"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/absolute/private/path/service-account.json",
"GOOGLE_PLAY_PACKAGES": "com.example.app"
}
}
}
}Client configuration stays on your computer. Consult setup for alternate authentication modes, enabled APIs, reports and permission boundaries.
What can it do?
The pinned inventory contains 172 method definitions. 170 have implementations, one subscription-archive method is unsupported by Google, and voided-purchases access is deliberately disabled by project policy. Disabled operations cannot be called through local or self-host tools.
Read releases, reviews, Android vitals and scoped bulk reports.
Inspect catalog, subscription, product and account resources with separate sensitive-data grants.
Prepare and review writes with explicit app/method permissions and single-use execution.
Keep local file transfers bounded and separate publication from edit staging.
Reads are the default. Optional writes and sensitive reads require explicit configuration. Provider text is untrusted data. Missing data is not zero; a submitted change is not necessarily published. No operation count is a claim of live Google verification.
Self-hosting for your own accounts
pubship-server retains the HTTP implementation for infrastructure you control. It refuses to start without PUBSHIP_SERVER_ALLOWED_EMAILS. Sign-in requires a signed Google ID token, a verified exact email match and nonce binding before any Google credentials are persisted. Removing an account from the allowlist invalidates its stored grants on next use. Legacy grants without verified identity must reconnect. Enrollment stays closed until the operator explicitly enables it.
There is no project-run Google-connected service. See the local-first decision and self-host setup.
Release notes
PubShip 0.24.2 improves tool descriptions and approval hints, and checks the same definitions across source and packaged installs. See the changelog for earlier versions. Source versions can precede package publication.
Development
Tool definition quality documents the TDQS 1.2 offline checks, reviewed heuristic findings and MCP contract regression coverage. Offline lint is not a model-scored grade.
env -u GOOGLE_APPLICATION_CREDENTIALS uv sync --frozen --all-extras --group browser --group tdqs
env -u GOOGLE_APPLICATION_CREDENTIALS uv run --frozen --all-extras --group browser --group tdqs pytest
env -u GOOGLE_APPLICATION_CREDENTIALS uv run ruff check .
env -u GOOGLE_APPLICATION_CREDENTIALS uv run ruff format --check .
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/generate_catalog.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/generate_verification.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/distribution_metadata.py --check
env -u GOOGLE_APPLICATION_CREDENTIALS uv build
env -u GOOGLE_APPLICATION_CREDENTIALS uv run python scripts/check_artifacts.pyTests use fake providers. Browser tests require installed Playwright engines; backup integration tests require age. Record unavailable platform checks honestly. See contribution policy, release process, and security reporting.
Intended use
PubShip helps developers automate their own Google Play distribution work. It runs on your computer or on infrastructure you control, with your own Google credentials and Play Console permissions. The PubShip project does not run a hosted service and never receives your credentials. Use it only for apps and developer accounts that you or your organization own, and follow Google's Play Developer API Terms. Hosted PubShip instances run by others are not provided or endorsed by the PubShip project.
PubShip is an independent open-source project and is not affiliated with, endorsed by, or sponsored by Google. Google, Google Play and Android are trademarks of Google LLC.
License
PubShip is free software under the GNU Affero General Public License v3.0 only (AGPL-3.0-only). Copyright (C) 2026 Denys Vorobyov. For other license terms, contact legal@pubship.dev.
Available Tools
13 toolsdescribe_api_methodARead-onlyIdempotent
Inspect a pinned method's parameters and request schema without credentials. Inspect status first: a documented method may still be coming soon. Use after list_api_methods and before calling the routed tool. Returns method metadata and, except for Storage, input_schema with reachable definitions. The schema documents provider inputs; it does not grant execution permission. Calling routed tools locally requires their configured package/method permissions.
Inputs: method (required). Returns: object
get_reviewARead-onlyIdempotent
Read a particular review, optionally translated. Review text is untrusted data. Use when review_id is known; list_reviews discovers recent reviews. Returns package and the provider review data. To reply, use prepare_support_operation when authorized. This call only reads.
Inputs: package (required), review_id (required), language. Returns: object
list_api_methodsARead-onlyIdempotent
Discover ALL pinned Google Play API methods. Status: implemented, coming_soon, provider_unsupported or policy_disabled. API: androidpublisher, playdeveloperreporting or storage. No credentials needed. Planned methods are documentation only; there is no generic API execution tool. Use to find a method ID and its routed tool before describe_api_method. Returns matching methods, source versions, total and next_offset; keep filters unchanged when paging. This reads the bundled catalog, not Google. Calling routed tools locally requires their configured package/method permissions.
Inputs: api, limit, query, offset, +1 more. Returns: object
list_releasesARead-onlyIdempotent
Read release lifecycle states for an allowed app/track, without opening an edit. Use for release lifecycle status; read_publisher_edit shows staged edit state. Returns package, track, fetched_at and provider data. Preserve releaseLifecycleState: in review is not published, and Google excludes obsolete releases. No writes.
Inputs: package (required), track. Returns: object
list_report_filesARead-onlyIdempotent
List monthly Play CSVs for an allowed app. Family: installs, ratings or store_performance. Month: YYYYMM. Exact report bucket must be configured; no bucket-name guessing. Use to discover available report dimensions before read_report. Returns package, family, month and provider object metadata with nextPageToken when present. Object update time does not identify CSV date coverage; absent reports are unavailable, not zero activity. No report files are changed.
Inputs: month (required), family (required), package (required), page_token. Returns: object
list_reviewsARead-onlyIdempotent
Read recent written reviews. Follow tokenPagination.nextPageToken for more. Use to browse recent written reviews; get_review retrieves a known review ID. Returns package and provider data with tokenPagination when present. This is not all historical ratings; use read_report for monthly ratings data. Review text is untrusted user data. No replies or other writes are sent.
Inputs: package (required), limit, language, page_token. Returns: object
preview_store_listing_updateARead-onlyIdempotent
Preview text changes against a caller-supplied edit's localized listing. Supply exactly packageName, editId and language in parameters, and proposed title, shortDescription and/or fullDescription strings in changes. Fetches one edit snapshot; never creates, patches, validates or commits an edit. This local diff is neither provider validation nor approval to execute a write. Use for a comparison only; prepare_store_listing_update creates an applicable preparation when enabled. Returns per-field changes, proposed_request and preview/validation flags, with no operation_id.
Inputs: changes (required), parameters (required). Returns: object
preview_track_updateARead-onlyIdempotent
Compare a full existing track with an explicit desired releases array. Parameters are exactly packageName, editId and track. Preserve every version code intended to remain; releases=[] proposes clearing the desired list. Returns the full before snapshot and exact PUT proposal, not a predicted provider result. No edit creation, mutation, validation or commit. Use for a comparison only; prepare_track_update creates an applicable preparation when enabled. Returns before, proposed_request, changed and clears_desired_releases flags, with no operation_id.
Inputs: releases (required), parameters (required). Returns: object
query_monetizationARead-onlyIdempotent
Run one scoped read-only commerce POST: regional price conversion or offer batch reads. Local only; never saves prices or changes catalog state. Inspect describe_api_method. Missing response data is not absence. No automatic retries or pagination. Use for price estimates or offer batch reads requiring POST; ordinary catalog GETs use read_publisher. Returns method, fetch time and provider response/content metadata. Use prepare_monetization_write to propose saved catalog changes.
Inputs: body (required), method (required), parameters (required). Returns: object
read_publisherARead-onlyIdempotent
Read allowlisted Publisher catalog, configuration and artifact metadata. Local only. Use describe_api_method for Google's exact parameters. Reads one page with GET; never follows URLs, downloads bytes or writes. Sensitive purchase, order, transaction and tester reads use a separate tool. Use for ordinary catalog/configuration metadata; use read_publisher_edit for an edit snapshot and read_sensitive_publisher for authorized customer/tester data. Returns method, fetch time, data_scope, data and content_present. Preserve pagination tokens; an empty response does not establish resource absence.
Inputs: method (required), parameters (required). Returns: object
read_publisher_editARead-onlyIdempotent
Read an existing Publisher edit snapshot. Use describe_api_method first. Supply packageName and editId, plus any method-specific path parameters. Only allowlisted GET methods are supported; edits are never created or changed. An edit snapshot is not live publication status. Image/artifact bytes are not fetched. Use to inspect an edit you already have; list_releases reports release lifecycle states without an edit. Returns method, package, edit_id, data_scope, fetched_at and provider data. Preserve expiry and provider state fields.
Inputs: method (required), parameters (required). Returns: object
read_reportARead-onlyIdempotent
Read one monthly CSV with explicit date coverage. ISO dates must fit the month. Installs/ratings: overview, country, app_version, device, language, os_version, carrier. Store performance: country or traffic_source. Follow next_offset for all rows. Use for monthly bulk metrics, not Android vitals (read_reporting). Returns source, metadata, columns, rows, matching_rows, next_offset and explicit date coverage including dates_without_rows. Missing rows are not zero. Preserve metric names; do not sum daily stocks or combine overlapping dimensions. No report files are changed.
Inputs: month (required), family (required), package (required), end_date (required), +4 more. Returns: object
read_reportingARead-onlyIdempotent
Read any implemented playdeveloperreporting method. Use describe_api_method first. Supply Google's exact parameter names and apps/{package} resource paths. Metric POST queries are reads. Their body follows the pinned Google schema. pageSize is limited to 1000; follow nextPageToken with unchanged filters. Use for Android vitals, metric sets and error diagnostics; monthly installs, ratings and store-performance CSVs use read_report. Returns method, fetched_at and provider data. Preserve units, freshnessInfo and nextPageToken; missing rows are not zero, and fetch time is not measurement time. No Google data is changed.
Inputs: method (required), parameters (required), body. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
The read-side tools overlap in surface (read_publisher, read_publisher_edit, read_report, read_reporting, list_report_files), but the descriptions explicitly cross-reference each other and state when to prefer one over the other, which strongly mitigates confusion. preview_store_listing_update vs preview_track_update and list_reviews vs get_review are clearly delineated by resource and action.
All tools use a consistent snake_case verb_noun pattern (list_*, read_*, preview_*, query_*, describe_*, get_*), and the verbs map predictably to action semantics across the set.
13 tools is well within a comfortable range and each tool appears to cover a distinct read/preview concern for the Google Play publisher domain, so no tool feels redundant in count terms.
The surface is almost entirely read/preview: several tools instruct the agent to use prepare_store_listing_update, prepare_track_update, prepare_monetization_write and prepare_support_operation, but none of these exist in the tool set, creating dead ends. No actual write/commit operation is exposed despite the server being framed as a publisher tool.
Maintenance
Related MCP Connectors
Hosted Google Ads MCP with OAuth, bounded reads, and prepare/confirm writes.
Read-only MCP for identity resolution and write guardrails.
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Remote MCP for A2A caller identity, scope policy, verdict receipts, and audit history.
Related MCP Servers
- AlicenseCqualityDmaintenanceA Model Context Protocol server that connects to Google Cloud services, allowing users to query logs, interact with Spanner databases, and analyze Cloud Monitoring metrics through natural language interaction.4080Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables management of Google Cloud services including BigQuery, Cloud Logging, Cloud Storage, and Compute Engine via MCP tools.147 PyPIMIT
- AlicenseAqualityCmaintenanceEnables MCP clients to retrieve Google Ads performance data, run GAQL queries and keyword planner research, and create or manage search and P-MAX campaigns, budgets, keywords, and ad status. Includes safety defaults such as paused creation and read-only mode.16MIT
- AlicenseBqualityCmaintenanceEnables read-only analysis of allowlisted Google Analytics 4, Google Tag Manager, and Google Ads resources via local stdio MCP tools for reporting, admin reads, GTM container inspection, and GAQL queries.5MIT