{"_id":"@biroai/mcp-server","_rev":"6-d9092a793f6da80359dd334c3d85c110","name":"@biroai/mcp-server","dist-tags":{"latest":"2026.513.0","canary":"2026.513.0-canary.1"},"versions":{"2026.512.0-canary.2":{"name":"@biroai/mcp-server","version":"2026.512.0-canary.2","license":"MIT","_id":"@biroai/mcp-server@2026.512.0-canary.2","maintainers":[{"name":"timreactor","email":"tim@reactorjet.com"}],"homepage":"https://github.com/Tim-ReJet/biro","bugs":{"url":"https://github.com/Tim-ReJet/biro/issues"},"bin":{"biro-mcp-server":"dist/stdio.js"},"dist":{"shasum":"8c1b8d6527c2ff5b7bbfee60f56efcbe2720c0ff","tarball":"https://registry.npmjs.org/@biroai/mcp-server/-/mcp-server-2026.512.0-canary.2.tgz","fileCount":59,"integrity":"sha512-LzVtvxgK83qXh96Voa0hzajh1upLfQeeEHJbjQO+OdheZ3N3QnW2Md3og25iKn6BHVWm8OScjGfqZH5vaRraRQ==","signatures":[{"sig":"MEUCIEHlUgewH1qNBSqDuB8qvhaEv6InGsaWdrOyybuu0gquAiEA+Gq5lQMM96759K9/w0FQKFRzjJHiAvRoxlH/fNKGXPg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":205113},"main":"./dist/index.js","type":"module","_from":"file:biroai-mcp-server-2026.512.0-canary.2.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"timreactor","email":"tim@reactorjet.com"},"_resolved":"/private/var/folders/tn/cfqsycsd5k99cmcdx2dbjq_h0000gn/T/d80bf29b34e0ad5deb995ba879a646cc/biroai-mcp-server-2026.512.0-canary.2.tgz","_integrity":"sha512-LzVtvxgK83qXh96Voa0hzajh1upLfQeeEHJbjQO+OdheZ3N3QnW2Md3og25iKn6BHVWm8OScjGfqZH5vaRraRQ==","repository":{"url":"git+https://github.com/Tim-ReJet/biro.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.12.1","description":"Model Context Protocol server for Biro.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.24.2","@biroai/shared":"2026.512.0-canary.2","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.0.5","typescript":"^5.7.3","@types/node":"^24.6.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2026.512.0-canary.2_1778606148599_0.4293278292202045","host":"s3://npm-registry-packages-npm-production"}},"2026.512.0-canary.3":{"name":"@biroai/mcp-server","version":"2026.512.0-canary.3","license":"MIT","_id":"@biroai/mcp-server@2026.512.0-canary.3","maintainers":[{"name":"timreactor","email":"tim@reactorjet.com"}],"homepage":"https://github.com/Tim-ReJet/biro","bugs":{"url":"https://github.com/Tim-ReJet/biro/issues"},"bin":{"biro-mcp-server":"dist/stdio.js"},"dist":{"shasum":"817dabb5fd33f42a81130c305f1f6db758890e73","tarball":"https://registry.npmjs.org/@biroai/mcp-server/-/mcp-server-2026.512.0-canary.3.tgz","fileCount":59,"integrity":"sha512-UvjjUQjk9k90GeiGzTuHtK7hUbUT5yKUK1NjDG6IVaGm1Gv6cOILbJfGhXbJl+jRYfWzJA+fbzKkll38u2MfUA==","signatures":[{"sig":"MEYCIQCpsbofDGT+R/xa7phFmxUnEYr3fn66FbAMUjWY8QqiHAIhALojJEofY6Y4Xw3CNWv8g2I/HSCyb0YOzlk7E69CeSC9","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":205113},"main":"./dist/index.js","type":"module","_from":"file:biroai-mcp-server-2026.512.0-canary.3.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"timreactor","email":"tim@reactorjet.com"},"_resolved":"/private/var/folders/tn/cfqsycsd5k99cmcdx2dbjq_h0000gn/T/0b8466a9f9a08002e537a7462e8408c3/biroai-mcp-server-2026.512.0-canary.3.tgz","_integrity":"sha512-UvjjUQjk9k90GeiGzTuHtK7hUbUT5yKUK1NjDG6IVaGm1Gv6cOILbJfGhXbJl+jRYfWzJA+fbzKkll38u2MfUA==","repository":{"url":"git+https://github.com/Tim-ReJet/biro.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.12.1","description":"Model Context Protocol server for Biro.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.24.2","@biroai/shared":"2026.512.0-canary.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"vitest":"^3.0.5","typescript":"^5.7.3","@types/node":"^24.6.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2026.512.0-canary.3_1778607946247_0.9881413172386675","host":"s3://npm-registry-packages-npm-production"}},"2026.512.0-canary.4":{"name":"@biroai/mcp-server","version":"2026.512.0-canary.4","license":"MIT","_id":"@biroai/mcp-server@2026.512.0-canary.4","maintainers":[{"name":"timreactor","email":"tim@reactorjet.com"}],"homepage":"https://github.com/Tim-ReJet/biro","bugs":{"url":"https://github.com/Tim-ReJet/biro/issues"},"bin":{"biro-mcp-server":"dist/stdio.js"},"dist":{"shasum":"7d25e9b35ccefe779146e979aa1c30125ed7fc22","tarball":"https://registry.npmjs.org/@biroai/mcp-server/-/mcp-server-2026.512.0-canary.4.tgz","fileCount":59,"integrity":"sha512-Tsuyk7tHZLj1mHrTmyfeSEQNJw/PF8hmJdS2GPIWaFiSS8YjY6mQKVp4slf+u/8QW7tVpJbZ8UMHu7WGRL+qxA==","signatures":[{"sig":"MEYCIQDc7ewWMu4pCg+xm0eOLjkebUKteE/zMAFEwNSpzSSYwQIhAKEsBiZhWEoTy4yMBBpGXaPvoQhhWug2ln+7aTMbCRfb","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":205113},"main":"./dist/index.js","type":"module","_from":"file:biroai-mcp-server-2026.512.0-canary.4.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"timreactor","email":"tim@reactorjet.com"},"_resolved":"/private/var/folders/tn/cfqsycsd5k99cmcdx2dbjq_h0000gn/T/b9dac4e537c177c16507af08a53c35ee/biroai-mcp-server-2026.512.0-canary.4.tgz","_integrity":"sha512-Tsuyk7tHZLj1mHrTmyfeSEQNJw/PF8hmJdS2GPIWaFiSS8YjY6mQKVp4slf+u/8QW7tVpJbZ8UMHu7WGRL+qxA==","repository":{"url":"git+https://github.com/Tim-ReJet/biro.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.12.1","description":"Model Context Protocol server for Biro.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.24.2","@biroai/shared":"2026.512.0-canary.4","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"vitest":"^3.0.5","typescript":"^5.7.3","@types/node":"^24.6.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2026.512.0-canary.4_1778609924483_0.7810549503823805","host":"s3://npm-registry-packages-npm-production"}},"2026.513.0-canary.0":{"name":"@biroai/mcp-server","version":"2026.513.0-canary.0","license":"MIT","_id":"@biroai/mcp-server@2026.513.0-canary.0","maintainers":[{"name":"timreactor","email":"tim@reactorjet.com"}],"homepage":"https://github.com/Tim-ReJet/biro","bugs":{"url":"https://github.com/Tim-ReJet/biro/issues"},"bin":{"biro-mcp-server":"dist/stdio.js"},"dist":{"shasum":"2dd1fb45d1f38671387e16942698293a5fde670f","tarball":"https://registry.npmjs.org/@biroai/mcp-server/-/mcp-server-2026.513.0-canary.0.tgz","fileCount":59,"integrity":"sha512-9UXeH/OncFFxh6h4+goadX5nJv5CCTMZV/tjrHU+iP9v1/Az3fqz4SP+rwICUvS9B8J5c7PmHicGx9rWX8Dnrw==","signatures":[{"sig":"MEUCIHQVRUgwD7UOjPBmTc8kC/OxY+vi/4j8eBnl7BH1OEn0AiEAyehA1TdTBY8jOWLE0q102WbxIHZHxo++ra2CjuBBQio=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":205113},"main":"./dist/index.js","type":"module","_from":"file:biroai-mcp-server-2026.513.0-canary.0.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"timreactor","email":"tim@reactorjet.com"},"_resolved":"/private/var/folders/tn/cfqsycsd5k99cmcdx2dbjq_h0000gn/T/0347ad29aa32c0000c5d3ebe9362f9e4/biroai-mcp-server-2026.513.0-canary.0.tgz","_integrity":"sha512-9UXeH/OncFFxh6h4+goadX5nJv5CCTMZV/tjrHU+iP9v1/Az3fqz4SP+rwICUvS9B8J5c7PmHicGx9rWX8Dnrw==","repository":{"url":"git+https://github.com/Tim-ReJet/biro.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.12.1","description":"Model Context Protocol server for Biro.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.24.2","@biroai/shared":"2026.513.0-canary.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"vitest":"^3.0.5","typescript":"^5.7.3","@types/node":"^24.6.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2026.513.0-canary.0_1778636399531_0.05655151575121131","host":"s3://npm-registry-packages-npm-production"}},"2026.513.0-canary.1":{"name":"@biroai/mcp-server","version":"2026.513.0-canary.1","license":"MIT","_id":"@biroai/mcp-server@2026.513.0-canary.1","maintainers":[{"name":"timreactor","email":"tim@reactorjet.com"}],"homepage":"https://github.com/Tim-ReJet/biro","bugs":{"url":"https://github.com/Tim-ReJet/biro/issues"},"bin":{"biro-mcp-server":"dist/stdio.js"},"dist":{"shasum":"b75aaaeb03d5b84d5b88c978a2c71cbab151999b","tarball":"https://registry.npmjs.org/@biroai/mcp-server/-/mcp-server-2026.513.0-canary.1.tgz","fileCount":59,"integrity":"sha512-53SEu5czB0vo5Pr4FupfErgm79LSwRN1BDttOuBNljUc6IiNAkLVyJtwtSe4KQjCp/2kxQf/bB3RW3k5VihrOg==","signatures":[{"sig":"MEUCIGzJsQJCt6cQKhB2juwhCEk9ZElR2nM/rhcyq7kn9uaeAiEA90Rmxtrthrzius7vJKFeSTpgwBU3wikZ4x44zpVL+fw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":205113},"main":"./dist/index.js","type":"module","_from":"file:biroai-mcp-server-2026.513.0-canary.1.tgz","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"test":"vitest run","build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_npmUser":{"name":"timreactor","email":"tim@reactorjet.com"},"_resolved":"/private/var/folders/tn/cfqsycsd5k99cmcdx2dbjq_h0000gn/T/6f69d45e52c25a49f4d5fe04a6111d62/biroai-mcp-server-2026.513.0-canary.1.tgz","_integrity":"sha512-53SEu5czB0vo5Pr4FupfErgm79LSwRN1BDttOuBNljUc6IiNAkLVyJtwtSe4KQjCp/2kxQf/bB3RW3k5VihrOg==","repository":{"url":"git+https://github.com/Tim-ReJet/biro.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.12.1","description":"Model Context Protocol server for Biro.","directories":{},"_nodeVersion":"24.14.1","dependencies":{"zod":"^3.24.2","@biroai/shared":"2026.513.0-canary.1","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"vitest":"^3.0.5","typescript":"^5.7.3","@types/node":"^24.6.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_2026.513.0-canary.1_1778657910164_0.9825730420478465","host":"s3://npm-registry-packages-npm-production"}},"2026.513.0":{"name":"@biroai/mcp-server","version":"2026.513.0","license":"MIT","homepage":"https://github.com/Tim-ReJet/biro","bugs":{"url":"https://github.com/Tim-ReJet/biro/issues"},"repository":{"type":"git","url":"git+https://github.com/Tim-ReJet/biro.git","directory":"packages/mcp-server"},"type":"module","bin":{"biro-mcp-server":"dist/stdio.js"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","@biroai/shared":"2026.513.0","zod":"^3.24.2"},"devDependencies":{"@types/node":"^24.6.0","typescript":"^5.7.3","vitest":"^3.0.5"},"scripts":{"build":"tsc","clean":"rm -rf dist","typecheck":"tsc --noEmit","test":"vitest run"},"main":"./dist/index.js","types":"./dist/index.d.ts","_id":"@biroai/mcp-server@2026.513.0","description":"Model Context Protocol server for Biro.","_integrity":"sha512-mN1qTwgA38CRFln91kdbqpWAjm/cKA8FJvZ8OJDIr5SiB7cowLlCsIT/O3CTPfn0TBJ01h/uUhtTDF7fZSfrSg==","_resolved":"/private/var/folders/tn/cfqsycsd5k99cmcdx2dbjq_h0000gn/T/337f9da092b29afd4fe83aa78d151b9e/biroai-mcp-server-2026.513.0.tgz","_from":"file:biroai-mcp-server-2026.513.0.tgz","_nodeVersion":"24.14.1","_npmVersion":"11.12.1","dist":{"integrity":"sha512-mN1qTwgA38CRFln91kdbqpWAjm/cKA8FJvZ8OJDIr5SiB7cowLlCsIT/O3CTPfn0TBJ01h/uUhtTDF7fZSfrSg==","shasum":"ad08ffb8840fae598b7b709730f742d5605acb7f","tarball":"https://registry.npmjs.org/@biroai/mcp-server/-/mcp-server-2026.513.0.tgz","fileCount":59,"unpackedSize":205095,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEWPPxZRH9Bpt9ZvwCU11blV2c/JHCTUvGgyKzvpBhdUAiAK4DP0nfFqWuAm6WVzOGMEdwlE2DnbldmfSMCOBqpudg=="}]},"_npmUser":{"name":"timreactor","email":"tim@reactorjet.com"},"directories":{},"maintainers":[{"name":"timreactor","email":"tim@reactorjet.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_2026.513.0_1778658623184_0.9283506719626393"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-12T17:15:48.433Z","modified":"2026-05-13T07:50:23.434Z","2026.512.0-canary.2":"2026-05-12T17:15:48.785Z","2026.512.0-canary.3":"2026-05-12T17:45:46.423Z","2026.512.0-canary.4":"2026-05-12T18:18:44.642Z","2026.513.0-canary.0":"2026-05-13T01:39:59.680Z","2026.513.0-canary.1":"2026-05-13T07:38:30.364Z","2026.513.0":"2026-05-13T07:50:23.319Z"},"bugs":{"url":"https://github.com/Tim-ReJet/biro/issues"},"license":"MIT","homepage":"https://github.com/Tim-ReJet/biro","repository":{"type":"git","url":"git+https://github.com/Tim-ReJet/biro.git","directory":"packages/mcp-server"},"description":"Model Context Protocol server for Biro.","maintainers":[{"name":"timreactor","email":"tim@reactorjet.com"}],"readme":"# Biro MCP Server\n\nModel Context Protocol server for Biro.\n\nThis package is a thin MCP wrapper over the existing Biro REST API. It does\nnot talk to the database directly and it does not reimplement business logic.\n\n## Authentication\n\nThe server reads its configuration from environment variables:\n\n- `BIRO_API_URL` - Biro base URL, for example `http://localhost:3100`\n- `BIRO_API_KEY` - bearer token used for `/api` requests\n- `BIRO_COMPANY_ID` - optional default company for company-scoped tools\n- `BIRO_AGENT_ID` - optional default agent for checkout helpers\n- `BIRO_RUN_ID` - optional run id forwarded on mutating requests\n\n## Usage\n\n```sh\nnpx -y @biroai/mcp-server\n```\n\nOr locally in this repo:\n\n```sh\npnpm --filter @biroai/mcp-server build\nnode packages/mcp-server/dist/stdio.js\n```\n\n## Tool Surface\n\nRead tools:\n\n- `biroMe`\n- `biroInboxLite`\n- `biroListAgents`\n- `biroGetAgent`\n- `biroListIssues`\n- `biroGetIssue`\n- `biroGetHeartbeatContext`\n- `biroListComments`\n- `biroGetComment`\n- `biroListIssueApprovals`\n- `biroListDocuments`\n- `biroGetDocument`\n- `biroListDocumentRevisions`\n- `biroListProjects`\n- `biroGetProject`\n- `biroGetIssueWorkspaceRuntime`\n- `biroWaitForIssueWorkspaceService`\n- `biroListGoals`\n- `biroGetGoal`\n- `biroListApprovals`\n- `biroGetApproval`\n- `biroGetApprovalIssues`\n- `biroListApprovalComments`\n\nWrite tools:\n\n- `biroCreateIssue`\n- `biroUpdateIssue`\n- `biroCheckoutIssue`\n- `biroReleaseIssue`\n- `biroAddComment`\n- `biroSuggestTasks`\n- `biroAskUserQuestions`\n- `biroRequestConfirmation`\n- `biroUpsertIssueDocument`\n- `biroRestoreIssueDocumentRevision`\n- `biroControlIssueWorkspaceServices`\n- `biroCreateApproval`\n- `biroLinkIssueApproval`\n- `biroUnlinkIssueApproval`\n- `biroApprovalDecision`\n- `biroAddApprovalComment`\n\nEscape hatch:\n\n- `biroApiRequest`\n\n`biroApiRequest` is limited to paths under `/api` and JSON bodies. It is\nmeant for endpoints that do not yet have a dedicated MCP tool.\n\n## Biro Control Tools (stubs — pending P1.x wiring)\n\nThese tools define the agent participation surface for in-context Biro agents.\nHandlers currently throw `NotImplementedError`; HTTP wiring will land once the\nevent bus (P1.1) is available.\n\n- `claim_task` — atomically claim an issue as the current agent\n- `report_progress` — post a progress comment visible to operators\n- `request_budget_increase` — request operator-approved budget increase\n- `query_teammates` — list @-mentionable agents in the company, optionally filtered by role\n- `read_org_chart` — get the org chart with goals and reporting lines (read-only)\n- `check_governance` — check whether a planned action is permitted by governance rules (read-only)\n","readmeFilename":"README.md"}