{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_3jcmuz7xgxss","handle":"mcp-pdb","url":"https://wellknown.network/agents/mcp-pdb","links":{"self":"https://wellknown.network/agents/mcp-pdb/record.json","html":"https://wellknown.network/agents/mcp-pdb","markdown":"https://wellknown.network/agents/mcp-pdb/record.md","api":"https://wellknown.network/api/v1/agents/mcp-pdb","status":"https://wellknown.network/api/v1/agents/mcp-pdb/status","claim":"https://wellknown.network/agents/mcp-pdb/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-pdb/claim.json","badge":"https://wellknown.network/agents/mcp-pdb/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-pdb/history","tools":"https://wellknown.network/api/v1/agents/mcp-pdb/tools"},"ard":{"identifier":"urn:air::server:mcp-pdb","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-pdb","summary":"MCP to use the python debugger, inspired by debug-gym","description":"# MCP-PDB: Python Debugger Interface for Claude/LLMs\n\n![Python](https://img.shields.io/badge/Python-3.12+-blue.svg)\n![License](https://img.shields.io/badge/License-MIT-green.svg)\n\nMCP-PDB provides tools for using Python's debugger (pdb) with Claude and other LLMs through the Model Context Protocol (MCP). This was inspired by [debug-gym](https://microsoft.github.io/debug-gym/) by Microsoft, which showed gains in various coding benchmarks by providing a coding agent access to a python debugger.\n\n## ⚠️ Security Warning\n\nThis tool executes Python code through the debugger. Use in trusted environments only.\n\n## Installation\n\nWorks best with [uv](https://docs.astral.sh/uv/getting-started/features/)\n\n### Claude Code\n```bash\n# Install the MCP server\nclaude mcp add mcp-pdb -- uv run --with mcp-pdb mcp-pdb\n\n# Alternative: Install with specific Python version\nclaude mcp add mcp-pdb -- uv run --python 3.13 --with mcp-pdb mcp-pdb\n\n# Note: The -- separator is required for Claude Code CLI\n```\n\n### Windsurf\n```json\n{\n  \"mcpServers\": {\n    \"mcp-pdb\": {\n      \"command\": \"uv\",\n      \"args\": [\n        \"run\",\n        \"--with\",\n        \"mcp-pdb\",\n        \"mcp-pdb\"\n      ]\n    }\n  }\n}\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `start_debug(file_path, use_pytest, args)` | Start a local debugging session for a Python file |\n| `connect_remote_debug(host, port, timeout)` | Connect to a remote PDB session over TCP |\n| `send_pdb_command(command)` | Send a command to the running PDB instance (local or remote) |\n| `set_breakpoint(file_path, line_number)` | Set a breakpoint at a specific line |\n| `clear_breakpoint(file_path, line_number)` | Clear a breakpoint at a specific line |\n| `list_breakpoints()` | List all current breakpoints |\n| `restart_debug()` | Restart/reconnect the current debugging session |\n| `examine_variable(variable_name)` | Get detailed information about a variable |\n| `get_debug_status()` | Show the current state of the debugging session |\n| `end_…","publisher":null,"homepage":null,"repository":null,"version":"0.6.0","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-pdb","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"code.debugging","name":"Debugging","confidence":0.802,"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":"mcp-pdb","registry":"pypi","observedAt":"2026-11-03T14:24:07.449Z","publishedAt":"2026-05-11T06:51:38.785139Z","latestVersion":"0.6.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-pdb","url":"https://pypi.org/project/mcp-pdb/","firstSeenAt":"2026-09-10T02:24:40.536Z","fetchedAt":"2026-11-03T14:23:16.611Z","normalizedAt":"2026-11-03T14:23:16.611Z"}]},"firstSeenAt":"2026-09-10T02:24:40.536Z","updatedAt":"2026-11-03T14:24:07.449Z"}