io.github.acarchidi/agentforge

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

DeFi safety layer for AI agents: wallet safety, token risk, tx decode/simulate. 20 tools.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "agentforge": {
      "url": "https://agentforge-taupe.vercel.app/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (20)

• token_intel

  Lightweight token lookup: price, market cap, volume, and basic risk assessment for any EVM or Solana token.

  Parameters:

  • address (required) — string — Token contract address or name
  • chain — string — Blockchain network

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• token_research

  Multi-source token intelligence: market data, DeFi metrics, contract verification, prediction markets, holder analysis, price history, and AI risk assessment. Aggregates CoinGecko, DeFiLlama, Etherscan, and Polymarket.

  Parameters:

  • query (required) — string — Token name, symbol, or contract address
  • chain — string — Blockchain network
  • include — array — Data modules to include (default: market_data, defi_metrics, contract_info, risk_assessment)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• code_review

  Smart contract security analysis. Finds vulnerabilities, suggests gas optimizations, flags best practice violations. Supports Solidity, Rust, Move, TypeScript.

  Parameters:

  • code (required) — string — Smart contract source code
  • focus — string — Analysis focus area
  • language — string — Programming language
  • previousCode — string — Previous version for diff review

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• contract_docs

  Generate documentation for any verified EVM smart contract. Returns function descriptions, risk flags, interaction patterns, and security posture.

  Parameters:

  • address (required) — string — Contract address
  • chain — string — Blockchain network
  • focusFunctions — array — Specific functions to document

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• contract_monitor

  Monitor recent contract activity for suspicious admin operations, proxy upgrades, ownership changes, and pause events.

  Parameters:

  • address (required) — string — Contract address
  • chain — string — Blockchain network
  • lookbackHours — number — Hours to look back (max 168)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• token_compare

  Compare a primary token against up to 3 others. Returns full research on primary, abbreviated metrics on comparisons, plus AI comparative analysis.

  Parameters:

  • primary (required) — string — Primary token to research
  • compare (required) — array — Tokens to compare against (1-3)
  • chain — string — Blockchain network

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• tx_decode

  Decode any EVM transaction: function call, parameters, token transfers, and plain-English explanation.

  Parameters:

  • txHash (required) — string — Transaction hash (0x-prefixed, 64 hex chars)
  • chain — string — Blockchain network

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• approval_scan

  Scan a wallet for risky token approvals. On EVM chains: identifies unlimited ERC-20 approvals and unverified spenders. On Solana: scans SPL token delegate authorities. Returns risk assessment.

  Parameters:

  • address (required) — string — Wallet address to scan (0x-prefixed for EVM, base58 for Solana)
  • chain — string — Blockchain network (includes Solana support)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• gas_oracle

  Current gas prices (slow/standard/fast) for any supported EVM chain with trend analysis.

  Parameters:

  • chain — string — Blockchain network

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sentiment

  Analyze sentiment of text in crypto, finance, social media, or general context. Returns score (-1 to 1), confidence, label (very_bearish to very_bullish), reasoning, and per-entity sentiment.

  Parameters:

  • text (required) — string — Text to analyze for sentiment
  • context — string — Context for sentiment analysis

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• summarize

  Summarize text with configurable length (brief/standard/detailed), format (prose/bullet_points/structured), and optional topic focus. Returns summary, key points, and compression ratio.

  Parameters:

  • text (required) — string — Text to summarize
  • focus — string — Optional topic to focus the summary on
  • format — string — Output format
  • maxLength — string — Summary length

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• translate

  Translate text to any language with tone control (formal/casual/technical). Auto-detects source language. Preserves formatting and cultural nuances.

  Parameters:

  • text (required) — string — Text to translate
  • targetLanguage (required) — string — Target language (e.g., Spanish, French, Japanese)
  • tone — string — Translation tone
  • sourceLanguage — string — Source language (auto-detected if omitted)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• wallet_safety

  Comprehensive wallet safety check: scans approvals, analyzes recent transaction activity for suspicious patterns, and assesses target contract risk. Returns composite risk score (0-100), risk level, action items, and related service suggestions. Supports EVM chains and Solana.

  Parameters:

  • walletAddress (required) — string — Wallet address to check (0x-prefixed for EVM, base58 for Solana)
  • chain — string — Blockchain network (includes Solana support)
  • depth — string — Analysis depth: quick (approvals only), standard (approvals + activity), deep (extended history + all patterns)
  • targetContract — string — Optional target contract address to assess before interaction

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• pool_snapshot

  Get a cached snapshot of top DeFi liquidity pools. Filter by protocol (e.g. "uniswap-v3"), chain (e.g. "ethereum"), or token symbol (e.g. "ETH"). Returns TVL, APY, 24h volume, IL risk, and registry enrichment. Data refreshed every 15 minutes.

  Parameters:

  • pool — string — Filter by specific pool address or DeFi Llama pool ID
  • chain — string — Filter by chain, e.g. "ethereum", "base", "arbitrum"
  • limit — integer — Max results (1-100)
  • order — string — Sort order
  • token — string — Filter pools containing this token symbol, e.g. "ETH", "USDC"
  • offset — integer — Pagination offset
  • sortBy — string — Sort field
  • protocol — string — Filter by protocol name, e.g. "uniswap-v3", "curve", "aave"

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• token_risk_metrics

  Quantitative risk metrics for any ERC-20 token: holder concentration (top 10 holder %), contract permissions (can mint/burn/pause/blacklist), liquidity depth vs market cap, deployer history, and weighted composite risk score (0-100). Pre-computed for top tokens, live-computed for others.

  Parameters:

  • address (required) — string — Token contract address (0x-prefixed)
  • chain — string — Blockchain network

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• registry_lookup

  Look up a contract address in the Known Contract Label Registry. Returns protocol name, category, risk level, and tags. Free — no payment required.

  Parameters:

  • address (required) — string — Contract address (0x-prefixed)
  • chain — string — Blockchain network (e.g., ethereum, base)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_program_lookup

  Look up a Solana program ID in the program label registry. Returns protocol name, category, risk level. Free — no payment required.

  Parameters:

  • programId (required) — string — Base58 Solana program ID

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_tx_explain

  Explain a Solana transaction in plain English: labeled programs, token/SOL movements, success status, and risk flags.

  Parameters:

  • signature (required) — string — Base58 Solana transaction signature

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_tx_simulate

  Simulate a Solana transaction before signing it: balance changes, labeled programs, deterministic risk rules, and a proceed/caution/avoid recommendation.

  Parameters:

  • transaction (required) — string — Base64-encoded unsigned (or signed) Solana transaction

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• solana_token_risk_scan

  Solana token rug check: mint/freeze authority, holder concentration, liquidity depth, and a composite 0-100 risk score.

  Parameters:

  • mint (required) — string — Base58 Solana token mint address

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.