Live package

@stacksona/mcp-server

MCP server for Stacksona Gate approvals, decision polling, audit logging, signed token validation, and revision events.

Fast path: expose approval tools

1
Install globally.
npm install -g @stacksona/mcp-server
2
Set env vars.
Provide STACKSONA_GATE_URL and STACKSONA_API_KEY.
3
Add to your MCP client.
The client can request decisions, poll decisions, validate approval tokens, and log events.

Use your own Gate URL and agent key

STACKSONA_GATE_URL is the Gate endpoint from your Stacksona workspace or deployment. STACKSONA_API_KEY is the sg_ agent key for the agent making requests.

Package

Field	Value
Name	`@stacksona/mcp-server`
Version documented	`0.2.3`
Runtime	Node.js 18 or later
Binary	`stacksona-mcp-server`
Use when	You want MCP-compatible clients to request approvals or log audit events through Stacksona.

bash

npm install -g @stacksona/mcp-server

Run

bash

STACKSONA_GATE_URL=https://{gate-id}.stacksona.cloud STACKSONA_API_KEY=sg_your_api_key stacksona-mcp-server

Claude Desktop config

json

{
  "mcpServers": {
    "stacksona": {
      "command": "stacksona-mcp-server",
      "env": {
        "STACKSONA_GATE_URL": "https://{gate-id}.stacksona.cloud",
        "STACKSONA_API_KEY": "sg_your_api_key"
      }
    }
  }
}

Available MCP tools

Tool	Purpose
`stacksona_log_event`	Log an agent timeline event to Stacksona Gate.
`stacksona_request_decision`	Request approval before an agent takes a gated action.
`stacksona_request_decision_and_poll`	Request a decision and wait for approval or rejection.
`stacksona_get_decision`	Fetch current decision status by thread or task.
`stacksona_validate_approval_token`	Validate signed one-time approval tokens.
`stacksona_send_revision`	Update a pending review thread with a revised request.