{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_cm7rx4hyvyen","handle":"plintho-mcp","url":"https://wellknown.network/agents/plintho-mcp","links":{"self":"https://wellknown.network/agents/plintho-mcp/record.json","html":"https://wellknown.network/agents/plintho-mcp","markdown":"https://wellknown.network/agents/plintho-mcp/record.md","api":"https://wellknown.network/api/v1/agents/plintho-mcp","status":"https://wellknown.network/api/v1/agents/plintho-mcp/status","claim":"https://wellknown.network/agents/plintho-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/plintho-mcp/claim.json","badge":"https://wellknown.network/agents/plintho-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/plintho-mcp/history","tools":"https://wellknown.network/api/v1/agents/plintho-mcp/tools"},"ard":{"identifier":"urn:air::server:plintho-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"plintho-mcp","summary":"MCP server + CLI for the plintho voice journal","description":"# plintho-mcp\n\nA small CLI + [MCP](https://modelcontextprotocol.io) server that lets any\nMCP-capable client (Claude Desktop, Cursor, Cline, Zed, …) query the\nplintho voice-journal backend on behalf of a single user.\n\n## Install\n\n```bash\npipx install plintho-mcp          # recommended\npip  install plintho-mcp          # alternative\n```\n\nOr from source:\n\n```bash\ngit clone https://github.com/vtech-ai/plintho-mcp.git\ncd plintho-mcp\npipx install -e .\n```\n\nRequires Python 3.11+. Runtime deps: `mcp`, `httpx`. The package does\n**not** pull in any of the plintho backend's heavy dependencies.\n\n## Pair this device with your account\n\n```bash\n$ plintho-mcp login --name \"MacBook Cursor\"\n配对码: WXYZ-2345\n请在 plintho iOS app → Settings → MCP Access 输入此码\n等待中...\n✓ 已登录为 user-abc\n```\n\nThe token is saved to `~/.plintho/mcp_token` (mode 600). The plaintext\nexists only on this machine; the server stores only its sha256 hash.\n\n## Wire into your MCP client\n\n### Claude Desktop — `claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"plintho\": { \"command\": \"plintho-mcp\" }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add plintho -- plintho-mcp\n```\n\n### Cursor — `~/.cursor/mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"plintho\": { \"command\": \"plintho-mcp\" }\n  }\n}\n```\n\nSame `command` key works for Cline / Zed / Continue / any stdio-MCP client.\n\n## Tools exposed\n\n| Tool                   | What it does                                                            |\n| ---------------------- | ----------------------------------------------------------------------- |\n| `list_events_by_date`  | All events on a given date (YYYY-MM-DD or `today`/`yesterday`).         |\n| `get_event_detail`     | One event's note (Markdown) + raw utterances.                           |\n| `search_events`        | Free-text search across event titles/summaries/notes, optional date.    |\n| `search_utterances`    | Substring search across raw transcribed utterances.                     |\n| `get_daily_summary`    | Daily s…","publisher":{"name":"vtech-ai","url":null},"homepage":"https://plintho.app","repository":null,"version":"0.2.1","license":null,"protocols":["mcp"],"tags":["mcp","voice-journal","plintho"],"pricing":null,"endpoints":[{"url":"pypi:plintho-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","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"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":"plintho-mcp","registry":"pypi","observedAt":"2026-11-10T00:24:24.094Z","publishedAt":"2026-10-12T02:45:15.526209Z","latestVersion":"0.2.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"plintho-mcp","url":"https://pypi.org/project/plintho-mcp/","firstSeenAt":"2026-09-10T10:23:15.465Z","fetchedAt":"2026-11-10T00:22:38.981Z","normalizedAt":"2026-11-10T00:22:38.981Z"}]},"firstSeenAt":"2026-09-10T10:23:15.465Z","updatedAt":"2026-11-10T00:24:24.094Z"}