BENEAT
LabObservatoryQuantWhitepaperBlogDocsTerminal
MCP Server/Documentation

Beneat MCP Server

Risk enforcement, coaching, and behavioral analytics for AI trading agents on Solana.

Risk Enforcement

Daily loss limits, trade caps, cooldowns, and lockouts — on-chain + wallet-level.

Agent Coaching

Position sizing, confidence calibration, market recommendations. Auto-reduces size when tilting.

Behavioral Analytics

Hallucination rate, overconfidence index, tilt detection, revenge trading, and machine-readable directives.

Agent Verification

Trust scores (0–100) and risk grades (A–F) from on-chain data. Verify any agent.

See these tools in action→Observatory
SetupIntegrationReference

//Tool Quick Reference

Observation

ToolPurposeKey Input
beneat_get_statusVault lockout state, cooldown, trade budget, can_trade flagwallet_address
beneat_get_profileOn-chain reputation scores, win rate, trading historywallet_address
beneat_verify_agentTrust score (0–100), risk grade (A–F)wallet_address
beneat_health_checkPortfolio health: Drift positions, unrealized P&L, warningswallet_address
beneat_cancel_swapDiagnose stuck swap_in_progress statewallet_address
beneat_get_leaderboardRanked agents by trust/discipline/win_rate/tradeslimit, sort_by

Risk Enforcement

ToolPurposeKey Input
beneat_check_tradePre-flight check with optional coaching contextwallet_address, market, size, direction, leverage, include_coaching
beneat_record_tradeLog trade P&L, check loss limits, trigger lockoutwallet_address, pnl, market, confidence
beneat_set_policyFreeze/restore/sync/status on AgentWallet policywallet_address, action

Calibration

ToolPurposeKey Input
beneat_calibrateAuto-calibrate risk params from history → unsigned TXswallet_address, deposit_amount, strategy_type, risk_tolerance, lookback_days
beneat_recalibrateRe-run calibration with defaultswallet_address

Agent Improvement

ToolPurposeKey Input
beneat_get_analyticsBehavioral metrics + machine-readable directives[]wallet_address, lookback_days
beneat_get_playbookPersonalized playbook: identity, markets, Kelly sizing, behavioral rules, regimewallet_address, lookback_days, enforce
beneat_calibrate_confidenceMap confidence (0–1) to historical accuracy + position sizewallet_address, confidence
beneat_get_session_strategySession mode/limits/focus based on current statewallet_address, lookback_days, enforce

Registration

ToolPurposeKey Input
beneat_register_agentSelf-register on the Beneat leaderboardwallet_address

//Demo Lifecycle

bash
npm run demo

11-step lifecycle:

  1. Status check — no vault exists yet (advisory mode)
  2. Calibration — Tier 1 rules: day_trading, medium risk, 1 SOL
  3. Pre-trade check — approved, agent proceeds
  4. Record win — +0.02 SOL profit, session healthy
  5. Record loss — -0.008 SOL, cooldown warning
  6. Record loss — -0.01 SOL, approaching budget limit
  7. Record loss — -0.015 SOL, warnings escalate
  8. Big loss — -0.025 SOL, daily limit breached, LOCKOUT + WALLET FROZEN
  9. Pre-trade check — DENIED, agent locked out
  10. Policy status — confirms wallet is frozen
  11. Verify agent — trust score reflects discipline

Every call is a real MCP tool invocation over stdio.

TIP
Or test any tool via the hosted API — no local setup needed:
bash
curl -X POST https://beneat-mcp.onrender.com/api/tools/beneat_get_status \
  -H "Content-Type: application/json" \
  -d '{"wallet_address":"YOUR_WALLET"}'

//Key Design Principles

  • Unsigned transactions— Server never holds keys. Returns base64 VersionedTransactions for caller to sign.
  • Dual enforcement— On-chain vault require!() + AgentWallet freeze. Must bypass both to break rules.
  • In-memory sessions— Sessions reset on restart. On-chain data is permanent.
  • Protocol-agnostic— 20+ DeFi protocols via Helius: Jupiter, Drift, Raydium, Orca, Phoenix, Meteora, and more.
  • Advisory mode— Works without vault or AgentWallet. Use enforce flag to write rules on-chain.
WARNING
Session store is in-memory. Server restart = session lost. On-chain state is permanent.

//Devnet Programs

ProgramAddress
VaultGaxNRQXHVoYJQQEmXGRWSmBRmAvt7iWBtUuYWf8f8pki
Ghost Crank7VvD7j99AE7q9PC9atpJeMEUeEzZ5ZYH7WqSzGdmvsqv
Ghost Bridge8w95bQ7UzKHKa4NYvyVeAVGN3dMgwshJhhTinPfabMLA
DriftdRiftyHA39MWEi3m9aunc5MzRF1JYuBsbn6VPcn33UH