{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_k9vu58macfc9","handle":"pdb-mcp","url":"https://wellknown.network/agents/pdb-mcp","links":{"self":"https://wellknown.network/agents/pdb-mcp/record.json","html":"https://wellknown.network/agents/pdb-mcp","markdown":"https://wellknown.network/agents/pdb-mcp/record.md","api":"https://wellknown.network/api/v1/agents/pdb-mcp","status":"https://wellknown.network/api/v1/agents/pdb-mcp/status","claim":"https://wellknown.network/agents/pdb-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/pdb-mcp/claim.json","badge":"https://wellknown.network/agents/pdb-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/pdb-mcp/history","tools":"https://wellknown.network/api/v1/agents/pdb-mcp/tools"},"ard":{"identifier":"urn:air::server:pdb-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"pdb-mcp","summary":"A Model Context Protocol (MCP) server for Python debugging using pdb","description":"# PDB MCP Server\n\n[![PyPI version](https://badge.fury.io/py/pdb-mcp.svg)](https://badge.fury.io/py/pdb-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA Model Context Protocol (MCP) server for Python debugging using pdb. This allows you to debug Python scripts through MCP tools.\n\n## Features\n\n- **Start Debug Session**: Launch a Python script in debug mode using pdb\n- **Start Pytest Debug Session**: Run pytest with automatic pdb on test failures\n- **Execute PDB Commands**: Send commands to control the debugging session\n- **Auto-detect Python Interpreter**: Automatically uses virtual environment Python\n- **Modular Architecture**: Clean separation of concerns with session and server modules\n\n## Installation\n\n### Install from PyPI\n\n```bash\npip install pdb-mcp\n```\n\n### Install with uv (Recommended) ⚡️\n\n[`uvx`](https://docs.astral.sh/uv/concepts/tools/) will automatically install the package and run the command.\n\n```bash\nuvx pdb-mcp\n```\n\n### Development Installation\n\n```bash\npip install -e .\n```\n\n## Usage\n\n### As MCP Server\n\nRun the server:\n\n```bash\npdb-mcp\n```\n\nThe server exposes three tools:\n\n#### 1. `start_debug`\n\nStart a debugging session for a Python script.\n\n**Parameters:**\n- `script_path` (required): Path to the Python script to debug\n- `python_path` (required): Path to Python interpreter for the project being debugged\n- `working_directory` (required): Directory to run the command in (should be the project directory)\n- `args` (optional): Command-line arguments to pass to the script\n- `timeout` (optional): Time to wait without new output before returning in seconds (default: 5.0). As long as there's new output, will keep waiting.\n- `env` (optional): Environment variables to set for the debugging session (e.g., {\"DEBUG\": \"1\"})\n\n**Example:**\n```json\n{\n  \"script_path\": \"test_script.py\",\n  \"python_path\": \"/path/to/python\",\n  \"working_directory\": \"/path/to/project\",\n  \"env\": {\"DEBUG\": \"1\"}\n}\n```\n\n#### 2. …","publisher":null,"homepage":null,"repository":null,"version":"0.0.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:pdb-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"provenance":"derived"},{"slug":"code.debugging","name":"Debugging","confidence":0.802,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["code","dev"],"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":"pdb-mcp","registry":"pypi","observedAt":"2026-11-03T21:28:27.038Z","publishedAt":"2026-02-09T12:35:41.396406Z","latestVersion":"0.0.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"pdb-mcp","url":"https://pypi.org/project/pdb-mcp/","firstSeenAt":"2026-09-10T09:25:45.872Z","fetchedAt":"2026-11-03T21:27:38.198Z","normalizedAt":"2026-11-03T21:27:38.198Z"}]},"firstSeenAt":"2026-09-10T09:25:45.872Z","updatedAt":"2026-11-03T21:28:27.038Z"}