bitfence Risk Oracle

io.github.bitfenceaiPublished by GitHub account bitfenceaiv0.7.7Updated Oct 24, 2026

Pre-transaction token risk checks for autonomous agents on six chains. Read-only; paid via x402.

VerifiedStreamable HTTPWeb executableFinanceSecurity & Monitoring

Overview

AI-generated overview

Remote MCP oracle that gives an assistant pre-transaction token risk scores, recommendations and flags for tokens on six blockchains.

What you can do
  • Assess a token's overall risk: composite score, risk level, confidence, a PROCEED / REQUIRE_HUMAN_APPROVAL / BLOCK recommendation, reasoning and triggered flags.
  • Evaluate a planned position: the same assessment plus estimated slippage, effective cost, max safe position, portfolio concentration and MEV exposure.
  • Coverage spans Solana, Base, Ethereum, Arbitrum, BSC and HyperEVM, with scoring across exit, supply, liquidity, holder, provenance and market integrity.
When to use it
Use it when an agent is about to swap, transfer or otherwise interact with a token and needs a structured safety check before acting, or when sizing a position and wanting slippage and concentration context alongside the risk verdict.
Requirements
A remote MCP endpoint; no accounts, API keys or signups. Each query is paid in USDC on Base through x402 (0.10 per risk query, 0.20 per contextual query), so a funded wallet capable of x402 payments and network access are needed.
Before you install
Queries cost money per call, so automated loops can spend USDC without a human in the loop. The server is read-only and returns advisory scores, not guarantees; the scoring engine is closed source, so thresholds and weights cannot be audited. Token addresses and chain identifiers are sent to a third-party service.

Installation

In SourceWeft

  1. Open bitfence Risk Oracle in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.bitfenceai%2Fbitfence/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "bitfence-risk-oracle": {
      "type": "http",
      "url": "https://api.bitfence.ai/mcp"
    }
  }
}

README

bitfence

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.

CategoryWhat it covers
Exit IntegrityHoneypot behaviour (measured by bitfence's own transaction simulation on EVM chains), sell/transfer taxes and their modifiability, freeze authority, transfer blocking
Supply IntegrityMint authority, hidden ownership, owner-editable balances, permanent delegates, upgradeable proxies, selfdestruct, metadata mutability
Liquidity IntegrityLP lock and burn status, unlock schedule, pool depth, deployer-held LP, pool age
Holder & Insider RiskTop-holder share, deployer share, holder count, sniper/insider/bundler cohorts, holder wallet ages
ProvenanceDeployer track record, observed prior rugs, vendor scam verdicts, launchpad lifecycle, verification registries
Market IntegrityWash-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

Apache License 2.0

Source: README.md at commit ff33298

Tools

2

analyze_token

Full risk assessment for a token. Returns risk score (0-100), risk level, confidence, recommendation (PROCEED/REQUIRE_HUMAN_APPROVAL/BLOCK), reasoning, and flags triggered. Equivalent to GET /v1/risk/{chain}/{address}.

Parameterschainrequiredaddressrequired

contextual_risk

Position-aware contextual risk assessment. Returns the full risk assessment plus position context: estimated slippage, effective cost, max safe position, portfolio concentration, and MEV exposure. Equivalent to POST /v1/risk/contextual.

Parameterschainrequiredaddressrequiredposition_size_usdrequiredportfolio_size_usdrequired

Version history

1
  1. v0.7.7LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts