Hive Address Screen
HiveAddressScreen MCP — pre-settlement on-chain risk screen. 17-vector GoPlus rail
Open source Repository Open in the app JSON README (API)
About
HiveAddressScreen MCP — pre-settlement on-chain risk screen. 17-vector GoPlus rail
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- srotzin
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-05-04T01:26:37Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:26
- Updated
- 2026-08-29 04:01:26
- Origin id
io.github.srotzin/hive-mcp-address-screen
README
# 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
```bash
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)
```json
{
"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:
```json
{
"mcpServers": {
"hive-address-screen": {
"url": "https://hive-mcp-address-screen.onrender.com/mcp",
"transport": "streamable-http"
}
}
}
```
### Run locally
```bash
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](LICENSE).
Patent claim: C23 (USPTO 64/055,601)
Inventor: Stephen A. Rotzin · [thehiveryiq.com](https://www.thehiveryiq.com) · steve@thehiveryiq.com