{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zxx78wcyruvu","handle":"gdb-mcp","url":"https://wellknown.network/agents/gdb-mcp","links":{"self":"https://wellknown.network/agents/gdb-mcp/record.json","html":"https://wellknown.network/agents/gdb-mcp","markdown":"https://wellknown.network/agents/gdb-mcp/record.md","api":"https://wellknown.network/api/v1/agents/gdb-mcp","status":"https://wellknown.network/api/v1/agents/gdb-mcp/status","claim":"https://wellknown.network/agents/gdb-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/gdb-mcp/claim.json","badge":"https://wellknown.network/agents/gdb-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/gdb-mcp/history","tools":"https://wellknown.network/api/v1/agents/gdb-mcp/tools"},"ard":{"identifier":"urn:air::server:gdb-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"gdb-mcp","summary":"Model Context Protocol server for driving GDB from an LLM.","description":"# gdb-mcp\n\nModel Context Protocol server that wraps `gdb` so an LLM can drive live debugging\nsessions. The server exposes tools for starting a session on a binary, attaching\nto an existing PID, running ad-hoc commands, batching commands, checking status,\nand shutting sessions down.\n\n> Requires `gdb` on the host and the `mcp` python package (v1+).\n\n## Setup\n\nYou can install either inside a virtualenv (recommended) or directly:\n\n```bash\n# optional but recommended\npython -m venv .venv\n. .venv/bin/activate\n\npip install -e .\n# or: pip install .\n```\n\n## Running the MCP server\n\nYou can start the server directly:\n\n```bash\ngdb-mcp\n# or\npython -m gdb_mcp.server\n```\n\nThe server uses stdio for transport (the default for most MCP clients). Point\nyour MCP client configuration at the command above.\n\n### One-shot client configuration\n\nRun `gdb-mcp --install` to add the server to any detected MCP-aware clients\nwithout editing config files by hand. The installer currently knows how to\nupdate:\n\n- Codex CLI (`~/.codex/config.toml`)\n- Claude Desktop configs (common Linux/macOS paths)\n- Cursor / Windsurf MCP config files (if present)\n\nUse `--install-command /custom/path/to/gdb-mcp` or `--install-args ...` if you\nneed to override what gets written.\n\n## Exposed tools\n\n- `start_binary(binary_path, args=None, cwd=None, load_init=True, start_timeout=30.0, prompt=None, force_prompt=True)` – launch gdb\n  against a target binary (with optional args) and return a session id and the\n  initial banner. Set `load_init=False` to skip user gdbinit (default is to load\n  it so helpers like GEF/pwndbg remain enabled). Increase `start_timeout` if\n  loading extensions takes longer to reach the first prompt. Use `prompt` to\n  force a specific prompt string (defaults cover `(gdb)`, `(pwndbg)`, and\n  `gef>`). `force_prompt` sets the prompt to the chosen value after startup to\n  avoid timeouts from customized prompts (e.g., pwndbg); set `force_prompt=False`\n  if you need to keep your custom prompt unchanged.\n-…","publisher":{"name":"gpt-5.1-codex-max","url":null},"homepage":null,"repository":"https://github.com/datobena/gdb-mcp","version":"1.0.1","license":"MIT","protocols":["mcp"],"tags":["gdb","debugger","mcp","model-context-protocol","llm","agent","reverse-engineering","binary-analysis","pwndbg","gef","stdio","attach","breakpoint","linux-debugging"],"pricing":null,"endpoints":[{"url":"pypi:gdb-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"code.debugging","name":"Debugging","confidence":1,"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":"gdb-mcp","registry":"pypi","observedAt":"2026-11-03T03:26:48.906Z","publishedAt":"2025-12-11T18:56:32.454829Z","latestVersion":"1.0.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"gdb-mcp","url":"https://pypi.org/project/gdb-mcp/","firstSeenAt":"2026-09-09T16:23:24.700Z","fetchedAt":"2026-11-03T03:25:54.177Z","normalizedAt":"2026-11-03T03:25:54.177Z"}]},"firstSeenAt":"2026-09-09T16:23:24.700Z","updatedAt":"2026-11-03T03:26:48.906Z"}