{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_y28mvup94sp7","handle":"pyqt-runtime-mcp","url":"https://wellknown.network/agents/pyqt-runtime-mcp","links":{"self":"https://wellknown.network/agents/pyqt-runtime-mcp/record.json","html":"https://wellknown.network/agents/pyqt-runtime-mcp","markdown":"https://wellknown.network/agents/pyqt-runtime-mcp/record.md","api":"https://wellknown.network/api/v1/agents/pyqt-runtime-mcp","status":"https://wellknown.network/api/v1/agents/pyqt-runtime-mcp/status","claim":"https://wellknown.network/agents/pyqt-runtime-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/pyqt-runtime-mcp/claim.json","badge":"https://wellknown.network/agents/pyqt-runtime-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/pyqt-runtime-mcp/history","tools":"https://wellknown.network/api/v1/agents/pyqt-runtime-mcp/tools"},"ard":{"identifier":"urn:air::server:pyqt-runtime-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"pyqt-runtime-mcp","summary":"MCP server and in-app bridge for inspecting and controlling PyQt5/PyQt6 applications","description":"# PyQt Runtime MCP \n \nRuntime inspection and interaction for **PyQt5 and PyQt6 QWidget applications**, in the same spirit as browser DevTools / Playwright — but Qt-native. \n \nCursor talks to an MCP stdio server. That server talks over localhost TCP to a small **bridge running inside the target app**. All `QWidget` work happens on the Qt GUI thread. \n \n## Installation \n \n```powershell \npip install pyqt-runtime-mcp \n``` \n \nFrom this folder (development): \n \n```powershell \npip install -e . \n``` \n \nThe in-app bridge uses the host's **PyQt5 or PyQt6** binding. The MCP process pulls in the `mcp` SDK and does **not** import or require Qt. Optional extras: `pip install \"pyqt-runtime-mcp[qt]\"` for PyQt5 or `pip install \"pyqt-runtime-mcp[qt6]\"` for PyQt6. \n \nThe bridge detects an already imported host binding. For standalone examples when both are installed, set `PYQT_MCP_QT_API=PyQt5` or `PyQt6`. Loading both bindings into one process is rejected. Import the host binding before importing `PyQtMCPBridge` directly; the `install_pyqt_mcp` function can be imported earlier. \n \nIntegrate the in-app bridge as shown below, then configure the `pyqt-runtime` MCP server in your editor or agent client. \n \n## Quick start \n \n1. Run a bridge-enabled PyQt application, or start the included demo with `python examples/demo_app.py`. The in-app bridge listens on `127.0.0.1:8765`. \n \n2. Point Cursor at the MCP server (see [Cursor configuration](#cursor-configuration)). Reload MCP servers if you just added it. \n \n3. Ask: \n \n```text \nInspect the current PyQt application and give me its widget hierarchy. \n``` \n \nRun the included demo from this folder with PyQt5 installed: \n \n```powershell \npython examples/demo_app.py \n``` \n \n## Integration into an existing PyQt application \n \n```python \nfrom PyQt5.QtWidgets import QApplication \nfrom pyqt_runtime_mcp import install_pyqt_mcp \n \napp = QApplication(sys.argv) \nwindow = MainWindow() \n \ninstall_pyqt_mcp(app) \n \nwindow.show() \nsys.exit(app.exec_()) \n``` \n…","publisher":null,"homepage":null,"repository":null,"version":"1.0.0","license":"MIT","protocols":["mcp"],"tags":["pyqt5","pyqt6","mcp","qt","devtools"],"pricing":null,"endpoints":[{"url":"pypi:pyqt-runtime-mcp","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":"infra.browser-automation","name":"Browser Automation","confidence":0.836,"provenance":"derived"}],"categories":["infra"],"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":"pyqt-runtime-mcp","registry":"pypi","observedAt":"2026-11-10T01:24:56.376Z","publishedAt":"2026-09-09T14:46:48.154315Z","latestVersion":"1.0.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"pyqt-runtime-mcp","url":"https://pypi.org/project/pyqt-runtime-mcp/","firstSeenAt":"2026-09-10T10:24:41.356Z","fetchedAt":"2026-11-10T01:22:43.594Z","normalizedAt":"2026-11-10T01:22:43.594Z"}]},"firstSeenAt":"2026-09-10T10:24:41.356Z","updatedAt":"2026-11-10T01:24:56.376Z"}