Skip to content

Configuration

MCP Client Setup

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "play-store": {
      "command": "uvx",
      "args": ["play-store-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json"
      }
    }
  }
}

Add to .kiro/settings/mcp.json:

{
  "mcpServers": {
    "play-store": {
      "command": "uvx",
      "args": ["play-store-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json"
      }
    }
  }
}

Most MCP clients use the same configuration format:

{
  "mcpServers": {
    "play-store": {
      "command": "uvx",
      "args": ["play-store-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json"
      }
    }
  }
}

Docker

docker run -e GOOGLE_APPLICATION_CREDENTIALS=/creds/key.json \
  -v /path/to/service-account.json:/creds/key.json:ro \
  ghcr.io/lusky3/play-store-mcp:latest

For HTTP transport with Docker:

docker run -p 8000:8000 \
  -e GOOGLE_APPLICATION_CREDENTIALS=/creds/key.json \
  -v /path/to/service-account.json:/creds/key.json:ro \
  ghcr.io/lusky3/play-store-mcp:latest \
  --transport streamable-http --host 0.0.0.0 --port 8000

Environment Variables

Variable Description Required Default
GOOGLE_APPLICATION_CREDENTIALS Path to service account JSON key file Yes (or use per-request credentials) —
GOOGLE_PLAY_STORE_CREDENTIALS Inline JSON credentials string Alternative to file path —
PLAY_STORE_MCP_LOG_LEVEL Log level: DEBUG, INFO, WARNING, ERROR No INFO

HTTP Transport

For remote access or public deployments:

play-store-mcp --transport streamable-http --host 0.0.0.0 --port 8000

The server exposes a /health endpoint for monitoring.

See Remote Credentials for per-request credential configuration.

Logging

Logs are written to stderr (stdout is reserved for MCP JSON-RPC communication). The server uses structlog for structured logging.

To enable debug logging:

export PLAY_STORE_MCP_LOG_LEVEL=DEBUG

Or set it in your MCP client config:

{
  "mcpServers": {
    "play-store": {
      "command": "uvx",
      "args": ["play-store-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
        "PLAY_STORE_MCP_LOG_LEVEL": "DEBUG"
      }
    }
  }
}

Retry Behavior

The client automatically retries failed API calls with exponential backoff:

  • Retries on HTTP 429 (rate limit), 500, and 503 errors
  • Maximum 3 retries per request
  • Backoff starts at 1 second, doubles each retry (max 32 seconds)
  • Random jitter is added to prevent thundering herd