BIGHUB

io.bighubPublished by bighub.iov0.2.1Updated Oct 24, 2026

Decision learning for AI agent actions. Evaluate, score, decide, and learn from outcomes.

VerifiedSTDIODesktop onlyCloud & InfrastructureDeveloper ToolsSecurity & Monitoring

Overview

AI-generated overview

BIGHUB's decision layer for IT agent actions: an assistant can submit a proposed action, get a run/review/block decision, and report outcomes.

What you can do
  • Evaluate proposed IT actions and get a normalized decision with mode, can_run, review and risk flags
  • Build decision packets, run DecisionBrain, and resolve pending human reviews
  • Report outcomes, query decision cases, precedents, calibration and retrieval signals
  • Inspect insights, simulations, features, learning runs and runtime event ingestion
  • Manage system integrations (Okta, Slack, GitHub, cloud and CI providers) and their polling
  • Administer operating constraints, approvals, kill switch, webhooks, API keys and auth
When to use it
Useful when an agent proposes consequential IT actions such as granting access, rotating credentials, deploying or rolling back services, changing IAM or CI/CD settings, or exporting sensitive data, and you want a decision and review gate before execution. Not needed for agents that only answer questions or do read-only lookups.
Requirements
Runs locally as a Node.js 18+ process via npx over stdio. Requires a BIGHUB account and either BIGHUB_API_KEY or BIGHUB_BEARER_TOKEN; management tools for API keys, webhooks and auth need the bearer token. Optional settings include BIGHUB_BASE_URL, timeout, retries and an insecure-HTTP flag. Network access to the BIGHUB API is required.
Before you install
The server holds a BIGHUB API key or bearer token and forwards proposed actions and context to the BIGHUB API. Many tools write or change state: resolving reviews and approvals, creating or deleting constraints, connections, webhooks and API keys, rotating keys, activating the kill switch, and triggering learning or polling runs. A generic HTTP passthrough tool can reach arbitrary endpoints. Review what the agent may execute before enabling it.

Installation

In SourceWeft

  1. Open BIGHUB in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@bighub/bighub-mcp

BIGHUB's Better Decision layer as an MCP server. Turn proposed IT agent actions into better decisions before they run from any MCP-compatible client.

MCP server for better decisions on IT agent actions.

text
MCP client   ↓@bighub/bighub-mcp   ↓BIGHUB API   ↓proposed action → Decision Packet → DecisionBrain → decision signals → run / review / context / block

Table of contents

Start here

Tool reference

Reference

Install

bash
npm install @bighub/bighub-mcp

Requires Node.js 18+.

Quickstart

Set your API key:

bash
export BIGHUB_API_KEY=your_api_key

Run the server in stdio mode:

bash
npx @bighub/bighub-mcp

Add it to your MCP client configuration:

json
{  "mcpServers": {    "bighub": {      "command": "npx",      "args": ["@bighub/bighub-mcp"],      "env": {        "BIGHUB_API_KEY": "your_api_key"      }    }  }}

Works with MCP-compatible clients such as Claude Desktop and Cursor.

When to use bighub-mcp

Use this server when your MCP-connected agent proposes IT actions such as:

  • granting Okta access
  • rotating credentials
  • deploying or rolling back services
  • changing CI/CD, cloud, or IAM settings
  • exporting sensitive data
  • posting incident or support updates
  • resolving actions that need human review

If 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.

Typical MCP Loop

  1. Send the proposed IT action to bighub_decide
  2. Let BIGHUB build or use a Decision Packet
  3. Run DecisionBrain and return execution mode, review/context flags, and a decision path when available
  4. Execute only when can_run is true and no blocking flags are set
  5. Route to review when BIGHUB asks for human approval or modification
  6. Optionally report the outcome later
text
bighub_decide→ bighub_build_packet / bighub_run_brain→ bighub_resolve_review when needed→ bighub_report_outcome later, optional

Better Decision primitives

The modern MCP surface is centered on the decision flow:

FieldDescription
bighub_decideTurn a proposed IT action into a better decision
bighub_build_packetBuild a Decision Packet from action and context
bighub_run_brainRun DecisionBrain on a packet
bighub_list_reviewsList pending reviews
bighub_resolve_reviewApprove, deny, or modify the reviewed action
bighub_get_system_contextFetch context for Okta, Slack, or a configured integration provider
bighub_get_world_stateRead operational world state
bighub_report_outcomeOptionally report what happened later
bighub_http_requestLow-level fallback for endpoints not yet modeled

bighub_decide and bighub_run_brain return a normalized decision object first: recommended_action, mode, can_run, needs_review, needs_more_context, should_not_run, risk, confidence, expected_regret, reason, system, selected_model when available, decision_path when available, and counts for verification steps and obligations. The original backend payload is still available under raw for advanced callers. Legacy tools such as bighub_actions_evaluate remain available for compatibility.

