About bitfence Risk Oracle
bitfence Risk Oracle provides pre-transaction token risk assessments for autonomous AI agents operating across six blockchains. It returns structured scores, confidence, recommendations, and circuit-breaker flags, with per-query payment in USDC on Base via x402.
Key features
- 01Covers Solana, Base, Ethereum, Arbitrum, BSC, and HyperEVM
- 02Scores token risk across six categories
- 03Returns composite scores, confidence, and recommendations
- 04Provides circuit-breaker flags and structured assessments
- 05Offers HTTP/JSON, MCP, and Rust Rig interfaces
Use cases
- 01Check token risk before an agent swaps
- 02Assess risk signals before transferring tokens
- 03Retrieve structured assessments before token interactions
MCP support
The MCP server exposes risk assessments to tool-calling LLM agents. Clients receive the same RiskAssessment structure as through the other interfaces.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.bitfence.ai/mcpclaude mcp add --transport http bitfenceai-bitfence https://api.bitfence.ai/mcp{"mcpServers":{"bitfenceai-bitfence":{"type":"http","url":"https://api.bitfence.ai/mcp"}}}Open in Cursor{"servers":{"bitfenceai-bitfence":{"type":"http","url":"https://api.bitfence.ai/mcp"}}}Open in VS Code{"mcpServers":{"bitfenceai-bitfence":{"type":"http","url":"https://api.bitfence.ai/mcp"}}}{"mcpServers":{"bitfenceai-bitfence":{"serverUrl":"https://api.bitfence.ai/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
2| Parameter | Type | Required | Description |
|---|---|---|---|
| chain | string | Yes | Blockchain to query: "solana", "base", "ethereum", "arbitrum", "bsc", or "hyperevm" |
| address | string | Yes | Token mint address (Solana) or contract address (Base/EVM, 0x-prefixed) |
Details
From the project READMEbitfence
The risk layer agents can't skip.
bitfence is a pre-transaction token risk oracle for autonomous AI agents operating on Solana, Base, Ethereum, Arbitrum, BSC, and HyperEVM. Before an agent swaps, transfers, or interacts with a token, bitfence returns a structured risk assessment in under a second: a composite score, confidence value, action recommendation, and any active circuit-breaker flags.
- Live on Solana, Base, Ethereum, Arbitrum, BSC, and HyperEVM
- HTTP API · MCP server · Rig (Rust) — Coinbase AgentKit coming soon
- $0.10 per risk query in USDC on Base via x402 — no API keys
🔗 bitfence.ai · 📄 Whitepaper · 𝕏 @bitfenceai
Why this exists
Autonomous agents now hold keys, read mandates, and broadcast transactions without a human in the loop. The agent frameworks shipping today expose swap and transfer actions with no systematic pre-transaction safety check. The risk-assessment tooling that exists was built for a human reading a wallet pop-up — not a machine routing on structured fields.
bitfence fills the gap: a pre-intent token risk layer designed for machine consumption. Neutral, transparent, agent-native, per-call priced. It is complementary to existing wallet-grade tools, not competitive with them.
What it scores
Risk is decomposed into six categories — each a distinct mechanism by which a holder's position is destroyed — and assembled into a 0–100 composite with maturity-aware scoring and structured circuit-breaker overrides.
| Category | What it covers |
|---|---|
| Exit Integrity | Honeypot behaviour (measured by bitfence's own transaction simulation on EVM chains), sell/transfer taxes and their modifiability, freeze authority, transfer blocking |
| Supply Integrity | Mint authority, hidden ownership, owner-editable balances, permanent delegates, upgradeable proxies, selfdestruct, metadata mutability |
| Liquidity Integrity | LP lock and burn status, unlock schedule, pool depth, deployer-held LP, pool age |
| Holder & Insider Risk | Top-holder share, deployer share, holder count, sniper/insider/bundler cohorts, holder wallet ages |
| Provenance | Deployer track record, observed prior rugs, vendor scam verdicts, launchpad lifecycle, verification registries |
| Market Integrity | Wash-trade ratios, old-wallet flow share, price/volume divergence |
Circuit breakers override the composite: measured threats (honeypot, confiscatory sell tax, selfdestruct) block even trusted tokens; heuristic flags floor the score for any token outside the curated trusted-token registry. The reported confidence value reflects only the data sources actually consulted, with cross-source disagreements excluded.
The full methodology is in the whitepaper.
Integration surfaces
The same scoring engine is exposed through four interfaces. Each returns the
same RiskAssessment structure.
- HTTP/JSON API — for any caller that speaks HTTP
- MCP server — for tool-calling LLM agents (Claude Desktop, MCP-enabled IDEs)
- Coinbase AgentKit — ActionProvider coming soon
- Rig (Rust) — typed in-process tool binding for Rust-native agents
For integration details, contact [email protected].
Pricing and access
- $0.10 per risk query, $0.20 per contextual query in USDC on Base via x402
- Implemented against the Coinbase CDP facilitator
- No accounts, no API keys, no signups
- Listed on the Coinbase x402 Bazaar
Open-source posture
Documentation, whitepaper, and integration surfaces are open under Apache 2.0. The scoring engine source remains closed for security reasons: publishing exact circuit-breaker thresholds, signal weights, and maturity logic would let adversarial token deployers engineer tokens that sit immediately below the trigger points, defeating the protection bitfence provides to agents downstream. This trade-off is discussed in the whitepaper.
A publishable methodology document — one useful to other Ethereum security teams without exposing trigger logic to deployers — is in active development.
Security
See SECURITY.md for vulnerability disclosure.
License
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.