{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_4fyct5eedfmk","handle":"charles-mcp","url":"https://wellknown.network/agents/charles-mcp","links":{"self":"https://wellknown.network/agents/charles-mcp/record.json","html":"https://wellknown.network/agents/charles-mcp","markdown":"https://wellknown.network/agents/charles-mcp/record.md","api":"https://wellknown.network/api/v1/agents/charles-mcp","status":"https://wellknown.network/api/v1/agents/charles-mcp/status","claim":"https://wellknown.network/agents/charles-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/charles-mcp/claim.json","badge":"https://wellknown.network/agents/charles-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/charles-mcp/history","tools":"https://wellknown.network/api/v1/agents/charles-mcp/tools"},"ard":{"identifier":"urn:air::server:charles-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"charles-mcp","summary":"Charles Proxy MCP server with live capture, structured traffic analysis, and agent-friendly tool contracts","description":"# Charles MCP Server\n\n[![PyPI version](https://img.shields.io/pypi/v/charles-mcp.svg)](https://pypi.org/project/charles-mcp/)\n[![License](https://img.shields.io/pypi/l/charles-mcp.svg)](LICENSE)\n[![Python](https://img.shields.io/pypi/pyversions/charles-mcp.svg)](https://pypi.org/project/charles-mcp/)\n\n[Docs](docs/README.md) | [Tool Contract](docs/contracts/tools.md) | [AGENTS](AGENTS.md) | [Agent Workflow Guide](docs/agent-workflows.md) | [Chinese README](README.md)\n\nCharles MCP Server connects Charles Proxy to MCP clients so an agent can inspect live traffic, analyze saved recordings, and expand individual requests only when needed.\n\nIt focuses on three things:\n\n- reading incremental traffic from the current Charles session while recording is still active\n- keeping live and history analysis on structured paths instead of exposing raw dump dictionaries first\n- using summary-first outputs so the agent can find hotspots before pulling detail\n\n## This Release Direction (v3.0)\n\nThe `v3.0` direction is clear: `charles-mcp` is moving from pure traffic inspection toward reverse-engineering workflows.\n\n- On top of existing live/history analysis, it now exposes a reverse-analysis tool surface (import, query, decode, replay, signature candidate discovery, and live reverse sessions).\n- The goal is to let an agent go beyond traffic browsing and build an end-to-end reverse workflow around auth flows, signatures, parameter mutation, and replayability.\n\n## Quick Start\n\n### 1. Enable the Charles Web Interface\n\nIn Charles, open: `Proxy -> Web Interface Settings`\n\nMake sure:\n\n- `Enable web interface` is checked\n- username is `admin`\n- password is `123456`\n\nMenu location:\n\n![Charles Web Interface Menu](docs/images/charles-web-interface-menu.png)\n\nSettings dialog:\n\n![Charles Web Interface Settings](docs/images/charles-web-interface-settings.png)\n\n### 2. Install and configure your MCP client\n\nNo cloning, no manual virtualenv. Requires [uv](https://docs.astral.sh/uv/getting-started/inst…","publisher":{"name":"heizaheiza","url":null},"homepage":"https://github.com/heizaheiza/Charles-mcp/blob/main/docs/README.md","repository":"https://github.com/heizaheiza/Charles-mcp/blob/main/docs/README.md","version":"3.0.3","license":null,"protocols":["mcp"],"tags":["mcp","charles-proxy","ai-agent","openai","codex","developer-tools","traffic-analysis","network-debugging"],"pricing":null,"endpoints":[{"url":"pypi:charles-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"code.debugging","name":"Debugging","confidence":0.694,"provenance":"derived"}],"categories":["code"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"charles-mcp","registry":"pypi","observedAt":"2026-11-02T23:27:04.787Z","publishedAt":"2026-04-21T15:52:05.599790Z","latestVersion":"3.0.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"charles-mcp","url":"https://pypi.org/project/charles-mcp/","firstSeenAt":"2026-09-09T11:30:07.646Z","fetchedAt":"2026-11-02T23:24:13.570Z","normalizedAt":"2026-11-02T23:24:13.570Z"}]},"firstSeenAt":"2026-09-09T11:30:07.646Z","updatedAt":"2026-11-02T23:27:04.787Z"}