bighub_build_packet uses the same canonical JSON SHA-256 hashing strategy as the Python SDK, so packet hashes match across SDK and MCP clients.

Trajectory-aware evaluation

BIGHUB evaluates actions not only in isolation, but also in the context of what happened before. As deployment, review, and outcome history accumulates, similar IT actions can receive better recommendations over time.

Complete Tool Reference

BIGHUB tools are organized by domain. The core loop tools are listed first.

Core loop

ToolDescription
bighub_decideModern Better Decision entry point
bighub_build_packetBuild a Decision Packet
bighub_run_brainRun DecisionBrain
bighub_report_outcomeOptionally report what happened later
bighub_actions_evaluateLegacy / low-level action evaluation

Actions

ToolDescription
bighub_actions_evaluateLegacy / low-level action evaluation
bighub_actions_evaluate_payloadEvaluate with a free-form payload
bighub_actions_evaluate_batchEvaluate multiple actions in one request
bighub_actions_dry_runNon-persistent evaluation (preview)
bighub_actions_live_connectOpen a live connection slot
bighub_actions_live_heartbeatHeartbeat a live connection
bighub_actions_live_disconnectClose a live connection
bighub_actions_verify_validationVerify a validation hash
bighub_actions_observer_statsObserver statistics
bighub_actions_dashboard_summaryDashboard summary metrics
bighub_actions_statusService status
bighub_actions_memory_ingestIngest decision memory events
bighub_actions_memory_contextRetrieve memory context
bighub_actions_memory_refresh_aggregatesRefresh memory aggregates
bighub_actions_memory_recommendationsPattern-based recommendations from memory

Outcomes

ToolDescription
bighub_outcomes_reportReport a real-world outcome
bighub_outcomes_report_batchBatch report outcomes
bighub_outcomes_getGet outcome by request_id
bighub_outcomes_get_by_validationGet outcome by validation_id
bighub_outcomes_get_by_caseGet outcome by case_id
bighub_outcomes_timelineFull outcome timeline
bighub_outcomes_pendingDecisions awaiting outcomes
bighub_outcomes_analyticsOutcome analytics summary
bighub_outcomes_taxonomySupported outcome statuses
bighub_outcomes_recommendation_qualityFollow rate, quadrants, trend, by domain/actor
bighub_outcomes_partner_viewSelf-contained domain view with KPIs and examples

Decision cases

ToolDescription
bighub_cases_createCreate a decision case
bighub_cases_getGet a case by ID
bighub_cases_listList and filter cases
bighub_cases_report_outcomeReport outcome for a case
bighub_cases_precedentsPrecedent intelligence for a proposed action
bighub_cases_calibrationCalibration metrics for cases

Precedents

ToolDescription
bighub_precedents_queryQuery similar past cases
bighub_precedents_signalsAggregated precedent signals
bighub_precedents_statsPrecedent index statistics

Calibration

ToolDescription
bighub_calibration_reportCalibration report
bighub_calibration_reliabilityReliability diagram data
bighub_calibration_driftCalibration drift over time
bighub_calibration_breakdownBreakdown by domain or tool
bighub_calibration_feedbackCalibration feedback signals
bighub_calibration_observeSubmit a calibration observation
bighub_calibration_quality_historyDaily quality score over time

Multi-signal retrieval

ToolDescription
bighub_retrieval_queryMulti-signal precedent retrieval
bighub_retrieval_query_explainedRetrieval with explanation trace
bighub_retrieval_strategiesList available strategies
bighub_retrieval_strategyGet one strategy's details
bighub_retrieval_index_caseManually index a case
bighub_retrieval_compareCompare two strategies
bighub_retrieval_statsRetrieval index statistics

Insights

ToolDescription
bighub_insights_adviseLearned advisories for an action
bighub_insights_patternsDiscovered risk patterns
bighub_insights_learnLearning refresh
bighub_insights_profileAction/tool profile

Simulations

ToolDescription
bighub_simulations_listList simulation snapshots
bighub_simulations_getGet a snapshot
bighub_simulations_by_requestGet snapshot by request
bighub_simulations_compareCompare predicted vs actual
bighub_simulations_accuracyDomain-level accuracy
bighub_simulations_statsSimulation statistics

Learning

ToolDescription
bighub_learning_strategyCurrent learning strategy
bighub_learning_runsRecent learning runs
bighub_learning_recomputeTrigger learning recomputation
bighub_learning_backfillBackfill learning artifacts

Features

ToolDescription
bighub_features_computeCompute features for an action
bighub_features_compute_batchBatch feature computation
bighub_features_snapshotCreate a feature snapshot
bighub_features_get_snapshotGet a snapshot
bighub_features_list_snapshotsList snapshots
bighub_features_explainExplain features for a case
bighub_features_exportExport features for a case
bighub_features_export_batchBatch export
bighub_features_compareCompare feature sets
bighub_features_schemaFeature schema
bighub_features_statsFeature statistics

