hive-mcp-address-screen

Pre-settlement on-chain risk screen for autonomous agents.

17-vector GoPlus address-risk rail. Every response includes an Ed25519-signed C18 attestation receipt from the Hive backend. Real rail on Base (USDC chain ID 8453) — no mocks.

<div align="center"> <img src="https://img.shields.io/badge/MCP-2024--11--05-FFB800?style=flat-square&labelColor=000" alt="MCP 2024-11-05"/> <img src="https://img.shields.io/badge/Chain-Base%208453-FFB800?style=flat-square&labelColor=000" alt="Base 8453"/> <img src="https://img.shields.io/badge/Rail-GoPlus%2017--vector-FFB800?style=flat-square&labelColor=000" alt="GoPlus 17-vector"/> <img src="https://img.shields.io/badge/Receipt-Ed25519%20C18-FFB800?style=flat-square&labelColor=000" alt="Ed25519 C18 receipt"/> <img src="https://img.shields.io/badge/License-MIT-FFB800?style=flat-square&labelColor=000" alt="MIT"/> </div>

---

MCP Tools

Tool	Input	Output
address_screen	address (string, required), chain_id (integer, default 8453)	Full backend response: screen_id, address, chain_id, decision (CLEAR|FLAG), flags_hit[], malicious_contracts_created, raw GoPlus data, Ed25519-signed receipt (C18), _meta
address_screen_clear_only	address (string, required), chain_id (integer, default 8453)	is_clear (boolean), flags_hit[], decision, screen_id, address, chain_id

Both tools call the same live backend. address_screen_clear_only is a lightweight convenience wrapper that strips the full receipt when you only need a pass/fail signal.

---

Endpoints

Method	Path	Description
POST	/mcp	JSON-RPC 2.0 MCP endpoint
GET	/health	Service health check
GET	/.well-known/mcp.json	MCP discovery manifest
GET	/.well-known/agent.json	A2A agent card
GET	/seo.json	SEO metadata

---

Backend

Field	Value
Endpoint	POST https://hivemorph.onrender.com/v1/attest/address/screen
Body	{"address":"<0x...>","chain_id":8453}
Provider	GoPlus Security (17-vector address risk)
Receipt	Ed25519-signed (C18 attestation warranty)
Chain (default)	Base — chain ID 8453

Example request

curl -X POST https://hivemorph.onrender.com/v1/attest/address/screen \
  -H "Content-Type: application/json" \
  -d '{"address":"0x15184Bf50B3d3F52b60434f8942b7D52F2eB436E","chain_id":8453}'

Example response (CLEAR)

{
  "screen_id": "addrca8431d8-...",
  "address": "0x15184bf50b3d3f52b60434f8942b7d52f2eb436e",
  "chain_id": 8453,
  "decision": "CLEAR",
  "flags_hit": [],
  "malicious_contracts_created": 0,
  "raw": { "cybercrime": "0", "money_laundering": "0", ... },
  "receipt": {
    "kind": "address_risk_screen_receipt",
    "decision": "CLEAR",
    "signing": { "algorithm": "EdDSA", "curve": "Ed25519", ... }
  },
  "_meta": { "patent": "USPTO 64/055,601", "claim": "C23" }
}

---

Connect

Claude / Cursor / any MCP-compatible host

Add to your MCP config:

{
  "mcpServers": {
    "hive-address-screen": {
      "url": "https://hive-mcp-address-screen.onrender.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Run locally

git clone https://github.com/srotzin/hive-mcp-address-screen.git
cd hive-mcp-address-screen
npm install
node server.js
# Server on :3000

Environment variables

Variable	Default	Description
PORT	3000	HTTP listen port
HIVE_BASE	https://hivemorph.onrender.com	Hive backend base URL

---

Protocol

• Transport: Streamable-HTTP
• Protocol version: MCP 2024-11-05
• Message format: JSON-RPC 2.0
• Methods supported: initialize, tools/list, tools/call, ping

---

GoPlus Risk Vectors (17)

cybercrime · money_laundering · gas_abuse · financial_crime · darkweb_transactions · reinit · phishing_activities · contract_address · fake_kyc · blacklist_doubt · fake_standard_interface · stealing_attack · blackmail_activities · sanctioned · malicious_mining_activities · mixer · fake_token · honeypot_related_address

A CLEAR decision means all 17 vectors returned "0" and malicious_contracts_created is 0.

---

License

MIT — see LICENSE.

Patent claim: C23 (USPTO 64/055,601)

Inventor: Stephen A. Rotzin · thehiveryiq.com · steve@thehiveryiq.com