{"_id":"@aiosbrain/mcp","_rev":"4-242962cf1cefe253c2c865efc43ed64b","name":"@aiosbrain/mcp","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.0":{"name":"@aiosbrain/mcp","version":"0.1.0","license":"AGPL-3.0-only","_id":"@aiosbrain/mcp@0.1.0","maintainers":[{"name":"cn_fuser","email":"chetan.nandakumar@gmail.com"},{"name":"iamjohndass","email":"john@john-ellison.com"}],"homepage":"https://github.com/aiosbrain/aios-workspace#readme","bugs":{"url":"https://github.com/aiosbrain/aios-workspace/issues"},"bin":{"aios-brain-mcp":"bin/aios-brain-mcp.mjs"},"dist":{"shasum":"8617089664a9da6c15ee9786beb44ccdba60b61d","tarball":"https://registry.npmjs.org/@aiosbrain/mcp/-/mcp-0.1.0.tgz","fileCount":15,"integrity":"sha512-5bhbsgMiy/wNXEXAaA671Lk29HOiVfO+YNDbOGgkYqz7Mxak5Rn7Q/uWVnfUNdSGmcPojHucgtaY7vy4hktOug==","signatures":[{"sig":"MEUCIQDZuCH/KXjM80SO5+zz2EDKB6qAHjVJBt3JOfOsSOEXgAIgFkbWHrYlr1GSkIb6TvdwDJntZ1mhPiwrftFQ7otglWY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":90911},"type":"module","_from":"file:/tmp/aio-1111-release-9e52/mcp-candidate/aiosbrain-mcp-0.1.0.tgz","engines":{"node":">=22"},"_npmUser":{"name":"iamjohndass","email":"john@john-ellison.com"},"_resolved":"/tmp/aio-1111-release-9e52/mcp-candidate/aiosbrain-mcp-0.1.0.tgz","_integrity":"sha512-5bhbsgMiy/wNXEXAaA671Lk29HOiVfO+YNDbOGgkYqz7Mxak5Rn7Q/uWVnfUNdSGmcPojHucgtaY7vy4hktOug==","repository":{"url":"git+https://github.com/aiosbrain/aios-workspace.git","type":"git","directory":"packages/mcp"},"_npmVersion":"12.0.2","description":"Read-only AIOS Team Brain MCP server with zero runtime dependencies","directories":{},"_nodeVersion":"24.19.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1788868067960_0.9302898113259839","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@aiosbrain/mcp","version":"0.1.1","license":"AGPL-3.0-only","_id":"@aiosbrain/mcp@0.1.1","maintainers":[{"name":"cn_fuser","email":"chetan.nandakumar@gmail.com"},{"name":"iamjohndass","email":"john@john-ellison.com"}],"homepage":"https://github.com/aiosbrain/aios-workspace#readme","bugs":{"url":"https://github.com/aiosbrain/aios-workspace/issues"},"bin":{"aios-brain-mcp":"bin/aios-brain-mcp.mjs"},"dist":{"shasum":"b3bd99f467b14f76bfbfe64ae429c7215c04f78f","tarball":"https://registry.npmjs.org/@aiosbrain/mcp/-/mcp-0.1.1.tgz","fileCount":15,"integrity":"sha512-6IDfKK/Ml7eMrzhO1JLrkGh8XbeWqJXlxHaJ90o8TIN0yrI5ipFZTcBN14/yq9gxAht5LKO5fZ+q3rFamnoXBg==","signatures":[{"sig":"MEYCIQDVCkDOCpv8rkDrDAIgHwib9756jQrMh1pFXwwKcHMOkQIhAPUgazwmQu9ZXwMmgdxbKYHw9CwfF4MjMwX5FvB5InWN","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aiosbrain%2fmcp@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":91703},"type":"module","_from":"file:/home/runner/work/aios-workspace/aios-workspace/.tmp/mcp-release/mcp-candidate/aiosbrain-mcp-0.1.1.tgz","engines":{"node":">=22"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:2bdd3879-b7d8-4631-a600-ad4cb148e8b5"}},"_resolved":"/home/runner/work/aios-workspace/aios-workspace/.tmp/mcp-release/mcp-candidate/aiosbrain-mcp-0.1.1.tgz","_integrity":"sha512-6IDfKK/Ml7eMrzhO1JLrkGh8XbeWqJXlxHaJ90o8TIN0yrI5ipFZTcBN14/yq9gxAht5LKO5fZ+q3rFamnoXBg==","repository":{"url":"git+https://github.com/aiosbrain/aios-workspace.git","type":"git","directory":"packages/mcp"},"_npmVersion":"12.0.2","description":"Read-only AIOS Team Brain MCP server with zero runtime dependencies","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1789017344191_0.1561363370608042","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@aiosbrain/mcp","version":"0.2.0","license":"AGPL-3.0-only","_id":"@aiosbrain/mcp@0.2.0","maintainers":[{"name":"cn_fuser","email":"chetan.nandakumar@gmail.com"},{"name":"iamjohndass","email":"john@john-ellison.com"}],"homepage":"https://github.com/aiosbrain/aios-workspace#readme","bugs":{"url":"https://github.com/aiosbrain/aios-workspace/issues"},"bin":{"aios-brain-mcp":"bin/aios-brain-mcp.mjs"},"dist":{"shasum":"3df4b3cfeab45fac94dcac0dfd4f65d83e601286","tarball":"https://registry.npmjs.org/@aiosbrain/mcp/-/mcp-0.2.0.tgz","fileCount":15,"integrity":"sha512-OFqYkuIBKHnd1mGpNLv81QhaOBKSxNKx0Mc0DP6R6X5nFaplknSA7qESq8OHnpf94THiW+NFZdWtWtJR0JLgXg==","signatures":[{"sig":"MEQCIHXAn7a1W6OtHYyxYASMTcDODZzdGctjpjSXbtCc6M/2AiAHm35N1eM3SjwkmraEDgQPv07+cxtzimuuQPrjmjMrrQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQC5FBzU2bnX7LpJcV98r1zK1vJiBOmeTxck+bOP5ISMDgIhAMxXDx1vIJ1/yBZ0NWCjloSoB05X1+xgwmW3nIZcbaPV","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aiosbrain%2fmcp@0.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":96177},"type":"module","_from":"file:/home/runner/work/aios-workspace/aios-workspace/.tmp/mcp-release/mcp-candidate/aiosbrain-mcp-0.2.0.tgz","engines":{"node":">=22"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:2bdd3879-b7d8-4631-a600-ad4cb148e8b5"}},"_resolved":"/home/runner/work/aios-workspace/aios-workspace/.tmp/mcp-release/mcp-candidate/aiosbrain-mcp-0.2.0.tgz","_integrity":"sha512-OFqYkuIBKHnd1mGpNLv81QhaOBKSxNKx0Mc0DP6R6X5nFaplknSA7qESq8OHnpf94THiW+NFZdWtWtJR0JLgXg==","repository":{"url":"git+https://github.com/aiosbrain/aios-workspace.git","type":"git","directory":"packages/mcp"},"_npmVersion":"12.0.2","description":"Read-only AIOS Team Brain MCP server with zero runtime dependencies","directories":{},"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.0_1789644078456_0.5998959296894701","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"_id":"@aiosbrain/mcp@0.2.1","bin":{"aios-brain-mcp":"bin/aios-brain-mcp.mjs"},"bugs":{"url":"https://github.com/aiosbrain/aios-workspace/issues"},"dist":{"shasum":"de2c78d5b0877476b1af4659b74e730ed5110134","tarball":"https://registry.npmjs.org/@aiosbrain/mcp/-/mcp-0.2.1.tgz","fileCount":15,"integrity":"sha512-+YNY05QMYyNwC56U3V5oFS7uKToSr9mTNGZeha1waq8grhB32WyHnluRnKS6mO4LKi8ueiEpI4H3xDknR5Pb1Q==","signatures":[{"sig":"MEUCIC/e9LpInrwBdfrZZRNwA9EMp+Jc+W0F9GRsz4gnC3KCAiEAzPlPRTLWJxNENpl012ayMqQQ7f0UpTDpKUukpxMQfwg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDRgL2xO2bzXrKx5f3ggDRiRt5U8+lk9U7ZevY+UMRTUgIhAPlJEW/urwOED+hmrxYPdAotYwsQOlnHb366cYATgkqi"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aiosbrain%2fmcp@0.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":96431},"name":"@aiosbrain/mcp","type":"module","_from":"file:/home/runner/work/aios-workspace/aios-workspace/.tmp/mcp-release/mcp-candidate/aiosbrain-mcp-0.2.1.tgz","engines":{"node":">=22"},"license":"AGPL-3.0-only","version":"0.2.1","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:2bdd3879-b7d8-4631-a600-ad4cb148e8b5"}},"homepage":"https://github.com/aiosbrain/aios-workspace#readme","_resolved":"/home/runner/work/aios-workspace/aios-workspace/.tmp/mcp-release/mcp-candidate/aiosbrain-mcp-0.2.1.tgz","_integrity":"sha512-+YNY05QMYyNwC56U3V5oFS7uKToSr9mTNGZeha1waq8grhB32WyHnluRnKS6mO4LKi8ueiEpI4H3xDknR5Pb1Q==","repository":{"url":"git+https://github.com/aiosbrain/aios-workspace.git","type":"git","directory":"packages/mcp"},"_npmVersion":"12.0.2","description":"Read-only AIOS Team Brain MCP server with zero runtime dependencies","directories":{},"maintainers":[{"name":"cn_fuser","email":"chetan.nandakumar@gmail.com"},{"name":"iamjohndass","email":"john@john-ellison.com"}],"_nodeVersion":"22.23.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.2.1_1789645430350_0.770457222899368"}}},"time":{"created":"2026-09-08T11:47:47.760Z","modified":"2026-09-17T11:43:50.750Z","0.1.0":"2026-09-08T11:47:48.089Z","0.1.1":"2026-09-10T05:15:44.439Z","0.2.0":"2026-09-17T11:21:18.550Z","0.2.1":"2026-09-17T11:43:50.440Z"},"bugs":{"url":"https://github.com/aiosbrain/aios-workspace/issues"},"license":"AGPL-3.0-only","homepage":"https://github.com/aiosbrain/aios-workspace#readme","repository":{"url":"git+https://github.com/aiosbrain/aios-workspace.git","type":"git","directory":"packages/mcp"},"description":"Read-only AIOS Team Brain MCP server with zero runtime dependencies","maintainers":[{"name":"cn_fuser","email":"chetan.nandakumar@gmail.com"},{"name":"iamjohndass","email":"john@john-ellison.com"}],"readme":"# @aiosbrain/mcp\n\nRead-only access to an AIOS Team Brain from an MCP host. Requires Node.js 22 or newer;\nno AIOS checkout, global toolkit installation, native modules or runtime dependencies.\n\nStart with `npx -y @aiosbrain/mcp@0.2.1`. Configure `AIOS_BRAIN_URL` and `AIOS_API_KEY`,\nor use the owner-only default tuple in `~/.aios/credentials.json`:\n\n```json\n{\n  \"version\": 1,\n  \"default\": {\n    \"brain_url\": \"https://brain.example.com\",\n    \"api_key\": \"<your API key>\"\n  }\n}\n```\n\nKeep this file private (`chmod 600` on POSIX; owner-only ACL on Windows). Host\nconfiguration should contain the version-pinned command, never the API key. The host\ninstaller is tracked separately in AIO-1112; do not assume it is available in your toolkit.\n\nEnvironment credentials take precedence. Existing `.env` and `aios.yaml` configuration\nremains supported. Stored credentials are tied to their Brain origin: changing the URL\nalone cannot send a stored key to another server. An environment key needs an explicit\nor existing workspace URL; it never borrows a URL from the global credential file.\n\nStartup performs one `/api/v1/me` probe with a three-second deadline. Team members get\nall nine Brain tools; external members get the five `brain` tools. Missing configuration,\nrevoked credentials, delegated tokens, malformed identity responses and network failures\nregister no Brain tools and produce a diagnostic on stderr. Availability stays fixed until\nrestart; the Brain checks authorization on every call, including after membership changes.\n\n| Toolset | Tools |\n| --- | --- |\n| `brain` | `brain_status`, `brain_search_evidence`, `brain_query`, `brain_pull_items`, `brain_get_item` |\n| `board` | `brain_list_projects`, `brain_list_tasks`, `brain_list_decisions`, `brain_stakeholders` |\n\n`--toolsets brain,board` overrides `AIOS_MCP_TOOLSETS`. Repeated `--tools <name>` adds tools;\nexplicit selections form a union and then intersect with the permitted surface. `all` selects\nall permitted tools. The workspace collector is available only in the toolkit's `aios mcp`.\n\nTransport is newline-delimited stdio, with serialized JSON-RPC responses on stdout and\nall diagnostics on stderr. Initialize returns protocol `2025-11-25` and this package's\nversion. Query answers preserve citation markers and source lists. This package does not\nprovide a remote HTTP endpoint or write tools.\n\nMaintainers: generate and pack from the committed candidate with\n`node packages/mcp-build/pack.mjs --out <new-artifact-directory>` in the source repository.\nPublish the accepted tarball, never the unbuilt source directory.\n\n\n### Evidence-first answers\n\n`brain_search_evidence` (Brain API 1.27+) returns ranked source passages, citations, dates and recorded contributor roles without calling an answering model. The host composes the answer and can expand sources with `brain_get_item`. It belongs to the read-only `brain` toolset. Arguments: `query`, optional `project`, optional `limit` (default 8, max20). Responses remain valid JSON under 20,000 characters; truncation is disclosed. Older servers report upgrade required, and HTTP failures are never converted to no matches. No additional key or hosted MCP service is required.\n\n## 0.2.1\n\nExplicit integer evidence-search limits now pass MCP argument validation. The packed\nartifact acceptance test covers an explicit limit of 10 as well as live retrieval.\n","readmeFilename":"README.md"}