Hive Barter
Multi-party agent barter — non-cash capability exchange with cryptographic receipts
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http hive-barter 'https://hive-mcp-barter.onrender.com/mcp'
{
"mcpServers": {
"hive-barter": {
"type": "http",
"url": "https://hive-mcp-barter.onrender.com/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
hive-mcp-barter
Outbound 402 arbitrage agent — Hive Civilization
Probes 402-enabled MCP endpoints, counter-offers below asking, and settles when the spread clears our resale floor. Pure protocol — no DMs, no spam. Attribution headers on every request.
Council provenance: Ad-hoc, user-promoted 2026-04-27 (Tier A position 1).
What this is
hive-mcp-barter is a Model Context Protocol server that runs an outbound arbitrage loop on top of the 402 payment surface. It scans public MCP registries for 402-enabled endpoints, probes them with standard quote requests, and — when target_asking × counter_pct still lands below our resale floor — issues a single-shot, pre-signed counter-offer. The target accepts by broadcasting our pre-signed transaction; there is no haggle, no second round, and no human-readable outreach.
- Protocol: MCP 2024-11-05 over Streamable-HTTP / JSON-RPC 2.0
- Transport:
POST /mcp - Discovery:
GET /.well-known/mcp.json - Health:
GET /health - Settlement: USDC on Base L2 — real rails, no mock, no simulated
- Brand gold: Pantone 1245 C /
#C08D23
Tools
| Tool | Tier | Description |
|---|---|---|
barter_discover | 0 (free) | List 402-enabled MCP endpoints from a public registry (glama, smithery, mcp.so) with last-seen asking prices. |
barter_quote_curve | 0 (free) | Build a demand curve for a target by sending up to 5 probes at descending floor pcts. Returns the reservation-price estimate. |
barter_arbitrage_book | 0 (free) | Today's P&L: probes sent, counters accepted, USDC realized spread. |
REST endpoints
| Method | Path | Purpose |
|---|---|---|
POST | /v1/barter/discover | Scan registries for 402 endpoints. |
POST | /v1/barter/probe | Send a 402-style quote request to a target. |
POST | /v1/barter/counter | Build a signed counter-offer at the configured floor pct. |
POST | /v1/barter/settle | Resolve an accepted counter on-chain and book the spread. |
GET | /v1/barter/ledger | Running P&L, attempts, wins, spread. |
GET | /v1/barter/today | Today aggregate (Tier 0, free). |
GET | /health | Service health. |
Counter-offer envelope
{
"x402_version": 1,
"intent": "counter_offer",
"originator_did": "did:hive:morph",
"asking_seen_usd": "0.05",
"offer_usd": "0.0325",
"offer_atomic_usdc_base": "32500",
"tx_pre_signed": "0x...",
"expires": "2026-04-27T20:30:00Z",
"attribution": {
"agent": "hive-mcp-barter",
"attribution_id": "barter-{uuid}",
"policy": "single-shot-no-haggle"
}
}
The pre-signed transaction is the entire commitment. The target accepts by broadcasting; we never have to re-sign on accept.
Resale floor
| Category | Our buy floor | Our resell |
|---|---|---|
| LLM tokens | $0.000020 / token | $0.000040 / token |
| Oracle reads | $0.0008 / read | $0.0015 / read |
| Storage writes | $0.00012 / write | $0.00025 / write |
| KYC checks | $0.04 / check | $0.08 / check |
If target_asking × counter_pct ≤ our_resell × 0.95, we counter. Otherwise we skip — there is no margin.
Risk controls
| Cap | Value |
|---|---|
| Max single counter | $0.50 USDC |
| Max daily outbound spend | $25 USDC |
| Max probes per target / 24h | 1 |
| Max distinct targets / hr | 30 |
| Per-target blacklist | 3+ no-response |
All caps fail-closed. Configurable via env vars; missing or invalid env always falls back to the stricter default.
Configuration
| Env | Required | Default | Notes |
|---|---|---|---|
PORT | no | 3000 | |
ENABLE_OUTBOUND | no | false | Default-off. The 5-min cron loop only runs when set to true. |
WALLET_ADDRESS | no | 0x15184…436e | W1 MONROE on Base. |
USDC_BASE | no | 0x833589…2913 | USDC contract on Base. |
BASE_RPC | no | https://mainnet.base.org | |
HIVECOMPUTE_URL | no | https://hivecompute-g2g7.onrender.com/v1/compute/chat/completions | Used twice daily for resale revaluation. |
MAX_DAILY_SPEND_USD | no | 25 | |
MAX_SINGLE_COUNTER_USD | no | 0.50 | |
COUNTER_PCT | no | 0.65 | |
PRIVATE_KEY | yes (to sign) | — | Hex private key for the wallet that funds counter-offers. Never commit this. Without it, /v1/barter/counter returns an unsigned envelope and the cron loop will not place real bids. |
Signing is opt-in. The repo does not include a key. To enable real counter-offers, set
PRIVATE_KEYin the Render dashboard (or your deployment env). To enable the 5-min cron loop, setENABLE_OUTBOUND=true.
Run locally
git clone https://github.com/srotzin/hive-mcp-barter.git
cd hive-mcp-barter
npm install
npm start
# server up on http://localhost:3000/mcp
curl http://localhost:3000/health
curl http://localhost:3000/.well-known/mcp.json
curl http://localhost:3000/v1/barter/today
Connect from an MCP client
Claude Desktop / Cursor / Manus — add to your mcp.json:
{
"mcpServers": {
"hive_mcp_barter": {
"command": "npx",
"args": ["-y", "mcp-remote@latest", "https://hive-mcp-barter.onrender.com/mcp"]
}
}
}
Hive Civilization
Part of the Hive Civilization — sovereign DID, USDC settlement, agent-to-agent rails. Companion shims include hive-mcp-evaluator, hive-mcp-compute-grid, hive-mcp-depin, hive-mcp-agent-storage, hive-mcp-agent-kyc, and hive-mcp-trade.
License
MIT (c) 2026 Steve Rotzin / Hive Civilization
Hive Civilization Directory
Part of the Hive Civilization — agent-native financial infrastructure.
- Endpoint Directory: https://thehiveryiq.com
- Live Leaderboard: https://hive-a2amev.onrender.com/leaderboard
- Revenue Dashboard: https://hivemine-dashboard.onrender.com
- Other MCP Servers: https://github.com/srotzin?tab=repositories&q=hive-mcp
Brand: #C08D23
الأسئلة الشائعة
ما هو Hive Barter؟
Multi-party agent barter — non-cash capability exchange with cryptographic receipts
كيف أثبّت Hive Barter؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http hive-barter 'https://hive-mcp-barter.onrender.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Hive Barter إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Hive Barter مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Hive Barter؟
ينشره srotzin. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.