{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_5hra7zaw9hwu","handle":"ragdesk-mcp","url":"https://wellknown.network/agents/ragdesk-mcp","links":{"self":"https://wellknown.network/agents/ragdesk-mcp/record.json","html":"https://wellknown.network/agents/ragdesk-mcp","markdown":"https://wellknown.network/agents/ragdesk-mcp/record.md","api":"https://wellknown.network/api/v1/agents/ragdesk-mcp","status":"https://wellknown.network/api/v1/agents/ragdesk-mcp/status","claim":"https://wellknown.network/agents/ragdesk-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/ragdesk-mcp/claim.json","badge":"https://wellknown.network/agents/ragdesk-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/ragdesk-mcp/history","tools":"https://wellknown.network/api/v1/agents/ragdesk-mcp/tools"},"ard":{"identifier":"urn:air::server:ragdesk-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"ragdesk-mcp","summary":"MCP server for ragdesk - list KBs, ingest text, and ask your local RAG API","description":"# ragdesk-mcp\n\nMCP server for [ragdesk](https://github.com/Moca-H/ragdesk). Talk to your local RAG API from Cursor / Claude Desktop via tools.\n\n## Prerequisites\n\n1. A running ragdesk API (e.g. `npm run dev` or Docker) at `http://127.0.0.1:8000`\n2. Python 3.11+ (for local install) or [`uv`](https://github.com/astral-sh/uv) for `uvx`\n\n## Install from PyPI\n\n```bash\nuvx ragdesk-mcp\n```\n\nOr:\n\n```bash\npip install ragdesk-mcp\nragdesk-mcp\n```\n\n## Cursor `mcp.json` example\n\n```json\n{\n  \"mcpServers\": {\n    \"ragdesk\": {\n      \"command\": \"uvx\",\n      \"args\": [\"ragdesk-mcp\"],\n      \"env\": {\n        \"RAGDESK_API_BASE\": \"http://127.0.0.1:8000\",\n        \"RAGDESK_KB\": \"default\"\n      }\n    }\n  }\n}\n```\n\nLocal checkout (dev):\n\n```json\n{\n  \"mcpServers\": {\n    \"ragdesk\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"ragdesk_mcp.server\"],\n      \"cwd\": \"D:/Moca/ragdesk/apps/mcp\",\n      \"env\": {\n        \"PYTHONPATH\": \"D:/Moca/ragdesk/apps/mcp/src\",\n        \"RAGDESK_API_BASE\": \"http://127.0.0.1:8000\"\n      }\n    }\n  }\n}\n```\n\n## Environment\n\n| Variable | Default | Meaning |\n|----------|---------|---------|\n| `RAGDESK_API_BASE` | `http://127.0.0.1:8000` | ragdesk API root |\n| `RAGDESK_KB` | `default` | Default knowledge base id |\n| `RAGDESK_API_TOKEN` | _(empty)_ | Optional `Authorization: Bearer` |\n\n## Tools\n\n- `ragdesk_health` — API reachability\n- `list_knowledge_bases` — list KBs\n- `list_documents` — list docs in a KB\n- `ingest_text` — upload markdown/text into a KB\n- `import_sample` — import welcome sample\n- `ask` — RAG / agent Q&A with citations\n\n## Develop\n\n```bash\ncd apps/mcp\npip install -e .\nragdesk-mcp\n```\n\n## Publish\n\nGitHub Actions publishes to PyPI when you push a tag:\n\n```bash\ngit tag ragdesk-mcp-v0.1.0\ngit push origin ragdesk-mcp-v0.1.0\n```\n\nRequires repository secret `PYPI_API_TOKEN` (PyPI API token, username `__token__`).","publisher":{"name":"Moca-H","url":null},"homepage":"https://github.com/Moca-H/ragdesk","repository":"https://github.com/Moca-H/ragdesk","version":"0.1.2","license":"MIT","protocols":["mcp"],"tags":["llm","mcp","rag","ragdesk"],"pricing":null,"endpoints":[{"url":"pypi:ragdesk-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.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"declared"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":0.802,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.722,"provenance":"derived"}],"categories":["data","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":"ragdesk-mcp","registry":"pypi","observedAt":"2026-11-03T23:22:48.663Z","publishedAt":"2026-10-21T07:33:49.820041Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"ragdesk-mcp","url":"https://pypi.org/project/ragdesk-mcp/","firstSeenAt":"2026-10-22T18:28:01.501Z","fetchedAt":"2026-11-03T23:20:59.873Z","normalizedAt":"2026-11-03T23:20:59.873Z"}]},"firstSeenAt":"2026-10-22T18:28:01.501Z","updatedAt":"2026-11-03T23:22:48.663Z"}