# Reverse Api Engineer > The agent that turns websites into APIs! - **Type:** MCP server - **Install:** `agentstack add mcp-kalil0321-reverse-api-engineer` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [kalil0321](https://agentstack.voostack.com/s/kalil0321) - **Installs:** 0 - **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [kalil0321](https://github.com/kalil0321) - **Source:** https://github.com/kalil0321/reverse-api-engineer - **Website:** https://reverseapi.dev ## Install ```sh agentstack add mcp-kalil0321-reverse-api-engineer ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Reverse API Engineer > **Turn websites into APIs.** Browse (or let an agent browse), and get a clean, typed client for the endpoints the site actually uses. Agent mode Manual mode --- ## How it works 1. You give it a website and a goal ("fetch all Apple jobs"). 2. A browser visits the site, either driven by you or by an AI agent. 3. Network traffic is captured to a HAR file. 4. Claude reads the traffic and writes you a working API client (Python, JS, or TS). No more manually opening DevTools, copying cURL commands, and gluing together a client. ## Install ```bash uv tool install reverse-api-engineer # or: pip install reverse-api-engineer playwright install chromium ``` ## Quick start ```bash reverse-api-engineer > fetch all apple jobs from their careers page # Browser opens. Navigate, interact, close when done. # → ./scripts/apple_jobs_api/ (api_client.py, README.md, example_usage.py) ``` Cycle modes with **Shift+Tab**: | Mode | What it does | |------|--------------| | `manual` | You drive the browser; AI generates the client from captured traffic. | | `agent` | An AI agent drives capture autonomously (Playwright or Chrome MCP, or Vercel agent-browser CLI). | | `engineer` | Re-run generation on a previous capture (`engineer `). | | `collector` | Agent collects structured data (JSON/CSV) using web search + fetch. | Agent mode providers: - **auto** (default): Playwright MCP, single workflow for browsing + reverse engineering. - **chrome-mcp**: drives your real Chrome so you keep existing sessions/cookies. Requires Chrome 146+ and Node.js 20.19+. - **agent-browser**: [Vercel agent-browser](https://github.com/vercel-labs/agent-browser) **CLI** (not a Reverse API Engineer browser MCP server). At session start RAE uses whatever `agent-browser` is already on `PATH`, otherwise runs **`npm install -g `** (same pin as config / `RAE_AGENT_BROWSER_PACKAGE`), prints a yellow notice, validates with **`--help`**, and only then falls back to **`npx -y `** if npm cannot install. Prompts embed the resolved shell prefix alongside **`skills get core --full`**, **`skills list`**, HAR phases, cloud notes from `agent_browser_notes`. Tune with `agent_browser_npx_package` (optional), env `RAE_AGENT_BROWSER_*`. First Chromium fetch: **`agent-browser install`** (add `--with-deps` on trimmed Linux). Optional sanity checks: ```bash agent-browser doctor --offline --quick || true agent-browser skills list >/dev/null ``` ## Configuration Settings live in `~/.reverse-api/config.json` and can be edited via `/settings` in the CLI: ```json { "agent_provider": "auto", "agent_browser_npx_package": "agent-browser@0", "agent_browser_notes": "", "claude_code_model": "claude-sonnet-4-6", "collector_model": "claude-sonnet-4-6", "opencode_model": "claude-sonnet-4-6", "opencode_provider": "anthropic", "copilot_model": "gpt-5", "cursor_model": "composer-2.5", "output_dir": null, "output_language": "python", "real_time_sync": true, "sdk": "claude" } ``` - **Models**: Sonnet 4.6 (default), Opus 4.6 (most capable), Haiku 4.5 (fastest). For OpenCode see [models.dev](https://models.dev). - **SDK**: `claude` (default), `opencode`, `cursor`, or `copilot` (GitHub Copilot). - **Output language**: `python`, `javascript`, or `typescript`. ## CLI Slash commands inside the CLI: - `/settings`: configure model, SDK, agent provider, and sync settings. - `/history`: list past runs with timestamps, costs, and status. - `/messages `: view detailed message logs for a run. - `/help` (alias: `/commands`): show the command list. - `/exit` (alias: `/quit`): leave the CLI. Scriptable subcommands (pipe to `jq`): ```bash reverse-api-engineer agent --prompt "capture the public jobs api" \ --url https://example.com/jobs --json | jq reverse-api-engineer list --json reverse-api-engineer show --json reverse-api-engineer run --file api_client.py \ --no-interactive --auto-install -- --org acme ``` Pass `--no-interactive` (and/or `--json`) to skip prompts. With `--json`, stdout is one JSON document and logs go to stderr. ### `agent --json` schema | Field | Type | Notes | |------------------|---------------------|------------------------------------------------------------------------| | `schema_version` | `int` | Currently `1`. | | `status` | `"ok"` \| `"error"` | Top-level result. | | `run_id` | `string` \| `null` | Use with `show` / `engineer` / `run`. | | `prompt` | `string` | | | `url` | `string` \| `null` | | | `mode` | `string` \| `null` | `"auto"`, `"chrome-mcp"`, or `"agent-browser"`. | | `har_path` | `string` \| `null` | Captured HAR. | | `script_path` | `string` \| `null` | Generated client. | | `usage` | `object` | `{input_tokens, output_tokens, total_cost}`. | | `error` | `string` \| `null` | When `status == "error"`. | ### Exit codes | Code | Meaning | |------|---------| | `0` | Success. | | `1` | Runtime error. | | `2` | Missing required arg under `--no-interactive` / `--json`. | For `run`, the exit code is the underlying script's return code on success, `1` if no script was found, or non-zero if `--no-interactive` would have had to prompt. ## Output locations - `~/.reverse-api/runs/scripts/{run_id}/`: permanent storage - `./scripts/{descriptive_name}/`: local copy with a readable name - Collector: `./collected/{folder_name}/` (`items.json`, `items.csv`, `README.md`) ## Caveats - Generated code runs locally via Claude Code, so review before executing. - Sites with aggressive bot detection may block capture or require manual interaction. ## Development ```bash git clone https://github.com/kalil0321/reverse-api-engineer.git cd reverse-api-engineer uv sync uv run reverse-api-engineer ``` Build: `./scripts/clean_build.sh`. Requires Python 3.11+, Playwright browsers, and an API key for agent mode. ## License MIT. See [LICENSE](LICENSE). ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [kalil0321](https://github.com/kalil0321) - **Source:** [kalil0321/reverse-api-engineer](https://github.com/kalil0321/reverse-api-engineer) - **License:** MIT - **Homepage:** https://reverseapi.dev Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** yes - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-kalil0321-reverse-api-engineer - Seller: https://agentstack.voostack.com/s/kalil0321 - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.