agentshield-mcp

Fetch the current spot price for a Uniswap V3 trading pair on Base mainnet. Reads sqrtPriceX96 from the pool contract's slot0() function and converts to a human-readable price. Returns price (token1 per token0), pool address, fee tier, token symbols, network, and cache status. Prices are cached for 30 seconds — the 'cached' field in the response indicates whether the result came from cache. Free tier — no payment required in standalone mode; $0.01 USDC via x402 on the resource server. Use list_trading_pairs first to discover available pairs and their token ordering.

Fetch the current liquidity (TVL) for a Uniswap V3 pool on Base mainnet. Reads the liquidity() value from the pool contract and computes an approximate TVL in USD using the current spot price. Returns liquidity_raw (the pool's active liquidity scalar), tvl_usd_approx, pool address, fee tier, and token symbols. tvl_usd_approx is a rough estimate based on the symmetric liquidity assumption — accurate TVL requires full tick range analysis. No caching — each call reads live on-chain data. Free tier — no payment required. Use list_trading_pairs first to discover available pools, and get_dex_price for the current price.

List all supported trading pairs with their pool addresses, fee tiers, token symbols, and decimal precision on Base mainnet. Returns a structured map of pair identifiers to pool metadata — no on-chain calls required. Use this tool before calling get_dex_price or get_pool_liquidity to discover available pairs and understand token ordering. No parameters required. Results are static configuration — not subject to caching or rate limits.

Compute an on-chain utility score (0–100) for an Ethereum address on Base mainnet. Score is derived from three on-chain signals: ETH balance (0–30 pts), outgoing transaction count / nonce (0–40 pts), and ERC-8004 agent registry status (0–30 pts). Returns the total score, all score components, ETH balance, transaction count, and ERC-8004 registration status. Higher scores indicate more active and established on-chain agents. Free — no payment required. Use lookup_agent_identity to retrieve full ERC-8004 metadata for registered agents.

Look up an agent's on-chain identity from the ERC-8004 registry on Base mainnet. Reads isRegistered() and, for registered agents, attempts to fetch name, endpoint, and registration timestamp via getAgent(). Returns registration status and available metadata fields; unregistered agents return registered: false with null metadata. Read-only — no side effects. Free — no payment required. Use compute_agent_score to get a full utility score that incorporates ERC-8004 status alongside ETH balance and transaction history.

Search a curated DeFi knowledge base covering Base chain DeFi protocols and concepts. Uses keyword matching against 15 entries on: flash loans, AMMs, Uniswap V3, MEV, x402, ERC-8004, Base chain, Aave, impermanent loss, liquidations, oracle manipulation, gas optimization, Aerodrome, sqrtPriceX96 math, and MCP protocol. Returns up to 5 matching entries ranked by relevance, each with id, title, tags, and full content. No on-chain calls — instant response. Free tier — no payment in standalone mode; $0.001 USDC via x402 on the resource server. Use this before calling get_dex_price or compute_agent_score to understand the underlying concepts.