{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_5rfyk65tjqke","handle":"dot-mcp","url":"https://wellknown.network/agents/dot-mcp","links":{"self":"https://wellknown.network/agents/dot-mcp/record.json","html":"https://wellknown.network/agents/dot-mcp","markdown":"https://wellknown.network/agents/dot-mcp/record.md","api":"https://wellknown.network/api/v1/agents/dot-mcp","status":"https://wellknown.network/api/v1/agents/dot-mcp/status","claim":"https://wellknown.network/agents/dot-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/dot-mcp/claim.json","badge":"https://wellknown.network/agents/dot-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/dot-mcp/history","tools":"https://wellknown.network/api/v1/agents/dot-mcp/tools"},"ard":{"identifier":"urn:air::server:dot-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"dot-mcp","summary":"Personal MCP agent: shell, files, memory, goals, inbox, scheduler, capability URL + self-hosted OAuth","description":"# dot-mcp\n\nPersonal MCP agent for ChatGPT, Claude, and Gemini: shell, files, memory,\ngoals, tasks, inbox, scheduler, and self-hosted OAuth — running on your\nown machine.\n\n> ⚠️ The server gives full shell access to whoever holds a credential.\n> Expose it only while you use it, then stop it (`dot-mcp stop`).\n\n## Install\n\n```bash\npip install dot-mcp\n```\n\nRequires Python 3.10+ and OpenSSH (`ssh`, `ssh-keygen`) for the tunnel.\n\n## Use\n\n```bash\ndot-mcp start    # server + public URL (runs in background)\ndot-mcp status   # check if it is running\ndot-mcp stop     # stop server + tunnel\n```\n\n`dot-mcp start` prints everything the connector needs:\n\n```\nPublic URL            https://xxxx.tunnl.gg/mcp/\nOwner secret          <stored on your machine>\nOAuth Client ID       dots-xxxxxxxx\nOAuth Client secret   <stored on your machine>\n```\n\nAdd the **Public URL** as a custom MCP connector (auth = OAuth).\nApprove once with the owner secret when asked. The tunnel URL stays the\nsame on restart; the free tunnel expires after 24h or 2h idle.\n\nLinux/Termux is the supported runtime for process management. Stop only affects\nprocesses started with the new ownership records. If upgrading from an older\nversion, stop its server/tunnel before starting this version; bare legacy PID\nfiles are deliberately not trusted.\n\n`DOT_MCP_STATE_DIR` overrides the complete credential/SSH-key directory\n(default `~/.config/dot-mcp`), not its parent. This is separate from `--data-dir`.\n\nFile paths are relative to `$HOME` unless absolute. Absolute paths retain their\nlocation and must fall within `$HOME`, `$TMPDIR`, or available shared storage;\nother paths are rejected, not silently placed under HOME. On Android, when\n`$TMPDIR` is outside `/tmp`, `/tmp` and `/tmp/...` map to `$TMPDIR`. File tools\nreturn the effective `path`. Shell command text is never remapped, so use that\neffective path in shell commands when this mapping applies.\n\nFile roots are guardrails, not a shell sandbox. A shell credential still grants\nfu…","publisher":{"name":"Ashveil1","url":null},"homepage":"https://github.com/Ashveil1/dot-mcp","repository":"https://github.com/Ashveil1/dot-mcp","version":"0.2.3","license":"MIT","protocols":["mcp"],"tags":["agent","cli","mcp","personal-assistant","termux"],"pricing":null,"endpoints":[{"url":"pypi:dot-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","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":1,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"},{"slug":"security.identity","name":"Identity & Access","confidence":0.745,"provenance":"derived"}],"categories":["dev","security"],"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":"dot-mcp","registry":"pypi","observedAt":"2026-11-05T21:26:37.244Z","publishedAt":"2026-10-12T11:54:30.909549Z","latestVersion":"0.2.3"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"dot-mcp","url":"https://pypi.org/project/dot-mcp/","firstSeenAt":"2026-10-12T14:24:24.104Z","fetchedAt":"2026-11-05T21:25:10.831Z","normalizedAt":"2026-11-05T21:25:10.831Z"}]},"firstSeenAt":"2026-10-12T14:24:24.104Z","updatedAt":"2026-11-05T21:26:37.244Z"}