io.github.CSOAI-ORG/blockchain-ai-mcp

Analyze an Ethereum wallet's transaction history, portfolio, and risk profile. Args: address: Ethereum wallet address (0x...) transactions: Transaction history as [{"from": "0x...", "to": "0x...", "value": 1.5, "type": "transfer", "date": "2026-01-01"}] token_balances: Token holdings as [{"token": "USDC", "balance": 1000, "value_usd": 1000}] Behavior: This tool is read-only and stateless — it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results.

Trace a transaction's full execution path including internal calls and token transfers. Args: tx_hash: Transaction hash (0x...) from_addr: Sender address to_addr: Receiver/contract address value: ETH value transferred internal_txns: Internal transactions as [{"from": "0x", "to": "0x", "value": 0.1, "type": "call"}] token_transfers: Token transfers as [{"token": "USDC", "from": "0x", "to": "0x", "amount": 100}] Behavior: This tool is read-only and stateless — it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results.

Audit Solidity smart contract source code for common vulnerabilities including reentrancy, overflow, access control, and more. Args: source_code: Solidity source code to audit contract_name: Name of the contract Behavior: This tool is read-only and stateless — it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent — calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.

Estimate gas costs for common blockchain operations with priority-based pricing and USD conversion. Args: operation: Operation type (transfer_eth, erc20_transfer, erc20_approve, uniswap_swap, nft_mint, nft_transfer, contract_deploy, multisig_tx, defi_deposit, defi_withdraw) gas_price_gwei: Current gas price in Gwei eth_price_usd: Current ETH price in USD priority: Transaction priority (low, medium, high, urgent) Behavior: This tool is read-only and stateless — it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent — calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.

Analyze token metadata including supply distribution, holder concentration, and risk assessment. Args: address: Token contract address (0x...) chain: Blockchain network (ethereum, polygon, arbitrum, etc.) supply_data: Supply info as {"total_supply": N, "circulating_supply": N, "max_supply": N, "name": "X", "type": "ERC-20"} holder_data: Holder info as {"total_holders": N, "top_holders": [{"address": "0x", "percentage": 10.5}]} Behavior: This tool is read-only and stateless — it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results.