impersonate-mcp — Claude Code MCP server: setup and install
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.
MIT ★ 48 updated 2026-11-08
Open on GitHubWhat impersonate-mcp 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.
What it helps with
- 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 for the agent
- Show the current
impersonate-proxysettings and HTTP/2 fingerprint. - Check the proxy fingerprint and return the results.
- Fetch this HTTP(S) URL through the proxy.
How to install impersonate-mcp
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about impersonate-mcp
How do I install impersonate-mcp in Claude Code?
Build the binary from source with make build-mcp, then register it as an MCP server in Claude Code. A running impersonate-proxy and the path to its ca.crt are also required.
What does impersonate-mcp do?
It controls impersonate-proxy settings, checks TLS and HTTP/2 fingerprints, and retrieves pages through the proxy.
What does impersonate-mcp need to run?
It needs a running impersonate-proxy with an accessible management API. Fingerprint checks and page retrieval require the proxy's ca.crt.