Runtime ingestion

ToolDescription
bighub_ingest_eventIngest a single event
bighub_ingest_batchIngest events in batch
bighub_ingest_reconcileReconcile outcome with event
bighub_ingest_lifecyclesList event lifecycles
bighub_ingest_lifecycleGet lifecycle for one event
bighub_ingest_pendingEvents pending reconciliation
bighub_ingest_staleStale unreconciled events
bighub_ingest_statsIngestion statistics
bighub_ingest_adaptersList available adapters

System integrations

ToolDescription
bighub_systems_list_connectionsList configured system integrations
bighub_systems_get_connectionGet one provider connection summary
bighub_systems_test_connectionTest unsaved provider config
bighub_systems_save_connectionSave provider config with optional display_name
bighub_systems_delete_connectionDelete provider connection
bighub_systems_poll_nowTrigger one provider poll now
bighub_systems_get_poll_scheduleGet provider poll schedule
bighub_systems_update_poll_scheduleConfigure provider polling
bighub_systems_poll_historyRead redacted provider poll history
bighub_systems_poll_statusScheduler status and due counts
bighub_systems_poll_metricsProvider success/failure, latency, stale schedule and verifier metrics
bighub_systems_run_due_pollsRun due polls for the current organization

Supported system providers include okta, slack, github, sentry, datadog, aws_cloudtrail, terraform, kubernetes, argocd, gitlab, jenkins, azure, prometheus, grafana, and openshift. Common aliases such as github-ci, cloudtrail, terraform-cloud, k8s, argo-cd, gitlab-ci, and ocp are normalized to backend provider IDs.

Poll snapshots and histories are redacted before persistence and exposure. They provide best-effort operational context; they are not a replacement for production monitoring.

Operating constraints

ToolDescription
bighub_constraints_createCreate a constraint
bighub_constraints_listList constraints
bighub_constraints_getGet a constraint
bighub_constraints_updateUpdate a constraint
bighub_constraints_deleteDelete a constraint
bighub_constraints_pausePause a constraint
bighub_constraints_resumeResume a constraint
bighub_constraints_dry_runPreview without persisting
bighub_constraints_validateValidate an action against constraints
bighub_constraints_validate_dry_runValidate (dry run)
bighub_constraints_domainsList domains with constraints
bighub_constraints_versionsConstraint version history
bighub_constraints_apply_patchApply a JSON Patch
bighub_constraints_purge_idempotencyAdmin: purge idempotency keys

Approvals & kill switch

ToolDescription
bighub_approvals_listList approval requests
bighub_approvals_resolveResolve an approval
bighub_kill_switch_statusKill switch status
bighub_kill_switch_activateActivate kill switch
bighub_kill_switch_deactivateDeactivate kill switch

Events

ToolDescription
bighub_events_listQuery event stream
bighub_events_statsEvent statistics

Webhooks

ToolDescription
bighub_webhooks_createCreate a webhook
bighub_webhooks_listList webhooks
bighub_webhooks_getGet a webhook
bighub_webhooks_updateUpdate a webhook
bighub_webhooks_deleteDelete a webhook
bighub_webhooks_deliveriesList deliveries
bighub_webhooks_testSend a test delivery
bighub_webhooks_list_eventsList subscribable event types
bighub_webhooks_verify_signatureVerify webhook signature
bighub_webhooks_replay_failed_deliveryReplay a failed delivery

API keys

ToolDescription
bighub_api_keys_createCreate an API key
bighub_api_keys_listList API keys
bighub_api_keys_deleteDelete an API key
bighub_api_keys_rotateRotate an API key
bighub_api_keys_validateValidate an API key
bighub_api_keys_scopesList available scopes

Auth

ToolDescription
bighub_auth_signupCreate an account
bighub_auth_loginLog in
bighub_auth_refreshRefresh token
bighub_auth_logoutLog out

Utility

ToolDescription
bighub_http_requestGeneric HTTP passthrough

Environment Variables

VariableRequiredDefaultDescription
BIGHUB_API_KEYYes*-API key auth
BIGHUB_BEARER_TOKENNo-Alternative bearer auth
BIGHUB_BASE_URLNohttps://api.bighub.ioAPI base URL
BIGHUB_TIMEOUT_MSNo15000Request timeout
BIGHUB_MAX_RETRIESNo2Retries on transient failures
BIGHUB_ALLOW_INSECURE_HTTPNo-Allow HTTP for local/private testing

* One of BIGHUB_API_KEY or BIGHUB_BEARER_TOKEN is required.

Management tools (API keys, webhooks, auth) require user JWT auth via BIGHUB_BEARER_TOKEN.

Local Development

bash
git clone https://github.com/bighub-io/bighub.gitcd bighub/servers/mcpnpm installnpm run testnpm run checknpm run buildnpm run startnpm run dev

Links

License

Apache-2.0

Source: servers/mcp/README.md at commit 61f4e2f

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.