{
  "markdown": "# hive-mcp-address-screen\n\n**Pre-settlement on-chain risk screen for autonomous agents.**\n\n17-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.\n\n<div align=\"center\">\n  <img src=\"https://img.shields.io/badge/MCP-2024--11--05-FFB800?style=flat-square&labelColor=000\" alt=\"MCP 2024-11-05\"/>\n  <img src=\"https://img.shields.io/badge/Chain-Base%208453-FFB800?style=flat-square&labelColor=000\" alt=\"Base 8453\"/>\n  <img src=\"https://img.shields.io/badge/Rail-GoPlus%2017--vector-FFB800?style=flat-square&labelColor=000\" alt=\"GoPlus 17-vector\"/>\n  <img src=\"https://img.shields.io/badge/Receipt-Ed25519%20C18-FFB800?style=flat-square&labelColor=000\" alt=\"Ed25519 C18 receipt\"/>\n  <img src=\"https://img.shields.io/badge/License-MIT-FFB800?style=flat-square&labelColor=000\" alt=\"MIT\"/>\n</div>\n\n---\n\n## MCP Tools\n\n| Tool | Input | Output |\n|------|-------|--------|\n| `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` |\n| `address_screen_clear_only` | `address` (string, required), `chain_id` (integer, default 8453) | `is_clear` (boolean), `flags_hit[]`, `decision`, `screen_id`, `address`, `chain_id` |\n\nBoth 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.\n\n---\n\n## Endpoints\n\n| Method | Path | Description |\n|--------|------|-------------|\n| `POST` | `/mcp` | JSON-RPC 2.0 MCP endpoint |\n| `GET` | `/health` | Service health check |\n| `GET` | `/.well-known/mcp.json` | MCP discovery manifest |\n| `GET` | `/.well-known/agent.json` | A2A agent card |\n| `GET` | `/seo.json` | SEO metadata |\n\n---\n\n## Backend\n\n| Field | Value |\n|-------|-------|\n| Endpoint | `POST https://hivemorph.onrender.com/v1/attest/address/screen` |\n| Body | `{\"address\":\"<0x...>\",\"chain_id\":8453}` |\n| Provider | GoPlus Security (17-vector address risk) |\n| Receipt | Ed25519-signed (C18 attestation warranty) |\n| Chain (default) | Base — chain ID 8453 |\n\n### Example request\n\n```bash\ncurl -X POST https://hivemorph.onrender.com/v1/attest/address/screen \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"address\":\"0x15184Bf50B3d3F52b60434f8942b7D52F2eB436E\",\"chain_id\":8453}'\n```\n\n### Example response (CLEAR)\n\n```json\n{\n  \"screen_id\": \"addrca8431d8-...\",\n  \"address\": \"0x15184bf50b3d3f52b60434f8942b7d52f2eb436e\",\n  \"chain_id\": 8453,\n  \"decision\": \"CLEAR\",\n  \"flags_hit\": [],\n  \"malicious_contracts_created\": 0,\n  \"raw\": { \"cybercrime\": \"0\", \"money_laundering\": \"0\", ... },\n  \"receipt\": {\n    \"kind\": \"address_risk_screen_receipt\",\n    \"decision\": \"CLEAR\",\n    \"signing\": { \"algorithm\": \"EdDSA\", \"curve\": \"Ed25519\", ... }\n  },\n  \"_meta\": { \"patent\": \"USPTO 64/055,601\", \"claim\": \"C23\" }\n}\n```\n\n---\n\n## Connect\n\n### Claude / Cursor / any MCP-compatible host\n\nAdd to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"hive-address-screen\": {\n      \"url\": \"https://hive-mcp-address-screen.onrender.com/mcp\",\n      \"transport\": \"streamable-http\"\n    }\n  }\n}\n```\n\n### Run locally\n\n```bash\ngit clone https://github.com/srotzin/hive-mcp-address-screen.git\ncd hive-mcp-address-screen\nnpm install\nnode server.js\n# Server on :3000\n```\n\n### Environment variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `PORT` | `3000` | HTTP listen port |\n| `HIVE_BASE` | `https://hivemorph.onrender.com` | Hive backend base URL |\n\n---\n\n## Protocol\n\n- Transport: Streamable-HTTP\n- Protocol version: MCP 2024-11-05\n- Message format: JSON-RPC 2.0\n- Methods supported: `initialize`, `tools/list`, `tools/call`, `ping`\n\n---\n\n## GoPlus Risk Vectors (17)\n\n`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`\n\nA `CLEAR` decision means all 17 vectors returned `\"0\"` and `malicious_contracts_created` is 0.\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\nPatent claim: C23 (USPTO 64/055,601)\n\nInventor: Stephen A. Rotzin · [thehiveryiq.com](https://www.thehiveryiq.com) · steve@thehiveryiq.com\n",
  "bytes": 4532,
  "sha": "cfb5a6ae9a0622a845d31740204d25c9d651f9e52e40a43f5af01d0d27377b77",
  "repo_slug": "srotzin/hive-mcp-address-screen",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_srotzin_hive_mcp_address_scree_01aa55c3/readme"
}