{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_pwune4etp6hv","handle":"keyhole-mcp","url":"https://wellknown.network/agents/keyhole-mcp","links":{"self":"https://wellknown.network/agents/keyhole-mcp/record.json","html":"https://wellknown.network/agents/keyhole-mcp","markdown":"https://wellknown.network/agents/keyhole-mcp/record.md","api":"https://wellknown.network/api/v1/agents/keyhole-mcp","status":"https://wellknown.network/api/v1/agents/keyhole-mcp/status","claim":"https://wellknown.network/agents/keyhole-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/keyhole-mcp/claim.json","badge":"https://wellknown.network/agents/keyhole-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/keyhole-mcp/history","tools":"https://wellknown.network/api/v1/agents/keyhole-mcp/tools"},"ard":{"identifier":"urn:air::server:keyhole-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"keyhole-mcp","summary":"Let ChatGPT read, and carefully edit, only the local folders you choose - through OpenAI's Secure MCP Tunnel, with no shell and no public port.","description":"# Keyhole — local files for ChatGPT\n\nLet ChatGPT read, and carefully edit, only the local folders you choose. No shell, no public port.\n\nKeyhole connects your Mac, Linux or Windows computer to your private ChatGPT app through OpenAI's official\nSecure MCP Tunnel. Folders start read-only. Explicit local write grants allow hash-checked text edits\nwith a private recovery history. ChatGPT cannot open other folders, run commands or widen its own access.\n\n## Install\n\n```sh\nuv tool install keyhole-mcp\nkeyhole setup\n```\n\nOn Windows, use PowerShell and request x64 Python, on both x64 and ARM PCs, then follow the\n[Windows guide](https://github.com/L-Jovi/keyhole/blob/v0.5.0/docs/windows.md):\n\n```powershell\nuv tool install --python cpython-3.12-windows-x86_64-none --no-build keyhole-mcp\n```\n\nThe package is **keyhole-mcp**; its command is **keyhole**. Do not install the unrelated package named\n`keyhole`. `uv` supplies Python and isolates dependencies; setup can download and verify the official\ntunnel client after confirmation.\n\nYou need ChatGPT Developer mode and OpenAI Platform tunnel permissions. Installing this package alone\ndoes not create those permissions or a private ChatGPT app. Follow the\n[complete first-use guide](https://github.com/L-Jovi/keyhole/blob/v0.5.0/docs/setup.md), including the\nread-only example, account setup and PATH checks. Release wheels remain available on\n[GitHub Releases](https://github.com/L-Jovi/keyhole/releases).\n\nVerified scope: Apple-silicon macOS, Ubuntu x86_64 and Windows 11 with x64 Python; Python 3.11–3.14 in\nCI. Real ChatGPT acceptance was completed on macOS 15.7.7, Ubuntu 24.04 and a hosted Windows 11 ARM\nmachine. Ubuntu 22.04 and Windows Server 2025 have automated coverage; no physical Windows consumer PC\nhas been tested. See [platform evidence](https://github.com/L-Jovi/keyhole/blob/v0.5.0/docs/platforms.md).\n\n[See the step-by-step demonstration](https://github.com/L-Jovi/keyhole/blob/v0.5.0/docs/demo.md)\nor read the [tool and safety ref…","publisher":{"name":"Jovi","url":null},"homepage":"https://github.com/L-Jovi/keyhole#readme","repository":"https://github.com/L-Jovi/keyhole/blob/main/CHANGELOG.md","version":"0.5.0","license":null,"protocols":["mcp"],"tags":["chatgpt","filesystem","local-files","mcp","secure-mcp-tunnel"],"pricing":null,"endpoints":[{"url":"pypi:keyhole-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":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.836,"provenance":"derived"}],"categories":["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":"keyhole-mcp","registry":"pypi","observedAt":"2026-10-28T08:28:03.943Z","publishedAt":"2026-09-27T12:41:33.311170Z","latestVersion":"0.5.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"keyhole-mcp","url":"https://pypi.org/project/keyhole-mcp/","firstSeenAt":"2026-09-28T00:24:09.510Z","fetchedAt":"2026-10-28T08:26:29.764Z","normalizedAt":"2026-10-28T08:26:29.764Z"}]},"firstSeenAt":"2026-09-28T00:24:09.510Z","updatedAt":"2026-10-28T08:28:03.943Z"}