{"_id":"@bighub/bighub-mcp","_rev":"8-df0e1c3c69b12b41111f5aa1426e464f","name":"@bighub/bighub-mcp","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.0":{"name":"@bighub/bighub-mcp","version":"0.1.0","keywords":["bighub","mcp","governance","ai-agents"],"license":"MIT","_id":"@bighub/bighub-mcp@0.1.0","maintainers":[{"name":"bighub","email":"contact@bighub.io"}],"bin":{"bighub-mcp":"dist/index.js"},"dist":{"shasum":"cfc33210389e0607575dd8afb4a3850c7b071a26","tarball":"https://registry.npmjs.org/@bighub/bighub-mcp/-/bighub-mcp-0.1.0.tgz","fileCount":5,"integrity":"sha512-02YgN/EBQ35KCSiWjYZ5yIGl4j/KCY2YhiTWD7SoWcK/+3Pi+woN2amZGUIBHA9dQgo8c7RwuS1WCMLfJQ0AYw==","signatures":[{"sig":"MEUCIQCoFOBsHwjp+cninPgHgwDS8VytmeHzLDJ5q0xyNbLToAIgU1rzLAJXy2ZEMKjRBlhzJDvxqsKAGJrBDCaXvqb8DYY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":35053},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"9b5aa017985949c42801980aacaf1fb9660b3ee7","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc -p tsconfig.json","check":"tsc --noEmit","start":"node dist/index.js"},"_npmUser":{"name":"bighub","email":"contact@bighub.io"},"_npmVersion":"10.9.2","description":"Official MCP server for BIGHUB governance APIs.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","vitest":"^2.1.9","typescript":"^5.9.3","@types/node":"^25.3.5"},"_npmOperationalInternal":{"tmp":"tmp/bighub-mcp_0.1.0_1773030903332_0.5256578505791625","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@bighub/bighub-mcp","version":"0.1.1","keywords":["bighub","mcp","model-context-protocol","governance","ai-agents","execution-control"],"license":"MIT","_id":"@bighub/bighub-mcp@0.1.1","maintainers":[{"name":"bighub","email":"contact@bighub.io"}],"homepage":"https://bighub.io","bugs":{"url":"https://github.com/bighub-io/bighub/issues"},"bin":{"bighub-mcp":"dist/index.js"},"dist":{"shasum":"230e5b5d952ce9d4098ca7a786aaf4f77e924218","tarball":"https://registry.npmjs.org/@bighub/bighub-mcp/-/bighub-mcp-0.1.1.tgz","fileCount":5,"integrity":"sha512-ySAYKbgkcVgrvACo69vI3F+Pk8/AvgVIbLclhgf0ro2890lRJhfYzyYkWVhWFEQ/MyMgs30RgDlCs+5BTyOqNA==","signatures":[{"sig":"MEUCIG5lrYYkzWkcedX7ahtEZLiJIroL03Jz2V0q67FpZBolAiEA/FonR282gwStFe59uajeSuDEGqBIChU0G/tTnOnNDbw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38334},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"e77e9346f40e051eb8677fde5d47856797208f1f","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc -p tsconfig.json","check":"tsc --noEmit","start":"node dist/index.js"},"_npmUser":{"name":"bighub","email":"contact@bighub.io"},"repository":{"url":"git+https://github.com/bighub-io/bighub.git","type":"git","directory":"servers/mcp"},"_npmVersion":"10.9.2","description":"MCP server for governing AI agent actions with the BIGHUB control plane.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","vitest":"^2.1.9","typescript":"^5.9.3","@types/node":"^25.3.5"},"_npmOperationalInternal":{"tmp":"tmp/bighub-mcp_0.1.1_1773031511155_0.4183143363024262","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@bighub/bighub-mcp","version":"0.1.2","keywords":["bighub","mcp","model-context-protocol","governance","ai-agents","execution-control"],"license":"MIT","_id":"@bighub/bighub-mcp@0.1.2","maintainers":[{"name":"bighub","email":"contact@bighub.io"}],"homepage":"https://bighub.io","bugs":{"url":"https://github.com/bighub-io/bighub/issues"},"bin":{"bighub-mcp":"dist/index.js"},"dist":{"shasum":"8f0672db53d665cf68797eefb970a2358d9fc678","tarball":"https://registry.npmjs.org/@bighub/bighub-mcp/-/bighub-mcp-0.1.2.tgz","fileCount":5,"integrity":"sha512-VXLcA0C5OzV57LY0I4l55oKp2CNzybrz/HjRxfYonNDyqBBHucsQPFlcxf7mr9pinn2447USAYmVlKYW/GQr/g==","signatures":[{"sig":"MEUCIFYzwGeptYYsju2AhDIp1UAMPU8FORDdcq90NXThdIUYAiEA8+275xga+/QE0o9AqdkbfMFrtbEIzb86CZyg90yQpVo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38381},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"e77e9346f40e051eb8677fde5d47856797208f1f","mcpName":"io.github.bighub-io/bighub-mcp","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc -p tsconfig.json","check":"tsc --noEmit","start":"node dist/index.js"},"_npmUser":{"name":"bighub","email":"contact@bighub.io"},"repository":{"url":"git+https://github.com/bighub-io/bighub.git","type":"git","directory":"servers/mcp"},"_npmVersion":"10.9.2","description":"MCP server for governing AI agent actions with the BIGHUB control plane.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","vitest":"^2.1.9","typescript":"^5.9.3","@types/node":"^25.3.5"},"_npmOperationalInternal":{"tmp":"tmp/bighub-mcp_0.1.2_1773033342690_0.6718097381524235","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@bighub/bighub-mcp","version":"0.1.3","keywords":["bighub","mcp","model-context-protocol","governance","ai-agents","execution-control"],"license":"MIT","_id":"@bighub/bighub-mcp@0.1.3","maintainers":[{"name":"bighub","email":"contact@bighub.io"}],"homepage":"https://bighub.io","bugs":{"url":"https://github.com/bighub-io/bighub/issues"},"bin":{"bighub-mcp":"dist/index.js"},"dist":{"shasum":"f3fc057d3167c6406142e0a7cfc72c0ae10f4788","tarball":"https://registry.npmjs.org/@bighub/bighub-mcp/-/bighub-mcp-0.1.3.tgz","fileCount":5,"integrity":"sha512-ItwIv9lDHknPnfgEJvYzTEJaQUntfy3R6R8fIuhTT67M9pNYBbBcwPI8Hi4Np7u1qISFdsc5NXQHNSyii9IWSg==","signatures":[{"sig":"MEUCIB6S7J4QkP3xmflzRH9rAJI+jMJ7dnhmHgjgndhh7pF2AiEA8AJvhTfEG8DycUjCn2kDKNjr5ugYZnEOxJGwx4oF9us=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38381},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"e77e9346f40e051eb8677fde5d47856797208f1f","mcpName":"io.github.bighub-io/bighub-mcp","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc -p tsconfig.json","check":"tsc --noEmit","start":"node dist/index.js"},"_npmUser":{"name":"bighub","email":"contact@bighub.io"},"repository":{"url":"git+https://github.com/bighub-io/bighub.git","type":"git","directory":"servers/mcp"},"_npmVersion":"10.9.2","description":"MCP server for governing AI agent actions with the BIGHUB control plane.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","vitest":"^2.1.9","typescript":"^5.9.3","@types/node":"^25.3.5"},"_npmOperationalInternal":{"tmp":"tmp/bighub-mcp_0.1.3_1773036003647_0.4205960571376124","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@bighub/bighub-mcp","version":"0.1.4","keywords":["bighub","mcp","model-context-protocol","governance","ai-agents","execution-control"],"license":"MIT","_id":"@bighub/bighub-mcp@0.1.4","maintainers":[{"name":"bighub","email":"contact@bighub.io"}],"homepage":"https://bighub.io","bugs":{"url":"https://github.com/bighub-io/bighub/issues"},"bin":{"bighub-mcp":"dist/index.js"},"dist":{"shasum":"1aeb3d89bb81aa53b1d8c4bcdb6b5d635a7e3b7f","tarball":"https://registry.npmjs.org/@bighub/bighub-mcp/-/bighub-mcp-0.1.4.tgz","fileCount":5,"integrity":"sha512-8A9HOEhzhzw1FYRgqDZ+gT1KjPE4wnEgPaOrQD6zk6v8uYhmL5gUdUntXCsZaDIp3ltfCFTCFdGvp5exBrGSpA==","signatures":[{"sig":"MEUCIQDy+R9ajHMGWkaupg1aWMIlXztWbjBcezoZ1EHWDigBugIgGCKY3tqppcF/J1OAmnpMj17snVcodkRiX5r10Hqp9ok=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38364},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"e77e9346f40e051eb8677fde5d47856797208f1f","mcpName":"io.bighub/mcp","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc -p tsconfig.json","check":"tsc --noEmit","start":"node dist/index.js"},"_npmUser":{"name":"bighub","email":"contact@bighub.io"},"repository":{"url":"git+https://github.com/bighub-io/bighub.git","type":"git","directory":"servers/mcp"},"_npmVersion":"10.9.2","description":"MCP server for governing AI agent actions with the BIGHUB control plane.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","vitest":"^2.1.9","typescript":"^5.9.3","@types/node":"^25.3.5"},"_npmOperationalInternal":{"tmp":"tmp/bighub-mcp_0.1.4_1773036092235_0.2955328672097448","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@bighub/bighub-mcp","version":"0.1.5","keywords":["bighub","mcp","model-context-protocol","decision-intelligence","ai-agents","self-improving-rules"],"license":"MIT","_id":"@bighub/bighub-mcp@0.1.5","maintainers":[{"name":"bighub","email":"contact@bighub.io"}],"homepage":"https://bighub.io","bugs":{"url":"https://github.com/bighub-io/bighub/issues"},"bin":{"bighub-mcp":"dist/index.js"},"dist":{"shasum":"22c8e93686cf0243d319b45a32951bd1480e2a9b","tarball":"https://registry.npmjs.org/@bighub/bighub-mcp/-/bighub-mcp-0.1.5.tgz","fileCount":5,"integrity":"sha512-DQunJUX0qIED+bkijiYHnf0+eIOIs85h5IA+PnlRwWQhQUDF8WmcOE3NTrECug4gdLi7mdzGDYxh1y88Y/exgA==","signatures":[{"sig":"MEYCIQD8h8XDVN1Xm9qd44iFCjbfdhCpu+FNqlfihJJ4ZkLSSAIhANgmbDL8N7A421v829iiA8N4QnLIz88ibOuornSmIKCk","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":38294},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"c1cf0843f956c73a28c7b888f6ff0525cef7df86","mcpName":"io.bighub/mcp","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc -p tsconfig.json","check":"tsc --noEmit","start":"node dist/index.js"},"_npmUser":{"name":"bighub","email":"contact@bighub.io"},"repository":{"url":"git+https://github.com/bighub-io/bighub.git","type":"git","directory":"servers/mcp"},"_npmVersion":"10.9.2","description":"MCP server for decision intelligence and self-improving rules with BIGHUB.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","vitest":"^2.1.9","typescript":"^5.9.3","@types/node":"^25.3.5"},"_npmOperationalInternal":{"tmp":"tmp/bighub-mcp_0.1.5_1773227459405_0.02167333355994261","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@bighub/bighub-mcp","version":"0.2.0","keywords":["bighub","mcp","model-context-protocol","decision-learning","ai-agents"],"license":"MIT","_id":"@bighub/bighub-mcp@0.2.0","maintainers":[{"name":"bighub","email":"contact@bighub.io"}],"homepage":"https://bighub.io","bugs":{"url":"https://github.com/bighub-io/bighub/issues"},"bin":{"bighub-mcp":"dist/index.js"},"dist":{"shasum":"364cea1829734181594748da1d8b193695b998d9","tarball":"https://registry.npmjs.org/@bighub/bighub-mcp/-/bighub-mcp-0.2.0.tgz","fileCount":5,"integrity":"sha512-No1E0D/eFTk1oh5L+RWTdFcz4aiP29DTfjUl/ErUkqYfB3nXJCs+bZKxRpfopKmHWMNjllZYgG0b7Jp/xBOMmA==","signatures":[{"sig":"MEYCIQD6v4oxJaVFFmePib+zkVlNihltiAufr1EdwSGMvOS6BwIhAOOYuxswoYxkJ8QjaobpVgplp+EXSFcZu+RuvLABiW+h","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":65556},"main":"dist/index.js","type":"module","engines":{"node":">=18"},"gitHead":"32b40e13b8416dc05a15983ce1714d5f060d6028","mcpName":"io.bighub/mcp","scripts":{"dev":"tsx src/index.ts","test":"vitest run","build":"tsc -p tsconfig.json","check":"tsc --noEmit","start":"node dist/index.js"},"_npmUser":{"name":"bighub","email":"contact@bighub.io"},"repository":{"url":"git+https://github.com/bighub-io/bighub.git","type":"git","directory":"servers/mcp"},"_npmVersion":"10.9.2","description":"MCP server for decision learning for AI agent actions with BIGHUB.","directories":{},"_nodeVersion":"22.17.1","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","vitest":"^2.1.9","typescript":"^5.9.3","@types/node":"^25.3.5"},"_npmOperationalInternal":{"tmp":"tmp/bighub-mcp_0.2.0_1773619496936_0.8017224586307639","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@bighub/bighub-mcp","version":"0.2.1","mcpName":"io.bighub/mcp","description":"MCP server for decision learning for AI agent actions with BIGHUB.","type":"module","main":"dist/index.js","bin":{"bighub-mcp":"dist/index.js"},"publishConfig":{"access":"public"},"scripts":{"build":"tsc -p tsconfig.json","check":"tsc --noEmit","dev":"tsx src/index.ts","start":"node dist/index.js","test":"vitest run"},"homepage":"https://bighub.io","repository":{"type":"git","url":"git+https://github.com/bighub-io/bighub.git","directory":"servers/mcp"},"bugs":{"url":"https://github.com/bighub-io/bighub/issues"},"keywords":["bighub","mcp","model-context-protocol","decision-learning","ai-agents"],"license":"MIT","engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1","zod":"^4.3.6"},"devDependencies":{"@types/node":"^25.3.5","tsx":"^4.21.0","typescript":"^5.9.3","vitest":"^2.1.9"},"_id":"@bighub/bighub-mcp@0.2.1","gitHead":"265d57a5dd95ef6e823ec2f4142002a3d026b3d7","_nodeVersion":"22.17.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-qS3rbPqL1fIXDWUsIeEBOhGlm91aVbzmX5vDq6GZ2H2DMn1KHEjuVxieXu3QPN3Yq49jj/LnaGDPPVnMzdxndg==","shasum":"fc3b4bd2e4e3b9561a85f0f0b6e7892f2f3f4403","tarball":"https://registry.npmjs.org/@bighub/bighub-mcp/-/bighub-mcp-0.2.1.tgz","fileCount":5,"unpackedSize":95061,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDHEGPLV1UnvEeatl1GiDvC9UCQoO6HPavXhmnRjo7OZwIgSqvYVmLusMKL4WpAjAT3y8WY5mN1SE1fEP+tJ+MN8iY="}]},"_npmUser":{"name":"bighub","email":"contact@bighub.io"},"directories":{},"maintainers":[{"name":"bighub","email":"contact@bighub.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bighub-mcp_0.2.1_1774384804046_0.368890616213595"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-09T04:35:03.252Z","modified":"2026-03-24T20:40:04.303Z","0.1.0":"2026-03-09T04:35:03.475Z","0.1.1":"2026-03-09T04:45:11.299Z","0.1.2":"2026-03-09T05:15:42.841Z","0.1.3":"2026-03-09T06:00:03.804Z","0.1.4":"2026-03-09T06:01:32.412Z","0.1.5":"2026-03-11T11:10:59.540Z","0.2.0":"2026-03-16T00:04:57.084Z","0.2.1":"2026-03-24T20:40:04.201Z"},"bugs":{"url":"https://github.com/bighub-io/bighub/issues"},"license":"MIT","homepage":"https://bighub.io","keywords":["bighub","mcp","model-context-protocol","decision-learning","ai-agents"],"repository":{"type":"git","url":"git+https://github.com/bighub-io/bighub.git","directory":"servers/mcp"},"description":"MCP server for decision learning for AI agent actions with BIGHUB.","maintainers":[{"name":"bighub","email":"contact@bighub.io"}],"readme":"# @bighub/bighub-mcp\n\n**BIGHUB's decision layer as an MCP server. Evaluate agent actions, receive structured recommendations, report outcomes, and improve future decisions — from any MCP-compatible client.**\n\n> MCP server for decision learning on agent actions.\n\n```text\nMCP client\n   ↓\n@bighub/bighub-mcp\n   ↓\nBIGHUB API\n   ↓\nevaluate → recommend → agent acts → report outcome → learn\n```\n\n---\n\n## Table of contents\n\n**Start here**\n\n- [Install](#install)\n- [Quickstart](#quickstart)\n- [When to use bighub-mcp](#when-to-use-bighub-mcp)\n- [Typical MCP Loop](#typical-mcp-loop)\n- [Structured recommendation](#structured-recommendation)\n- [Trajectory-aware evaluation](#trajectory-aware-evaluation)\n\n**Tool reference**\n\n- [Core loop](#core-loop) · [Actions](#actions) · [Outcomes](#outcomes) · [Decision cases](#decision-cases) · [Precedents](#precedents) · [Calibration](#calibration) · [Multi-signal retrieval](#multi-signal-retrieval) · [Insights](#insights) · [Simulations](#simulations) · [Learning](#learning) · [Features](#features) · [Runtime ingestion](#runtime-ingestion) · [Operating constraints](#operating-constraints) · [Approvals & kill switch](#approvals--kill-switch) · [Events](#events) · [Webhooks](#webhooks) · [API keys](#api-keys) · [Auth](#auth) · [Utility](#utility)\n\n**Reference**\n\n- [Environment Variables](#environment-variables) · [Free BETA](#free-beta) · [Local Development](#local-development) · [Links](#links)\n\n---\n\n## Install\n\n```bash\nnpm install @bighub/bighub-mcp\n```\n\nRequires Node.js 18+.\n\n---\n\n## Quickstart\n\nSet your API key:\n\n```bash\nexport BIGHUB_API_KEY=your_api_key\n```\n\nRun the server in stdio mode:\n\n```bash\nnpx @bighub/bighub-mcp\n```\n\nAdd it to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"bighub\": {\n      \"command\": \"npx\",\n      \"args\": [\"@bighub/bighub-mcp\"],\n      \"env\": {\n        \"BIGHUB_API_KEY\": \"your_api_key\"\n      }\n    }\n  }\n}\n```\n\nWorks with MCP-compatible clients such as Claude Desktop and Cursor.\n\n---\n\n## When to use bighub-mcp\n\nUse this server when your MCP-connected agent performs actions that:\n\n- **Have real consequences** — financial, operational, or reputational impact\n- **Are ambiguous or multi-step** — the right call depends on context and trajectory\n- **Produce observable outcomes** — you can report what actually happened\n- **Need to improve over time** — static instructions aren't enough\n\nIf your agent only answers questions or performs read-only lookups, you don't need this. It's designed for agents that make decisions with real-world consequences.\n\n---\n\n## Typical MCP Loop\n\n1. Submit a decision for evaluation\n2. Receive a recommendation and decision signals\n3. Let the agent or runtime act\n4. Report the real outcome\n5. Inspect similar past cases and calibration\n6. Use what was learned on the next decision\n\n```text\nbighub_actions_evaluate\n→ agent runtime acts based on recommendation\n→ bighub_outcomes_report\n→ bighub_precedents_query\n→ bighub_calibration_report\n→ bighub_insights_advise\n```\n\n---\n\n## Structured recommendation\n\nEvery evaluation returns a structured recommendation — not just allow / block:\n\n| Field | Description |\n|---|---|\n| `recommendation` | `proceed`, `proceed_with_caution`, `review_recommended`, `do_not_proceed` |\n| `recommendation_confidence` | `high`, `medium`, `low` |\n| `risk_score` | Aggregated risk (0–1) |\n| `enforcement_mode` | `advisory`, `review`, `enforced` |\n| `decision_intelligence` | Rationale, evidence status, trajectory health, alternatives |\n\nLegacy fields (`allowed`, `result`, `reason`) may still appear for backward compatibility but are not the primary surface.\n\n---\n\n## Trajectory-aware evaluation\n\nBIGHUB evaluates actions not only in isolation, but also in the context of what happened before. As outcomes accumulate, similar sequences and prior decisions improve future recommendations.\n\n---\n\n# Complete Tool Reference\n\n125 tools organized by domain. The core loop tools are listed first.\n\n---\n\n## Core loop\n\n| Tool | Description |\n|---|---|\n| `bighub_actions_evaluate` | Submit an action for evaluation — returns recommendation, confidence, risk score |\n| `bighub_outcomes_report` | Report what actually happened after execution |\n| `bighub_precedents_query` | Query similar past cases |\n| `bighub_calibration_report` | Calibration report (prediction vs reality) |\n| `bighub_insights_advise` | Learned advisories for an action |\n\n---\n\n## Actions\n\n| Tool | Description |\n|---|---|\n| `bighub_actions_evaluate` | Evaluate an action (primary entry point) |\n| `bighub_actions_evaluate_payload` | Evaluate with a free-form payload |\n| `bighub_actions_evaluate_batch` | Evaluate multiple actions in one request |\n| `bighub_actions_dry_run` | Non-persistent evaluation (preview) |\n| `bighub_actions_live_connect` | Open a live connection slot |\n| `bighub_actions_live_heartbeat` | Heartbeat a live connection |\n| `bighub_actions_live_disconnect` | Close a live connection |\n| `bighub_actions_verify_validation` | Verify a validation hash |\n| `bighub_actions_observer_stats` | Observer statistics |\n| `bighub_actions_dashboard_summary` | Dashboard summary metrics |\n| `bighub_actions_status` | Service status |\n| `bighub_actions_memory_ingest` | Ingest decision memory events |\n| `bighub_actions_memory_context` | Retrieve memory context |\n| `bighub_actions_memory_refresh_aggregates` | Refresh memory aggregates |\n| `bighub_actions_memory_recommendations` | Pattern-based recommendations from memory |\n\n---\n\n## Outcomes\n\n| Tool | Description |\n|---|---|\n| `bighub_outcomes_report` | Report a real-world outcome |\n| `bighub_outcomes_report_batch` | Batch report outcomes |\n| `bighub_outcomes_get` | Get outcome by request_id |\n| `bighub_outcomes_get_by_validation` | Get outcome by validation_id |\n| `bighub_outcomes_get_by_case` | Get outcome by case_id |\n| `bighub_outcomes_timeline` | Full outcome timeline |\n| `bighub_outcomes_pending` | Decisions awaiting outcomes |\n| `bighub_outcomes_analytics` | Outcome analytics summary |\n| `bighub_outcomes_taxonomy` | Supported outcome statuses |\n| `bighub_outcomes_recommendation_quality` | Follow rate, quadrants, trend, by domain/actor |\n| `bighub_outcomes_partner_view` | Self-contained domain view with KPIs and examples |\n\n---\n\n## Decision cases\n\n| Tool | Description |\n|---|---|\n| `bighub_cases_create` | Create a decision case |\n| `bighub_cases_get` | Get a case by ID |\n| `bighub_cases_list` | List and filter cases |\n| `bighub_cases_report_outcome` | Report outcome for a case |\n| `bighub_cases_precedents` | Precedent intelligence for a proposed action |\n| `bighub_cases_calibration` | Calibration metrics for cases |\n\n---\n\n## Precedents\n\n| Tool | Description |\n|---|---|\n| `bighub_precedents_query` | Query similar past cases |\n| `bighub_precedents_signals` | Aggregated precedent signals |\n| `bighub_precedents_stats` | Precedent index statistics |\n\n---\n\n## Calibration\n\n| Tool | Description |\n|---|---|\n| `bighub_calibration_report` | Calibration report |\n| `bighub_calibration_reliability` | Reliability diagram data |\n| `bighub_calibration_drift` | Calibration drift over time |\n| `bighub_calibration_breakdown` | Breakdown by domain or tool |\n| `bighub_calibration_feedback` | Calibration feedback signals |\n| `bighub_calibration_observe` | Submit a calibration observation |\n| `bighub_calibration_quality_history` | Daily quality score over time |\n\n---\n\n## Multi-signal retrieval\n\n| Tool | Description |\n|---|---|\n| `bighub_retrieval_query` | Multi-signal precedent retrieval |\n| `bighub_retrieval_query_explained` | Retrieval with explanation trace |\n| `bighub_retrieval_strategies` | List available strategies |\n| `bighub_retrieval_strategy` | Get one strategy's details |\n| `bighub_retrieval_index_case` | Manually index a case |\n| `bighub_retrieval_compare` | Compare two strategies |\n| `bighub_retrieval_stats` | Retrieval index statistics |\n\n---\n\n## Insights\n\n| Tool | Description |\n|---|---|\n| `bighub_insights_advise` | Learned advisories for an action |\n| `bighub_insights_patterns` | Discovered risk patterns |\n| `bighub_insights_learn` | Learning refresh |\n| `bighub_insights_profile` | Action/tool profile |\n\n---\n\n## Simulations\n\n| Tool | Description |\n|---|---|\n| `bighub_simulations_list` | List simulation snapshots |\n| `bighub_simulations_get` | Get a snapshot |\n| `bighub_simulations_by_request` | Get snapshot by request |\n| `bighub_simulations_compare` | Compare predicted vs actual |\n| `bighub_simulations_accuracy` | Domain-level accuracy |\n| `bighub_simulations_stats` | Simulation statistics |\n\n---\n\n## Learning\n\n| Tool | Description |\n|---|---|\n| `bighub_learning_strategy` | Current learning strategy |\n| `bighub_learning_runs` | Recent learning runs |\n| `bighub_learning_recompute` | Trigger learning recomputation |\n| `bighub_learning_backfill` | Backfill learning artifacts |\n\n---\n\n## Features\n\n| Tool | Description |\n|---|---|\n| `bighub_features_compute` | Compute features for an action |\n| `bighub_features_compute_batch` | Batch feature computation |\n| `bighub_features_snapshot` | Create a feature snapshot |\n| `bighub_features_get_snapshot` | Get a snapshot |\n| `bighub_features_list_snapshots` | List snapshots |\n| `bighub_features_explain` | Explain features for a case |\n| `bighub_features_export` | Export features for a case |\n| `bighub_features_export_batch` | Batch export |\n| `bighub_features_compare` | Compare feature sets |\n| `bighub_features_schema` | Feature schema |\n| `bighub_features_stats` | Feature statistics |\n\n---\n\n## Runtime ingestion\n\n| Tool | Description |\n|---|---|\n| `bighub_ingest_event` | Ingest a single event |\n| `bighub_ingest_batch` | Ingest events in batch |\n| `bighub_ingest_reconcile` | Reconcile outcome with event |\n| `bighub_ingest_lifecycles` | List event lifecycles |\n| `bighub_ingest_lifecycle` | Get lifecycle for one event |\n| `bighub_ingest_pending` | Events pending reconciliation |\n| `bighub_ingest_stale` | Stale unreconciled events |\n| `bighub_ingest_stats` | Ingestion statistics |\n| `bighub_ingest_adapters` | List available adapters |\n\n---\n\n## Operating constraints\n\n| Tool | Description |\n|---|---|\n| `bighub_constraints_create` | Create a constraint |\n| `bighub_constraints_list` | List constraints |\n| `bighub_constraints_get` | Get a constraint |\n| `bighub_constraints_update` | Update a constraint |\n| `bighub_constraints_delete` | Delete a constraint |\n| `bighub_constraints_pause` | Pause a constraint |\n| `bighub_constraints_resume` | Resume a constraint |\n| `bighub_constraints_dry_run` | Preview without persisting |\n| `bighub_constraints_validate` | Validate an action against constraints |\n| `bighub_constraints_validate_dry_run` | Validate (dry run) |\n| `bighub_constraints_domains` | List domains with constraints |\n| `bighub_constraints_versions` | Constraint version history |\n| `bighub_constraints_apply_patch` | Apply a JSON Patch |\n| `bighub_constraints_purge_idempotency` | Admin: purge idempotency keys |\n\n---\n\n## Approvals & kill switch\n\n| Tool | Description |\n|---|---|\n| `bighub_approvals_list` | List approval requests |\n| `bighub_approvals_resolve` | Resolve an approval |\n| `bighub_kill_switch_status` | Kill switch status |\n| `bighub_kill_switch_activate` | Activate kill switch |\n| `bighub_kill_switch_deactivate` | Deactivate kill switch |\n\n---\n\n## Events\n\n| Tool | Description |\n|---|---|\n| `bighub_events_list` | Query event stream |\n| `bighub_events_stats` | Event statistics |\n\n---\n\n## Webhooks\n\n| Tool | Description |\n|---|---|\n| `bighub_webhooks_create` | Create a webhook |\n| `bighub_webhooks_list` | List webhooks |\n| `bighub_webhooks_get` | Get a webhook |\n| `bighub_webhooks_update` | Update a webhook |\n| `bighub_webhooks_delete` | Delete a webhook |\n| `bighub_webhooks_deliveries` | List deliveries |\n| `bighub_webhooks_test` | Send a test delivery |\n| `bighub_webhooks_list_events` | List subscribable event types |\n| `bighub_webhooks_verify_signature` | Verify webhook signature |\n| `bighub_webhooks_replay_failed_delivery` | Replay a failed delivery |\n\n---\n\n## API keys\n\n| Tool | Description |\n|---|---|\n| `bighub_api_keys_create` | Create an API key |\n| `bighub_api_keys_list` | List API keys |\n| `bighub_api_keys_delete` | Delete an API key |\n| `bighub_api_keys_rotate` | Rotate an API key |\n| `bighub_api_keys_validate` | Validate an API key |\n| `bighub_api_keys_scopes` | List available scopes |\n\n---\n\n## Auth\n\n| Tool | Description |\n|---|---|\n| `bighub_auth_signup` | Create an account |\n| `bighub_auth_login` | Log in |\n| `bighub_auth_refresh` | Refresh token |\n| `bighub_auth_logout` | Log out |\n\n---\n\n## Utility\n\n| Tool | Description |\n|---|---|\n| `bighub_http_request` | Generic HTTP passthrough |\n\n---\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `BIGHUB_API_KEY` | Yes* | - | API key auth |\n| `BIGHUB_BEARER_TOKEN` | No | - | Alternative bearer auth |\n| `BIGHUB_BASE_URL` | No | `https://api.bighub.io` | API base URL |\n| `BIGHUB_TIMEOUT_MS` | No | `15000` | Request timeout |\n| `BIGHUB_MAX_RETRIES` | No | `2` | Retries on transient failures |\n| `BIGHUB_ALLOW_INSECURE_HTTP` | No | - | Allow HTTP for local/private testing |\n\n\\* One of `BIGHUB_API_KEY` or `BIGHUB_BEARER_TOKEN` is required.\n\nManagement tools (API keys, webhooks, auth) require user JWT auth via `BIGHUB_BEARER_TOKEN`.\n\n---\n\n## Free BETA\n\nCurrent Free BETA limits:\n\n- 3 agents\n- 2,500 actions / month\n- 30 days history\n- 1 environment\n\n---\n\n## Local Development\n\n```bash\ngit clone https://github.com/bighub-io/bighub.git\ncd bighub/servers/mcp\nnpm install\nnpm run test\nnpm run check\nnpm run build\nnpm run start\nnpm run dev\n```\n\n---\n\n## Links\n\n- [bighub.io](https://bighub.io)\n- [GitHub - bighub-io/bighub](https://github.com/bighub-io/bighub)\n- [npm - @bighub/bighub-mcp](https://www.npmjs.com/package/@bighub/bighub-mcp)\n- [PyPI - bighub (Python SDK)](https://pypi.org/project/bighub/)\n- [PyPI - bighub-openai](https://pypi.org/project/bighub-openai/)\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}