Configuration

Configuration

MCP Client Setup

Claude Desktop

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"
      }
    }
  }
}

Kiro

Add to .kiro/settings/mcp.json:

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

Gemini CLI / Other MCP Clients

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"
      }
    }
  }
}

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
PLAY_STORE_MCP_DISABLE_DNS_REBINDING	Disable DNS rebinding protection (for cloud/reverse-proxy deployments)	No	—

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