# podium-mcp

Controls iOS and Android environments through structured UI trees rather than vision prompts. Helps agents run mobile test flows and debug React Native.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: hoainho
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/hoainho/podium-mcp
- Updated: 2026-06-30
- HTML: https://affpapa.org/en/nevibecode/mcp/podium-mcp

## What it does

This server bundles 51 tools under a unified stdio endpoint. It avoids passing screenshots to language models. Instead, the tool provides compact element hierarchies, keeping token usage low during lengthy test runs. It drives native UI actions through `idb` or Maestro fallbacks, collects HTTP traffic from `WKWebView`, and inspects React Native via CDP.

Executables launch directly via `execFile` without a shell. The server handles tool errors as structured data without crashing the session. It also inspects WebGL scenes in engines like Pixi or Three.js as addressable objects.

The runtime requires Node.js version 22 or higher on the host. Missing local binaries like `adb` or Xcode tools cause related features to degrade gracefully.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add podium-mcp -- npx -y podium-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add podium-mcp -- npx -y podium-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "podium-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "podium-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "podium-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "podium-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add podium-mcp npx -y podium-mcp
```

## When to use it
- run mobile test suites on iOS simulators and Android hardware
- capture Metro logs and component state for React Native apps via CDP
- read DOM nodes and record network traffic inside WKWebView
- interact with canvas and WebGL game engines without visual snapshots

## Example prompts
- Launch the app on an active iOS simulator and inspect network calls inside WKWebView
- Execute tap actions on the Android login screen and return the element hierarchy
- Check Metro console output and locate recent React Native crash traces

## Similar
- [mobile-mcp](https://affpapa.org/en/nevibecode/mcp/mobile-mcp.md) — MCP server · ★ 10025
- [mobilerun](https://affpapa.org/en/nevibecode/mcp/mobilerun.md) — MCP server · ★ 9833
- [e2e](https://affpapa.org/en/nevibecode/mcp/e2e.md) — MCP server · ★ 11962
- [XcodeBuildMCP](https://affpapa.org/en/nevibecode/mcp/xcodebuildmcp.md) — MCP server · ★ 6511
- [ShipSwift](https://affpapa.org/en/nevibecode/mcp/shipswift.md) — MCP server · ★ 3244
- [agent-device](https://affpapa.org/en/nevibecode/mcp/agent-device.md) — MCP server · ★ 5158

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md