Hive Openclaw Bridge

io.github.srotzinPublished by GitHub account srotzinv1.0.0Updated Oct 25, 2026

Reference integration with @kinthaiofficial OpenClaw 3-layer payment governance

The publisher's own server: OpenClaw Direct

VerifiedStreamable HTTPWeb executableFinanceDeveloper ToolsBusiness & Commerce

Overview

AI-generated overview

A remote MCP bridge that lets an assistant inspect and spend against a four-level payment budget while subscribing to paid Hive Gamification doors.

What you can do
Inspect budget caps, spend, reservations and headroom across namespace, user, agent and task levels, and override a per-key cap or run a read-only pre-flight check against a proposed amount and scope. List the eight paid doors with endpoint, price, asset and term, and fetch live economics for one door. Claim a first-use-free offer. Subscribe to a door through the gated path, which reserves budget atomically, posts upstream, then settles or releases.
When to use it
Use it when you want an assistant to make budget-governed paid calls to Hive Gamification endpoints, or to demonstrate the seam between internal hierarchical budgets and external settlement. It is a reference integration rather than a general-purpose tool.
Requirements
A remote streamable HTTP endpoint; no authentication, environment variables or headers are declared. The README's local quickstart instead needs Node.js, npm install and a listen port, with optional settings for the upstream base URL, timeout and default caps per level.
Before you install
Calls to the paid doors spend real funds in USDC on live rails, with prices from 0.15 to 10.00 USDC per door, and the README states there is no mock settlement. Budget caps can be overridden, so a misconfigured cap may allow more spending than intended. Requests are sent to a third-party upstream service.

Installation

In SourceWeft

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

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.srotzin%2Fhive-mcp-openclaw-bridge/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "hive-openclaw-bridge": {
      "type": "http",
      "url": "https://hive-mcp-gateway.onrender.com/openclaw-bridge/mcp"
    }
  }
}

README

hive-mcp-openclaw-bridge

[srotzin/hive-mcp-openclaw-bridge MCP server]

Reference integration with @kinthaiofficial's OpenClaw 3-layer payment governance framework. MCP server that wraps Hive Gamification's 8 BOGO doors behind a 4-level hierarchical budget — atomic reserve, upstream POST, settle/release. Real rails. No mock settlement.

Brand: Hive Civilization gold #C08D23 (Pantone 1245 C). License: MIT.


Why this exists

OpenClaw's three-layer model splits payment governance into three concerns:

LayerConcernWhere it lives
Layer 1Internal hierarchical budget — atomic reserve / settlethis server
Layer 2Inter-agent millicent ledger settled at epoch boundariesOpenClaw
Layer 3External x402 settlement on real railsHive Gamification

This bridge demonstrates the Layer 1 ↔ Layer 3 seam. Every paid call to a Hive door (computational-debt, protocol-consensus-tax, pheromone-priority, zk-compliance-shield, capability-leasing, guild-synergy, audit-trail-premium, bounty-routing) is gated by an atomic reservation against every level in the caller's scope path:

Namespace → User → Agent → Task

The most-restrictive level governs. If any level is short of headroom, the upstream HTTP request is never made and no x402 settlement is signed.

The same BudgetHook interface is exposed from @hivemorph/qvac-client v0.2 — drop your own implementation in to wire this hierarchy into a different runtime.

Background reading

Tools

ToolWhat it does
budget_statusInspect caps, spend, reservations, headroom across all 4 levels
budget_set_capOverride a per-key cap at one level
budget_checkRead-only pre-flight against a proposed amount + scope
doors_listList all 8 BOGO doors with endpoint, price, asset, term
door_economicsFetch live /economics for one door
bogo_claimClaim first-use-free via /v1/bogo/claim
door_subscribeCanonical gated path — atomic reserve → upstream POST → settle/release

Doors

DoorEndpointPriceTerm
computational-debt/v1/debt/subscribe0.50 USDC30d
protocol-consensus-tax/v1/pct/subscribe0.25 USDC1 read
pheromone-priority/v1/pheromone/subscribe5.00 USDC30d
zk-compliance-shield/v1/compliance/subscribe1.00 USDC30d
capability-leasing/v1/lease/start0.15 USDC1h
guild-synergy/v1/guild_synergy/subscribe10.00 USDC30d
audit-trail-premium/v1/audit_premium/subscribe3.00 USDC30d
bounty-routing/v1/bounty_routing/route0.50 USDC1 routing

Backend: https://hive-gamification.onrender.com. All endpoints are live and verified.

Lifecycle of a paid call

client → tools/call door_subscribe { door_id, did, scope }       → atomicReserve(scope, price, asset)           ├─ each level checked: namespace, user, agent, task           ├─ headroom = cap − spent − reserved           └─ short on any level? reject before signing       → POST hive-gamification.onrender.com<endpoint>       → 2xx? settle(reservationId)         non-2xx or throw? release(reservationId)       → return { ok, reservationId, binding_level, upstream }

Quickstart

bash
git clone https://github.com/srotzin/hive-mcp-openclaw-bridgecd hive-mcp-openclaw-bridgenpm installnpm start

Then from any MCP client:

json
POST http://localhost:3000/mcp{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

Configuration

EnvDefaultMeaning
PORT3000listen port
HIVE_BASEhttps://hive-gamification.onrender.comupstream base URL
HIVE_TIMEOUT_MS15000upstream fetch timeout
NAMESPACE_CAP50default namespace-level cap (USDC)
USER_CAP10default user-level cap
AGENT_CAP2default agent-level cap
TASK_CAP0.50default task-level cap

Per-key caps override defaults via budget_set_cap.

Related

License

MIT — see LICENSE.

Hive Civilization Directory

Part of the Hive Civilization — agent-native financial infrastructure.

Brand: #C08D23

Source: README.md at commit 12b17b5

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% 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 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 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

Other Openclaw integrations