# BIGHUB

BIGHUB evaluates proposed IT actions and returns guidance on running, reviewing, or blocking them. Use it when an agent can change access or system settings.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: bighub-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bighub-io/bighub/tree/HEAD/servers/mcp
- Updated: 2026-05-16
- HTML: https://affpapa.org/en/nevibecode/mcp/bighub

## What it does

BIGHUB sends a proposed IT action to DecisionBrain and returns a normalized decision. The response indicates whether it can run, needs review or more context, or should be blocked. Evaluation can take earlier actions and outcomes into account as that history builds up.

The main flow uses `bighub_decide`, `bighub_build_packet`, and `bighub_run_brain`; agents can send actions for review with `bighub_resolve_review`. They can report what happened later through `bighub_report_outcome`. Run an action only when `can_run` is true and no blocking flags are set.

The server requires Node.js 18+ and `BIGHUB_API_KEY`. It is designed for consequential IT actions such as granting Okta access or changing CI/CD settings, rather than question answering or read-only lookups.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `BIGHUB_API_KEY`, `BIGHUB_BEARER_TOKEN`, `BIGHUB_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env BIGHUB_API_KEY=<BIGHUB_API_KEY> --env BIGHUB_BEARER_TOKEN=<BIGHUB_BEARER_TOKEN> --env BIGHUB_BASE_URL=<BIGHUB_BASE_URL> --transport stdio mcp -- npx -y @bighub/bighub-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env BIGHUB_API_KEY=<BIGHUB_API_KEY> --env BIGHUB_BEARER_TOKEN=<BIGHUB_BEARER_TOKEN> --env BIGHUB_BASE_URL=<BIGHUB_BASE_URL> -- npx -y @bighub/bighub-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@bighub/bighub-mcp"
            ],
            "env": {
                "BIGHUB_API_KEY": "<BIGHUB_API_KEY>",
                "BIGHUB_BEARER_TOKEN": "<BIGHUB_BEARER_TOKEN>",
                "BIGHUB_BASE_URL": "<BIGHUB_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@bighub/bighub-mcp"
            ],
            "env": {
                "BIGHUB_API_KEY": "<BIGHUB_API_KEY>",
                "BIGHUB_BEARER_TOKEN": "<BIGHUB_BEARER_TOKEN>",
                "BIGHUB_BASE_URL": "<BIGHUB_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e BIGHUB_API_KEY=<BIGHUB_API_KEY> -e BIGHUB_BEARER_TOKEN=<BIGHUB_BEARER_TOKEN> -e BIGHUB_BASE_URL=<BIGHUB_BASE_URL> mcp npx -y @bighub/bighub-mcp
```
Replace <…> with your own values

## When to use it
- evaluate an IT action before execution
- send a proposed change for human review
- fetch system context for an action
- report an outcome for later evaluation

## Example prompts
- Evaluate an Okta access request with `bighub_decide` and wait for the decision before applying it.
- Check this proposed CI/CD change and send it for review with `bighub_resolve_review` if needed.
- Report what happened after this action with `bighub_report_outcome`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md