Collar Guardrail
OfficialUses Chainlink oracle prices for 34+ Stock Tokens on Robinhood Chain to price proposed trades, with Uniswap V4 fallback when the oracle is stale, paused, or unconfigured.
Targets trades on Robinhood Chain, providing deterministic pre-trade risk evaluation for AI agents, including oracle pricing, market-hours rules, tier-based limits, slippage bounds, and contract-safety checks.
Supports WalletConnect v2 and EIP-6963 wallet discovery for wallet authentication and connection.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Collar Guardrailevaluate buying 100 AAPL tokens for $4,500 now"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Collar Guardrail
Deterministic pre-trade risk layer for AI agents on Robinhood Chain.
Collar evaluates proposed trades before execution and returns
allow / warn / deny with reasons, a 0–100 risk score, and a
tamper-evident SHA-256 audit hash.
Overview
Collar sits between an autonomous trading agent and the chain as a deterministic pre-trade checkpoint. Every proposed trade is scored against live oracle prices, market-hours rules, tier-based limits, slippage bounds, and contract-safety signals before it is allowed to proceed.
The result is a single, auditable verdict — never a probabilistic guess.
Related MCP server: WETH
Endpoints
MCP Server:
https://api.collarguardrail.com/mcp-http/mcpMCP Server Card:
https://api.collarguardrail.com/.well-known/mcp-server-card.jsonAgent Card (A2A):
https://api.collarguardrail.com/.well-known/agent-card.jsonx402 Discovery:
https://api.collarguardrail.com/.well-known/x402.jsonMethodology:
https://api.collarguardrail.com/methodology.htmlLive Status:
https://api.collarguardrail.com/statusLive Latency (p50/p95/p99):
https://api.collarguardrail.com/latency.htmlllms.txt:
https://api.collarguardrail.com/llms.txtLive Terminal (UI):
https://collarguardrail.com
MCP Transport: streamable-http | Protocol: 2025-06-18 | Auth: none (fixed Tier 1)
Installation
Add to your MCP client config (Claude Desktop, Cursor, VS Code):
{
"mcpServers": {
"collar-guardrail": {
"url": "https://api.collarguardrail.com/mcp-http/mcp"
}
}
}
Verify:
bash
curl -X POST https://api.collarguardrail.com/mcp-http/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":1}'
Available Tools
Tool Purpose
evaluate_trade Pre-trade risk check at fixed Tier 1 ($5,000 ceiling). Returns allow / warn / deny with reasons and audit hash. Honeypot findings (severity=danger) force a DENY.
evaluate_trade_paid Same as evaluate_trade, gated by an x402 payment. Evaluated as Tier 2 ($25,000 ceiling). Call without payment_proof to receive the challenge; settle on-chain; retry with the proof.
check_token_safety Honeypot / contract safety check for any ERC-20. When severity=danger, evaluate_trade auto-DENYs.
simulate_balance Read-only balance simulation via eth_call state override
get_supported_assets Official Robinhood Chain asset registry
verify_audit_trail Verify the hash-chain integrity of past decisions
Call get_supported_assets first to resolve a symbol to its canonical
contract address. A mismatched address is treated as a fake-token attempt
and denied.
The free evaluate_trade is capped at Tier 1 ($5,000). If you need Tier 2
($25,000) without holding COLR, use evaluate_trade_paid — the on-chain
x402 payment is the credential.
Capabilities
Pricing
Chainlink oracle prices for 34+ Stock Tokens on Robinhood Chain
Uniswap V4 fallback when the oracle is stale, paused, or unconfigured
No fabricated fallback — if neither oracle nor V4 yields a price, verdict is deny
10-second V4 price cache
US Market Hours
Full US holiday calendar with observed-on-Friday/Monday shift
Early close on Thanksgiving Friday and Christmas Eve
Policy Enforcement
Tier system (REST API): 1,000 / 2,500 / 5,000 COLR → $5K / $25K / $100K limits
Per-tier rate limiting
Cluster-based rate limit and daily-loss guard (keyed on wallet fingerprint)
Slippage / MEV guard (hard 500 bps floor)
Idempotency via request_id (5-minute cache)
Global kill switch, contract mismatch detection, per-wallet blocklist
Contract Safety
Honeypot detection: bytecode scan, owner check, sell simulation via eth_call
Auto-DENY: when severity=danger, the verdict is deny regardless of
other checks — a hard stop.
GoPlus intelligence for unregistered tokens (buy/sell tax, mintable,
proxy, ownership reclaim).
Excessive tax (buy or sell > 10%) triggers an automatic deny via
GoPlus when allow_unregistered=true is passed to the request.
Auth & Infrastructure
JWT authentication via EIP-191 wallet signature (REST API)
Auth rate limiting per IP (20 req/min)
WalletConnect v2 + EIP-6963 wallet discovery
200+ token registry
Hash-chained audit trail (audit_hash + audit_seq)
Observability
Public live status page — uptime, dependency health, known issues
Public latency dashboard — p50/p95/p99 per endpoint and per MCP tool
Public methodology — how the 0–100 score is computed
Public audit-chain verification
Payments (x402)
Endpoint: POST /api/x402/analyze
Price: $0.10 USDG per call
Network: Robinhood Chain (eip155:4663)
Discovery: /.well-known/x402.json
Facilitator: Ultravioleta DAO
Listing: x402 Bazaar
No signup, no API key. Registered in the x402 Bazaar for automatic agent discovery.
Response Format
json
{
"decision": "allow",
"reasons": ["price source: oracle", "within tier 1 ceiling"],
"tier": 1,
"max_trade_usd": 5000,
"calculated_notional_usd": 1452.30,
"price_usd": 145.23,
"price_source": "oracle",
"risk_score": 12,
"audit_hash": "sha256:...",
"audit_seq": 12345,
"daily_pnl_usd": 0.0
}
decision: allow / warn / deny — deny is a hard stop
reasons prefixed with ADVISORY: are non-blocking
price_source: oracle / uniswap_v4 / fallback_default / unavailable
error: if present, no verdict was produced — treat as a hard stop
Discovery Files
/.well-known/mcp-server-card.json — MCP tool schemas (canonical, flat)
/.well-known/mcp/server-card.json — alias (nested)
/.well-known/agent-card.json — A2A skills
/.well-known/x402.json — x402 payment resources
/.well-known/methodology.md — risk score methodology (agent-readable)
/.well-known/known-issues.json — public known-issues list
/methodology.html — methodology, human-readable
/mcp-card.html — rendered server card
/agent-card.html — rendered agent card
/latency.html — live latency dashboard
/status — live status page
/llms.txt — full API contract for LLM agents
/skill.md — concise skill index
/robots.txt — AI crawler allow-list
/sitemap.xml — site map
Registry Listings
Official MCP Registry: io.github.aiguardrail/backend
Smithery: search "collar"
x402 Bazaar: /api/x402/analyze
Documentation
Live Terminal (UI): https://collarguardrail.com
Agent Integration Guide: https://collarguardrail.com/agent-docs.html
MCP Server Card: https://api.collarguardrail.com/.well-known/mcp-server-card.json
Methodology: https://api.collarguardrail.com/methodology.html
Status: https://api.collarguardrail.com/status
Latency: https://api.collarguardrail.com/latency.html
Contact
X (Twitter): @collarguardrail
Disclosure
Collar is the risk layer for autonomous finance on Robinhood Chain.
Deterministic, auditable, and independent.
COLR is our own utility token, issued and operated by the Collar team.
It is not affiliated with, endorsed by, or issued by Robinhood Markets,
Inc. or any Robinhood entity. Robinhood Chain is a public blockchain we
build on — using it does not imply any relationship with Robinhood.This server cannot be deployed
Maintenance
Related MCP Connectors
Pre-trade token safety check for AI agents. Simulates a sell before you buy, then returns one low/medium/high/unknown verdict with the signals behind it: sellability, buy/sell tax, liquidity depth, pair age, same-ticker impersonation, owner powers from bytecode. Ethereum, BSC, Base, Solana. Fail-closed - a check that cannot run answers unknown, never low. Publishes its own measured error rate with the benchmark harness in the repo. Free, no signup, no API key, MIT.
Pre-execution governance for AI agents. Deterministic PASS/FAIL/REVIEW verdicts, replayable proof.
Pre-trade token safety checks for AI agents on Solana and Base. x402 USDC per call, no key.
Deterministic pre-execution audit for trading agents. PASS/WAIT/FAIL, reproducible verdict_hash.
Related MCP Servers
- AlicenseAqualityDmaintenancePer-transaction crypto trade validator for AI agents, validates trades with PROCEED/CAUTION/BLOCK verdicts, scans tokens for anomalies, detects rug pulls, and searches across DEXes. Powered by WaveGuard physics engine with deterministic PDE-based analysis.51MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to analyze Ethereum wallets, simulate transactions, and draft transfers with deterministic policy and risk scoring, requiring human approval before on-chain execution.10 npmISC
- AlicenseNot gradedqualityFmaintenanceEnables AI agents to execute prediction-market trades through a risk-control gateway that enforces signed mandates and generates proof trails for accountability.0MIT
- AlicenseNot gradedqualityBmaintenanceThe verifiable risk engine for autonomous agents: deterministic, self-verifying financial calculations that an agent can delegate and prove. It covers liquidation and funding, position sizing and risk of ruin, options Greeks and margin, LP divergence, treasury concentration and depeg, execution quality checks, plus intelligence on options, DeFi, prediction markets, and transaction safety analysis.1 npm1MIT