{"_id":"@astrivya/mcp-server","_rev":"9-aff2a91a6179613f1a2e77aa0fa18e57","name":"@astrivya/mcp-server","dist-tags":{"latest":"0.5.0"},"versions":{"0.1.0":{"name":"@astrivya/mcp-server","version":"0.1.0","keywords":["mcp","model-context-protocol","llm","knowledge-graph","astrivya"],"license":"Apache-2.0","_id":"@astrivya/mcp-server@0.1.0","maintainers":[{"name":"amruth_jakku","email":"amruthjakku@gmail.com"}],"homepage":"https://github.com/astrivya/astrivya/tree/main/packages/mcp-server#readme","bugs":{"url":"https://github.com/astrivya/astrivya/issues"},"bin":{"astrivya-mcp":"dist/index.js"},"dist":{"shasum":"17eedfd547ecbf61e8697ac2ceddaf7477404ff3","tarball":"https://registry.npmjs.org/@astrivya/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":5,"integrity":"sha512-LId69uRSoGutTPND97RWgGAukCMPYl0slfy9Vdtf72UvCafZO/6G6Wn0hdaZFRhq1t5+75WA0Z5LDCsu4DoEBw==","signatures":[{"sig":"MEYCIQDLTbfybuYB+mA6bryURzT+GsLlcFnN0dfSOaueGqnuTgIhAIoxvTT9km9az5ZwTIg9/Dspt5nIgDIVnxQW3pqgUQcT","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":100040},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./package.json":"./package.json"},"gitHead":"a0d4043a0fa06ff9e547fd8581aea3354d4f4474","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsup","start":"node dist/index.js","typecheck":"tsc --noEmit --project tsconfig.json","test:watch":"vitest","prepublishOnly":"npm run typecheck && npm run build"},"_npmUser":{"name":"amruth_jakku","email":"amruthjakku@gmail.com"},"repository":{"url":"git+https://github.com/astrivya/astrivya.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.6.2","description":"Model Context Protocol server for Astrivya Knowledge Graph — 13 tools for AI coding agents to read/write/query the AKG","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^3.24.1","env-paths":"^2.2.1","@astrivya/plugin-api":"^0.1.0","@astrivya/plugin-runtime":"^0.1.0","@modelcontextprotocol/sdk":"^1.16.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","tsup":"^8.5.1","vitest":"^4.1.8","typescript":"^5.0.0","@types/node":"^20.19.43"},"peerDependencies":{"typescript":"^5.0.0","@astrivya/akg-core":"^0.1.0"},"peerDependenciesMeta":{"typescript":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1786184992501_0.9076524919691111","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@astrivya/mcp-server","version":"0.2.1","keywords":["mcp","model-context-protocol","llm","knowledge-graph","astrivya"],"license":"Apache-2.0","_id":"@astrivya/mcp-server@0.2.1","maintainers":[{"name":"amruth_jakku","email":"amruthjakku@gmail.com"}],"homepage":"https://github.com/astrivya/astrivya/tree/main/packages/mcp-server#readme","bugs":{"url":"https://github.com/astrivya/astrivya/issues"},"bin":{"astrivya-mcp":"dist/index.js"},"dist":{"shasum":"3a386a581f19f842875a774798ac3f1bffd9b943","tarball":"https://registry.npmjs.org/@astrivya/mcp-server/-/mcp-server-0.2.1.tgz","fileCount":6,"integrity":"sha512-42wp8njcq+wkffjSMNQs2Ve9ExhsriscGY6du2O3lNBjTu80GyTE3RaFfrLLgsKCFxSkJevAjskCRteEg0MDqQ==","signatures":[{"sig":"MEUCIHP9gZXcqzPV8Qu3UnIQrO9HlhDy/mmMREckiJCFZo22AiEA3Zfz847lja9ztjGsC6iH+BoUKrDY8MY01KgBezhg3vQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":181746},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./package.json":"./package.json"},"gitHead":"befa6df35c402d3730dcf6c455dae23a7ac2426b","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsup","start":"node dist/index.js","typecheck":"tsc --noEmit --project tsconfig.json","test:watch":"vitest","prepublishOnly":"npm run typecheck && npm run build"},"_npmUser":{"name":"amruth_jakku","email":"amruthjakku@gmail.com"},"repository":{"url":"git+https://github.com/astrivya/astrivya.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for Astrivya Knowledge Graph — 13 tools for AI coding agents to read/write/query the AKG","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.24.1","env-paths":"^2.2.1","@astrivya/plugin-api":"^0.2.0","@astrivya/akg-indexer":"^0.2.0","@astrivya/plugin-runtime":"^0.2.0","@modelcontextprotocol/sdk":"^1.16.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","tsup":"^8.5.1","vitest":"^4.1.8","typescript":"^5.0.0","@types/node":"^20.19.43"},"peerDependencies":{"typescript":"^5.0.0","@astrivya/akg-core":"^0.2.0"},"peerDependenciesMeta":{"typescript":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.2.1_1786557015089_0.6794336055181098","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@astrivya/mcp-server","version":"0.3.0","keywords":["mcp","model-context-protocol","llm","knowledge-graph","astrivya"],"license":"Apache-2.0","_id":"@astrivya/mcp-server@0.3.0","maintainers":[{"name":"amruth_jakku","email":"amruthjakku@gmail.com"}],"homepage":"https://github.com/astrivya/astrivya/tree/main/packages/mcp-server#readme","bugs":{"url":"https://github.com/astrivya/astrivya/issues"},"bin":{"astrivya-mcp":"dist/index.js"},"dist":{"shasum":"e4fe82d654a79589b9c98d4875e71813b3436ef4","tarball":"https://registry.npmjs.org/@astrivya/mcp-server/-/mcp-server-0.3.0.tgz","fileCount":6,"integrity":"sha512-Z6VyPxq4PG+p+CaDJz6sq5pvTPyv7j7bWNuhx2KaCUSwcO7i3QD8QbNtnhzBDaGzaD3TFq3XY5y7WYUbgyiMrA==","signatures":[{"sig":"MEUCIQCx8nuoFM0aFDWSeN6apKXWQph65A/SWSA5EDjrlGWlHQIgXaNzgkkhaF2fhEYHUvb92IqXRX1awQ8nXQstjGiNcdc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":182019},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./package.json":"./package.json"},"gitHead":"1da24ba6588ae6cfc89be554110db79732fea5de","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsup","start":"node dist/index.js","typecheck":"tsc --noEmit --project tsconfig.json","test:watch":"vitest","prepublishOnly":"npm run typecheck && npm run build"},"_npmUser":{"name":"amruth_jakku","email":"amruthjakku@gmail.com"},"repository":{"url":"git+https://github.com/astrivya/astrivya.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for Astrivya Knowledge Graph — 18 tools for AI coding agents to read/write/query the AKG","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.24.1","env-paths":"^2.2.1","@astrivya/plugin-api":"^0.3.0","@astrivya/akg-indexer":"^0.3.0","@astrivya/plugin-runtime":"^0.3.0","@modelcontextprotocol/sdk":"^1.16.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","tsup":"^8.5.1","vitest":"^4.1.8","typescript":"^5.0.0","@types/node":"^20.19.43"},"peerDependencies":{"typescript":"^5.0.0","@astrivya/akg-core":"^0.3.0"},"peerDependenciesMeta":{"typescript":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.3.0_1786617918084_0.7469620717160743","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@astrivya/mcp-server","version":"0.4.0","keywords":["mcp","model-context-protocol","llm","knowledge-graph","astrivya"],"license":"Apache-2.0","_id":"@astrivya/mcp-server@0.4.0","maintainers":[{"name":"amruth_jakku","email":"amruthjakku@gmail.com"}],"homepage":"https://github.com/astrivya/astrivya/tree/main/packages/mcp-server#readme","bugs":{"url":"https://github.com/astrivya/astrivya/issues"},"bin":{"astrivya-mcp":"dist/index.js"},"dist":{"shasum":"2ad9ac2a0fb7fde13c21cfeb0b6a4fd29ec86c04","tarball":"https://registry.npmjs.org/@astrivya/mcp-server/-/mcp-server-0.4.0.tgz","fileCount":6,"integrity":"sha512-tbuW+vLK9h2MG425/gMjZ4Vkxa5t3IT1O9nz2ev1cEl/nQ/F8B4awaOVgjhNlYbDUieDvrAAh02Pu94xk30NwQ==","signatures":[{"sig":"MEUCIBF/KFaL2JNR4c+DPr4vSqWjCgZqqFPvAJkC+sBXjRvYAiEAqtAdfY7p3nvvOj8pxSkyglLJEhCgRlwcakz6xx2PDjI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":261473},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./package.json":"./package.json"},"gitHead":"460d11b8c18e7c2607aa67550003181a6d570673","scripts":{"dev":"tsx watch src/index.ts","test":"vitest run","build":"tsup","start":"node dist/index.js","typecheck":"tsc --noEmit --project tsconfig.json","test:watch":"vitest","prepublishOnly":"npm run typecheck && npm run build"},"_npmUser":{"name":"amruth_jakku","email":"amruthjakku@gmail.com"},"repository":{"url":"git+https://github.com/astrivya/astrivya.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"10.8.2","description":"Model Context Protocol server for Astrivya Knowledge Graph — 18 tools for AI coding agents to read/write/query the AKG","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^3.24.1","env-paths":"^2.2.1","@astrivya/plugin-api":"^0.4.0","@astrivya/akg-indexer":"^0.4.0","@astrivya/plugin-runtime":"^0.4.0","@modelcontextprotocol/sdk":"^1.16.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","tsup":"^8.5.1","vitest":"^4.1.8","typescript":"^5.0.0","@types/node":"^20.19.43"},"peerDependencies":{"typescript":"^5.0.0","@astrivya/akg-core":"^0.4.0"},"peerDependenciesMeta":{"typescript":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.4.0_1786700078042_0.11294533756177727","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@astrivya/mcp-server","version":"0.5.0","description":"Model Context Protocol server for Astrivya Knowledge Graph — 18 tools for AI coding agents to read/write/query the AKG","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./package.json":"./package.json"},"engines":{"node":">=20"},"scripts":{"start":"node dist/index.js","dev":"tsx watch src/index.ts","build":"tsup","typecheck":"tsc --noEmit --project tsconfig.json","prepublishOnly":"npm run typecheck && npm run build","test":"vitest run","test:watch":"vitest"},"dependencies":{"@astrivya/akg-indexer":"^0.5.0","@astrivya/plugin-api":"^0.5.0","@astrivya/plugin-runtime":"^0.5.0","@modelcontextprotocol/sdk":"^1.16.0","env-paths":"^2.2.1","zod":"^3.24.1"},"peerDependencies":{"@astrivya/akg-core":"^0.5.0","typescript":"^5.0.0"},"peerDependenciesMeta":{"typescript":{"optional":true}},"devDependencies":{"@types/node":"^20.19.43","tsup":"^8.5.1","tsx":"^4.19.0","typescript":"^5.0.0","vitest":"^4.1.8"},"keywords":["mcp","model-context-protocol","llm","knowledge-graph","astrivya"],"license":"Apache-2.0","publishConfig":{"access":"public"},"bin":{"astrivya-mcp":"dist/index.js"},"repository":{"type":"git","url":"git+https://github.com/astrivya/astrivya.git","directory":"packages/mcp-server"},"homepage":"https://github.com/astrivya/astrivya/tree/main/packages/mcp-server#readme","bugs":{"url":"https://github.com/astrivya/astrivya/issues"},"_id":"@astrivya/mcp-server@0.5.0","gitHead":"859bac2e8372135c6dac12e492a6578556830315","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-Co1MjiMZsUfEKPVliPOIhSIfWIiQCGa1s9s6GM7rjZBfcPww61iq6PsWoQWX1Oa9G+3chbTIcD1gDKogPKhY+g==","shasum":"78afa845db3181536421b4b517832d74082be87d","tarball":"https://registry.npmjs.org/@astrivya/mcp-server/-/mcp-server-0.5.0.tgz","fileCount":6,"unpackedSize":262588,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBUbGfdtEpwQHiuhUrDMO+zeKNrm/7vq0iqYbeaVSYFpAiEAh2zG0uc/wQgaGfNK7edZgW+KrnRrxD0UwHDEEdNlVoQ="}]},"_npmUser":{"name":"amruth_jakku","email":"amruthjakku@gmail.com"},"directories":{},"maintainers":[{"name":"amruth_jakku","email":"amruthjakku@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.5.0_1786735767090_0.9243714523124034"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-08T10:29:52.367Z","modified":"2026-08-14T19:29:27.415Z","1.0.0":"2026-06-10T05:22:56.926Z","0.1.0":"2026-08-08T10:29:52.702Z","0.2.1":"2026-08-12T17:50:15.226Z","0.3.0":"2026-08-13T10:45:18.252Z","0.4.0":"2026-08-14T09:34:38.174Z","0.5.0":"2026-08-14T19:29:27.234Z"},"bugs":{"url":"https://github.com/astrivya/astrivya/issues"},"license":"Apache-2.0","homepage":"https://github.com/astrivya/astrivya/tree/main/packages/mcp-server#readme","keywords":["mcp","model-context-protocol","llm","knowledge-graph","astrivya"],"repository":{"type":"git","url":"git+https://github.com/astrivya/astrivya.git","directory":"packages/mcp-server"},"description":"Model Context Protocol server for Astrivya Knowledge Graph — 18 tools for AI coding agents to read/write/query the AKG","maintainers":[{"name":"amruth_jakku","email":"amruthjakku@gmail.com"}],"readme":"# @astrivya/mcp-server\n\n**Model Context Protocol server** for the Astrivya Knowledge Graph. Provides 18 tools that any MCP-compatible client (Claude Desktop, Cursor, Cline, VS Code with Continue, etc.) can use to read, write, and search your local knowledge graph.\n\n```sh\nnpm install -g @astrivya/mcp-server\n\n# Run with stdio transport (default for Claude Desktop)\nastrivya-mcp\n\n# Or as HTTP/SSE on port 3001\nastrivya-mcp --http --port 3001\n```\n\n## Setup\n\n### Claude Desktop\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"astrivya\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@astrivya/mcp-server\"]\n    }\n  }\n}\n```\n\n### VS Code with Continue\n\nAdd to `~/.continue/config.json`:\n\n```json\n{\n  \"experimental\": {\n    \"mcpServers\": {\n      \"astrivya\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"@astrivya/mcp-server\"]\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | Input | Description |\n|------|-------|-------------|\n| `search_memories` | `query`, `limit?` | Search the knowledge graph with semantic ranking |\n| `get_team_context` | `team_id?` | Workspace context (nodes, edges, chunks stats) |\n| `get_person_context` | — | Current workspace status |\n| `get_mcp_status` | — | MCP server health: uptime, sessions, tool call counters, recent events |\n| `log_decision` | `title`, `content`, `file_context?` | Record a design decision |\n| `log_memory` | `content`, `type?`, `visibility?` | Store a custom fact or insight |\n| `search_connectors` | `query`, `limit?` | Search indexed content chunks |\n| `get_daily_briefing` | `limit?` | Recent workspace activity |\n| `find_related_knowledge` | `term`, `limit?` | Semantic search for related concepts |\n| `get_expertise_profile` | `team_id?` | Workspace knowledge composition |\n| `trace_decision` | `decision_id` | Trace a decision's graph neighborhood |\n| `get_team_members` | `team_id?` | (Requires Astrivya Cloud API) |\n| `get_team_analytics` | `team_id?` | (Requires Astrivya Cloud API) |\n| `list_notifications` | `unread?`, `type?`, `limit?` | (Requires Astrivya Cloud API) |\n| `mark_notification_read` | `notification_id?` | (Requires Astrivya Cloud API) |\n| `check_credits` | — | Live credit balance, lifetime usage, recent transactions (cloud; fails gracefully offline) |\n| `get_context_digest` | `limit?` | Compact pre-digested context for session start (prose) |\n| `get_workspace_updates` | `since?`, `limit?` | Knowledge-graph changes since a timestamp (delta) |\n\n> Cloud-requiring tools gracefully fall back to local AKG stats when the cloud API is unavailable.\n\n## Resources\n\n| URI | Description |\n|-----|-------------|\n| `astrivya://team/active/knowledge` | Workspace metadata |\n| `astrivya://user/active/memories` | Personal memory summary |\n| `astrivya://briefing/today` | Recent activity |\n| `astrivya://org/knowledge-graph` | All nodes in the graph |\n\n## Environment\n\n| Variable | Description |\n|----------|-------------|\n| `ASTRIVYA_WORKSPACE_PATH` | Workspace root (default: `cwd`) |\n| `ASTRIVYA_TOKEN` | Cloud API token (optional, for sync) |\n| `ASTRIVYA_SYNC_KEY` | Sync API key (optional) |\n| `ASTRIVYA_CLOUD_URL` | Cloud API URL (optional)      |\n\n## Telemetry\n\nThe MCP server sends **anonymous, opt-out** usage stats (server starts/stops,\nsession start/end, tool names, client name, and a random install id) to PostHog\nso we can improve the product. **No code, paths, arguments, query content,\ntokens, or any other sensitive data is ever collected.** Tool calls are sampled\nat most once per session per tool.\n\n- You'll see a one-time notice on stderr at startup.\n- Disable with `ASTRIVYA_TELEMETRY=off` or `NO_TELEMETRY=1`.\n- Telemetry is automatically disabled in CI environments.\n\n## License\n\nApache 2.0\n","readmeFilename":"README.md"}