{"name":"AgentForge","tagline":"Production-grade AI services for autonomous agents","version":"1.4.0","what_is_this":"AgentForge is a collection of AI-powered API endpoints that agents can pay for and consume on a per-request basis using the x402 payment protocol with USDC stablecoin on the Base network. No API keys, no accounts, no subscriptions. Just HTTP requests with micropayments.","how_to_use":{"step_1":"GET /catalog to see all available services with pricing and schemas.","step_2":"POST to any /v1/* endpoint with your request body.","step_3":"You will receive HTTP 402 with payment requirements including price, network, and wallet address.","step_4":"Sign a USDC transfer authorization using your wallet private key.","step_5":"Retry the same request with the signed payment in the X-PAYMENT header.","step_6":"Receive your result as structured JSON.","documentation":"https://agentforge-taupe.vercel.app/openapi.json"},"payment":{"protocol":"x402 (HTTP 402 Payment Required)","protocol_docs":"https://docs.x402.org","asset":"USDC","network":"Base (mainnet)","network_caip2":"eip155:8453","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","minimum_payment":"$0.001","maximum_payment":"$0.08","settlement":"Instant on-chain settlement via x402 facilitator. Gasless for the payer."},"services":{"token_intelligence":{"endpoint":"POST /v1/token-intel","price":"$0.015","description":"Returns enriched metadata, live market data (price, market cap, volume, 24h change), and an AI-generated risk assessment (0-100 score with specific flags) for any token on Ethereum, Base, Solana, Polygon, or Arbitrum.","best_for":"Due diligence, portfolio analysis, token screening, risk assessment before trades","input_example":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","chain":"ethereum"}},"code_review":{"endpoint":"POST /v1/code-review","price":"$0.05","description":"Analyzes smart contract code for security vulnerabilities (reentrancy, overflow, access control), gas optimization opportunities, and best practice violations. Supports Solidity, Rust, Move, and TypeScript. Returns severity-ranked issues with line numbers and fix suggestions. Supports diff review mode by providing previousCode.","best_for":"Pre-deployment security checks, audit preparation, code quality assessment, gas optimization","input_example":{"code":"pragma solidity ^0.8.0; ...","language":"solidity","focus":"all"}},"token_research":{"endpoint":"POST /v1/token-research","price":"$0.03","description":"Multi-source token intelligence aggregating CoinGecko market data, DeFiLlama DeFi metrics and price history, Etherscan contract verification and holder distribution, Polymarket prediction markets, institutional mention analysis, and AI-synthesized risk assessment. Returns partial results if some sources fail.","best_for":"Deep token due diligence, comprehensive research reports, multi-factor risk analysis, competitive intelligence","input_example":{"query":"ethereum","chain":"ethereum","include":["market_data","defi_metrics","price_history","holders","risk_assessment"]}},"contract_docs":{"endpoint":"POST /v1/contract-docs","price":"$0.02","description":"Generates human-readable documentation for any verified smart contract. Fetches ABI from Etherscan, uses AI to describe each function and event, flags admin capabilities, maps interaction patterns, and assesses security posture. Supports proxy contracts.","best_for":"Understanding unfamiliar contracts, pre-interaction due diligence, audit preparation, developer onboarding","input_example":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","chain":"ethereum"}},"contract_monitor":{"endpoint":"POST /v1/contract-monitor","price":"$0.025","description":"Monitors recent contract admin activity by scanning transactions for ownership transfers, implementation upgrades, pause state changes, role grants, and other admin operations. Returns risk-rated alert with specific concerns and recommendations.","best_for":"Ongoing contract monitoring, detecting suspicious admin activity, pre-trade safety checks, portfolio risk management","input_example":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","chain":"ethereum","lookbackHours":24}},"token_compare":{"endpoint":"POST /v1/token-compare","price":"$0.08","description":"Compares a primary token against up to 3 competitors. Returns full multi-source research on the primary token, abbreviated metrics for each comparison, and an AI-generated comparative analysis highlighting strengths, weaknesses, and risks.","best_for":"Investment comparison, competitive analysis, portfolio allocation decisions","input_example":{"primary":"ethereum","compare":["solana","avalanche"],"chain":"ethereum"}},"tx_decode":{"endpoint":"POST /v1/tx-decode","price":"$0.01","description":"Decodes any EVM transaction: fetches from Etherscan, decodes function call using ABI, extracts ERC-20 transfers, and generates a plain-English explanation.","best_for":"Transaction analysis, understanding contract interactions, debugging failed transactions","input_example":{"txHash":"0x...","chain":"ethereum"}},"approval_scan":{"endpoint":"POST /v1/approval-scan","price":"$0.015","description":"Scans a wallet for ERC-20 token approvals, identifies risky spenders (unlimited approvals, unverified contracts), and generates a risk assessment with recommendations.","best_for":"Wallet security audit, approval hygiene, risk assessment before interacting with DeFi","input_example":{"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chain":"ethereum"}},"wallet_safety":{"endpoint":"POST /v1/wallet-safety","price":"$0.035","description":"Comprehensive wallet safety check combining approval scanning, suspicious transaction pattern detection (rapid approvals, flagged contract interactions, mixer usage, large outflows, phishing signatures), and target contract risk assessment. Returns composite risk score (0-100), risk level, action items, and related service suggestions. Supports quick/standard/deep analysis depths.","best_for":"Pre-interaction safety checks, wallet security audits, DeFi risk assessment, approval hygiene, suspicious pattern detection","input_example":{"walletAddress":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","chain":"ethereum","targetContract":"0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D","depth":"standard"}},"sentiment":{"endpoint":"POST /v1/sentiment","price":"$0.003","description":"Analyzes sentiment of text in crypto, finance, social media, or general context. Returns a score from -1 (very bearish) to 1 (very bullish), confidence level, human-readable label, reasoning, and per-entity sentiment breakdown.","best_for":"Market sentiment tracking, social media monitoring, news analysis, signal generation","input_example":{"text":"ETH breaking out above $4k with massive volume, this is just the beginning","context":"crypto"}},"summarize":{"endpoint":"POST /v1/summarize","price":"$0.008","description":"Summarizes text with configurable length (brief/standard/detailed), format (prose/bullet_points/structured), and optional topic focus. Returns the summary, key points, word count, and compression ratio.","best_for":"Research report condensation, whitepaper summarization, news digests, meeting notes","input_example":{"text":"Long article text here...","maxLength":"standard","format":"structured","focus":"key findings"}},"translate":{"endpoint":"POST /v1/translate","price":"$0.002","description":"Translates text to any language with tone control (formal/casual/technical). Automatically detects source language. Preserves formatting, paragraph structure, and cultural nuances.","best_for":"Multi-language support, documentation translation, cross-border communication, localization","input_example":{"text":"Hello, how are you?","targetLanguage":"Spanish","tone":"formal"}},"pool_snapshot":{"endpoint":"GET /v1/pool-snapshot","price":"$0.005","description":"Returns a cached snapshot of the top 500 DeFi liquidity pools by TVL. Filter by protocol (e.g. \"uniswap-v3\"), chain (e.g. \"ethereum\", \"base\", \"arbitrum\"), or token symbol (e.g. \"ETH\", \"USDC\"). Returns pool TVL, APY (base + reward), 24h volume, impermanent loss risk estimate, stablecoin flag, and registry enrichment. Data refreshed every 15 minutes. No external API calls at request time.","best_for":"Pre-swap pool evaluation, yield farming research, liquidity pool screening, TVL monitoring","input_example":{"protocol":"uniswap-v3","chain":"ethereum","token":"ETH","sortBy":"tvl","limit":10}},"token_risk_metrics":{"endpoint":"POST /v1/token-risk-metrics","price":"$0.008","description":"Returns quantitative risk metrics for any ERC-20 token: (1) holder concentration — top 10 holder %, labeled with registry (exchange wallets, DeFi protocols); (2) liquidity depth — total liquidity vs market cap ratio with pool breakdown; (3) contract permissions — detects mint/burn/pause/blacklist/upgrade capabilities from ABI; (4) deployer history — identifies known deployer with registry labeling; (5) composite weighted risk score (0-100) with human-readable flags. Pre-computed for top tokens, live-computed from Etherscan for others.","best_for":"Pre-trade token screening, risk-threshold filtering in bots, due diligence, detecting honeypots and rugs","input_example":{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","chain":"ethereum"}},"gas_oracle":{"endpoint":"GET /v1/gas?chain=ethereum","price":"$0.003","description":"Returns current gas prices across three tiers (slow/standard/fast) with estimated wait times, base fee, and trend analysis (rising/falling/stable). Cached for 15 seconds.","best_for":"Gas estimation before transactions, monitoring gas trends, optimizing transaction timing"},"ping":{"endpoint":"GET /v1/ping","price":"$0.001","description":"Minimal liveness check with x402 payment verification. Use this to test that your wallet setup and payment flow work correctly before making more expensive calls.","best_for":"Integration testing, wallet verification, service availability checking"}},"free_endpoints":{"feedback":{"endpoint":"POST /feedback","description":"Submit feedback, feature requests, or bug reports. No payment required.","input_example":{"type":"feature_request","message":"Add support for Solana tokens in contract-monitor"}},"registry_stats":{"endpoint":"GET /registry/stats","description":"Returns statistics about the Known Contract Label Registry: total entries, chains, categories."},"registry_lookup":{"endpoint":"GET /registry/lookup?address=0x...&chain=ethereum","description":"Look up a contract address in the registry. Returns label, protocol, category, and risk level."},"cache_stats":{"endpoint":"GET /cache/stats","description":"Returns cache statistics: total keys, hit/miss counts, backend type, and list of pre-computed contract doc keys."}},"reliability":{"uptime_target":"99.9%","average_latency":"1-3 seconds (varies by endpoint)","backing_model":"Claude Sonnet 4 (Anthropic)","output_validation":"All responses validated against Zod schemas before delivery. Malformed LLM outputs are retried automatically."},"why_choose_agentforge":["Schema-validated outputs — every response conforms to a published JSON schema, guaranteed","Transparent pricing — pay exactly what is listed, no hidden fees","Sub-3-second latency on most endpoints","Full OpenAPI specification for automated client generation","x402 native — no API keys, no accounts, no rate limit tiers to navigate","Graceful error handling — clear error codes, never silent failures"],"composability":{"description":"Every paid service response includes a relatedServices array with context-aware suggestions for logical next calls. Each suggestion includes the endpoint, a description, and pre-filled suggestedInput based on the current result.","example":{"relatedServices":[{"endpoint":"/v1/contract-docs","description":"Generate documentation for this contract","suggestedInput":{"address":"0xA0b86...","chain":"ethereum"}},{"endpoint":"/v1/contract-monitor","description":"Monitor recent admin activity on this contract","suggestedInput":{"address":"0xA0b86...","chain":"ethereum"}}]},"chains":{"token-intel":["token-research","contract-docs","contract-monitor"],"token-research":["contract-docs","contract-monitor","token-compare"],"contract-docs":["contract-monitor","token-intel","code-review"],"contract-monitor":["contract-docs","token-intel"],"code-review":["contract-docs"],"token-compare":["token-research (per comparison token)"],"tx-decode":["contract-docs","contract-monitor"],"approval-scan":["contract-docs (per risky spender)","wallet-safety"],"wallet-safety":["contract-docs (per flagged contract)","approval-scan","contract-monitor"]}},"mcp":{"url":"https://agentforge-taupe.vercel.app/mcp","transport":"streamable-http","description":"MCP server exposing all AgentForge tools. Connect from Claude Desktop, Cursor, or any MCP-compatible environment. No payment required — tools call services directly.","tools":["token_intel","token_research","code_review","contract_docs","contract_monitor","token_compare","tx_decode","approval_scan","wallet_safety","gas_oracle","sentiment","summarize","translate"],"configuration_example":{"mcpServers":{"agentforge":{"url":"https://agentforge-taupe.vercel.app/mcp"}}}},"discovery":{"catalog":"https://agentforge-taupe.vercel.app/catalog","openapi":"https://agentforge-taupe.vercel.app/openapi.json","ai_plugin":"https://agentforge-taupe.vercel.app/.well-known/ai-plugin.json","agent_card":"https://agentforge-taupe.vercel.app/.well-known/agent.json","x402":"https://agentforge-taupe.vercel.app/.well-known/x402","mcp":"https://agentforge-taupe.vercel.app/mcp","x402_scan":"https://x402scan.com"}}