# ChainRay

The most complete blockchain data and intelligence service for AI agents. 94 endpoints × 46 chains — from gas fees to MEV intelligence. Pay-per-request via x402.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add bboypoison159-7b43/chainray

# Browse available tools
npx -y @smithery/cli@latest tool list bboypoison159-7b43/chainray

# Get full schema for a tool
npx -y @smithery/cli@latest tool get bboypoison159-7b43/chainray whale-alerts

# Call a tool
npx -y @smithery/cli@latest tool call bboypoison159-7b43/chainray whale-alerts '{}'
```

## Direct MCP Connection

Endpoint: `https://chainray.run.tools`

**Optional config:**
- `defaultChain` (query) — Default blockchain to query when no chain is specified
- `maxResults` (query) — Maximum number of results to return per query (1-100)

## Tools (78)

- `whale-alerts` — Monitor large token transfers (USDC, WETH) on EVM chains or large SOL transfers on Solana. Returns recent whale movemen…
- `token-risk` — Analyze a token's risk profile. EVM: checks contract verification, proxy status, ownership renouncement, liquidity. Sol…
- `gas-tracker` — Get current gas/fee data. EVM: base fee, priority fee, predictions. Solana: priority fees, TPS, congestion level.
- `token-price` — Get real-time token price. EVM: reads Uniswap V3 TWAP on-chain. Solana: reads Pyth oracle price account directly from c…
- `wallet-profile` — Profile a wallet address. EVM: ETH balance, token count, activity labels (whale/active/dormant). Solana: SOL balance, S…
- `trending-tokens` — Get trending tokens by on-chain transfer volume. EVM only — ranks tokens by Transfer event count in recent blocks.
- `defi-yields` — Get live DeFi lending rates. EVM: Aave V3 supply/borrow APY. Solana: Kamino KLend reserves + native staking yield.
- `nft-collection` — Get NFT collection info: name, symbol, total supply, owner count. EVM chains only (ERC-721/1155).
- `nft-token` — Get individual NFT token metadata: owner, tokenURI, image, attributes. Resolves IPFS URIs. EVM chains only.
- `bridge-monitor` — Detect large token transfers involving known bridge contracts (Across, Wormhole, official bridges). EVM only.
- `recent-interactions` — Show addresses that interacted with a target in recent ~2000 blocks. Labels known entities (CEX, DEX, bridges). EVM onl…
- `contract-scan` — Security scan a smart contract via bytecode analysis. Detects selfdestruct, delegatecall, proxy patterns, ownership. No…
- `gas-history` — Get 6-hour gas fee trend with 36 sampled data points. EVM: base fee per block. Solana: TPS performance samples.
- `contract-events` — Read recent event logs from any smart contract. Auto-decodes Transfer, Approval, Swap events. EVM only.
- `mev-detect` — Quick sandwich attack detection. Analyzes 5 transactions before/after target in the same block. EVM only.
- `defi-compare` — Compare DeFi lending rates across protocols. EVM: Aave V3 vs Compound V3 side-by-side. Solana: Kamino + staking yield.
- `token-screener` — Screen tokens by risk score and price. Returns sorted list of tokens matching criteria. EVM only.
- `liquidity-depth` — Read Uniswap V3 pool state for a token pair: current price, active liquidity, fee tier. EVM only.
- `governance` — Read on-chain DAO governance proposals. Shows last 5 proposals with vote counts and states. Supported: Ethereum, Arbitr…
- `stablecoin-monitor` — Monitor stablecoin peg stability. Detects USDC/USDT/DAI price deviations from $1.00 using on-chain DEX pool data.
- `gas-predict` — Predict near-future gas prices using moving average and trend analysis of recent block base fees. Returns prediction, t…
- `protocol-tvl` — Calculate total value locked (TVL) in DeFi protocols (Aave V3, Compound V3) directly from on-chain aToken and Comet sup…
- `token-holders` — Analyze top token holders by recent accumulation. Scans Transfer events to identify the largest net receivers of a toke…
- `yield-farming` — Get Uniswap V3 LP pool statistics including liquidity, fee tiers, and current tick data.
- `flashloan-monitor` — Monitor flash loan activity on Aave V3. Detects recent flash loans with amounts and premiums paid.
- `liquidation-alerts` — Monitor DeFi liquidation events on Aave V3. High liquidation counts indicate market stress and potential cascading risk.
- `token-approval` — Check a wallet's ERC20 token approvals for security risks. Flags unlimited approvals and risky spender contracts.
- `multi-sig` — Analyze a Gnosis Safe multi-sig wallet. Returns owners, threshold, nonce, modules, and security assessment.
- `ens-resolve` — Resolve ENS domain names to Ethereum addresses (forward) or addresses to ENS names (reverse). Also retrieves text recor…
- `market-overview` — Get a cross-chain market snapshot: ETH price, gas costs, and DeFi TVL across Base, Ethereum, Arbitrum, and Optimism in …
- `chain-compare` — Side-by-side comparison of EVM chains — gas costs, block time, and best DeFi yields. Helps choose the optimal chain for…
- `portfolio-analyze` — Analyze a wallet's portfolio: total USD value, token breakdown, concentration analysis, and diversification score.
- `smart-money` — Track smart money patterns by analyzing whale transfer activity. Identifies accumulation vs distribution behavior and m…
- `credit-score` — Calculate an on-chain credit score (0-100) for any wallet. Factors: transaction history, native balance, token diversit…
- `risk-dashboard` — Get a unified risk assessment for any address: combines contract security scan, token approval risks, and market liquid…
- `bridge-flow` — Analyze cross-chain bridge capital flow direction. Determines if a chain is seeing net capital inflow (bullish) or outf…
- `protocol-health` — Assess DeFi protocol health: combines TVL, utilization rates, and liquidation frequency into a composite health score (…
- `nft-floor` — Analyze NFT collection activity: recent transfers, mints, burns, unique buyers, and activity level from on-chain ERC721…
- `cross-chain` — Cross-chain wallet correlation: queries all 7 EVM chains in parallel to show balance, nonce, and activity. Includes div…
- `sandwich-scanner` — Batch scan an address's recent transactions for MEV sandwich attacks. Checks front-run + back-run patterns in surroundi…
- `token-unlock` — Read token vesting/unlock schedule from on-chain contracts. Supports LinearVesting, CliffVesting, and Timelock patterns.
- `gas-optimization` — Gas price optimization advisor: analyzes recent block patterns to recommend the best time to transact. Includes savings…
- `yield-aggregator` — Cross-chain DeFi yield ranking: scans Aave V3 across all supported chains to find the best supply APY and cheapest borr…
- `address-labels` — Query the Address Intelligence database for labels on an address (whale, smart_money, etc). Labels are learned automati…
- `token-supply` — Get ERC20 token total supply, decimals, symbol, and name from on-chain data.
- `block-info` — Get latest or specific block data including gas, transactions, and timestamps.
- `contract-verify` — Check if an address is a smart contract or an EOA wallet. Returns code size, balance, and classification.
- `tx-decode` — Decode a transaction: value, gas cost, status, method ID, and whether it's a contract call.
- `nft-holders` — Analyze NFT holder distribution by scanning recent Transfer events.
- `dex-trades` — Get recent DEX swap trades from a Uniswap V3 pool.
- `stablecoin-supply` — Get USDC/USDT/DAI total supply across chains.
- `address-report` — Comprehensive address report combining wallet profile, credit score, token approvals, and recent interactions in one re…
- `chain-health` — Chain health score aggregating gas data, protocol TVL, and stablecoin stability.
- `defi-opportunity` — Find the best DeFi yield opportunity combined with optimal gas timing.
- `whale-tracker` — Track a specific whale address with Address Intelligence labels and wallet profile.

---
*Response truncated. Use `npx -y @smithery/cli@latest` for complete data.*