# impersonate-mcp

impersonate-mcp is a Claude Code MCP server for changing impersonate-proxy settings and sending requests through the proxy. Use it to inspect TLS and HTTP/2 fingerprints or retrieve a URL.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 48 repo stars
- Author: ytkoka
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ytkoka/impersonate-proxy/tree/HEAD/impersonate-mcp
- Updated: 2026-11-08
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/impersonate-mcp

## What it does

impersonate-mcp changes `impersonate-proxy` settings, including TLS and HTTP/2 fingerprints, the User-Agent, the spoofed client IP, and the upstream proxy. Its fingerprint check queries `tls.peet.ws` through the proxy and returns a summary. The URL fetch tool retrieves HTTP(S) pages and reports response details such as status, headers, redirects, and body.

The server connects to the proxy management API over stdio. A running `impersonate-proxy` is required; fingerprint checks and page retrieval also need the proxy's `ca.crt`. The management API has no authentication, so `mgmt_listen` should remain bound to loopback.

With `--read-only`, settings-changing tools are hidden, and fetch requests are limited to GET, HEAD, and OPTIONS without a body. URL fetches go through the proxy and reject loopback, private, and link-local destinations. The allowed host list is set in the proxy configuration.

## Requirements
- Environment variables: `IMPERSONATE_MGMT_URL`, `IMPERSONATE_CA_CERT`, `IMPERSONATE_READ_ONLY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- change the proxy's TLS and HTTP/2 fingerprints
- check the fingerprint and IP reported to a server
- retrieve an HTTP(S) page through the configured proxy
- hide settings-changing tools in read-only mode

## Example prompts
- Show the current `impersonate-proxy` settings and HTTP/2 fingerprint.
- Check the proxy fingerprint and return the results.
- Fetch this HTTP(S) URL through the proxy.

## Similar
- [masterhttprelayvpn-proxy](https://affpapa.org/en/nevibecode/skills/masterhttprelayvpn-proxy.md) — skill · 372 installs
- [network-troubleshooting](https://affpapa.org/en/nevibecode/skills/network-troubleshooting.md) — skill · 131 installs
- [proxyman-debugging-tools](https://affpapa.org/en/nevibecode/skills/proxyman-debugging-tools.md) — skill · 301 installs
- [hunt-grpc](https://affpapa.org/en/nevibecode/skills/hunt-grpc.md) — skill · ★ 16193 repo stars
- [http-request-smuggling](https://affpapa.org/en/nevibecode/skills/http-request-smuggling.md) — skill · ★ 73 repo stars
- [race-condition](https://affpapa.org/en/nevibecode/skills/race-condition.md) — skill · 4000 installs

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