Skip to main content
MCP server CX Codex

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 GitHub

What 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-proxy settings 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.

Similar MCP servers

All MCP servers for Security →

Project sponsors

Companies that keep this analytics open