Skip to main content
Glama
Sign In
deenesjakoruzh
agentshield-mcp

agentshield-mcp

by yeick010
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

AgentShield MCP Server

Trust infrastructure for the AI Agent economy on Base. DEX Spread Oracle, escrow, insurance, knowledge base.

Tools

Tool

Description

Pricing

dex_spread_oracle

Live prices from Uniswap V3 on Base. 5 pairs.

$0.01 USDC (x402)

utility_score

On-chain utility score for trading decisions.

Free

query_knowledge

Query on-chain knowledge base. 14 verified DeFi entries.

$0.001 USDC (x402)

Endpoints

  • x402 Oracle: https://europe-west1-arbitrage-agent-prod.cloudfunctions.net/dex-spread-oracle

  • Agent Card (A2A): https://europe-west1-arbitrage-agent-prod.cloudfunctions.net/agent-card

  • MCP Server: https://europe-west1-arbitrage-agent-prod.cloudfunctions.net/mcp-server

Usage

# List available tools
curl -X POST https://europe-west1-arbitrage-agent-prod.cloudfunctions.net/mcp-server \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

# Get server info
curl -X POST https://europe-west1-arbitrage-agent-prod.cloudfunctions.net/mcp-server \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"server/info","id":1}'

# Get DEX prices (requires x402 payment)
curl https://europe-west1-arbitrage-agent-prod.cloudfunctions.net/dex-spread-oracle

On-Chain Contracts (Base Mainnet)

Contract

Address

AgentShield

0x4f2c88C60709a2FA987e84E8305Ab1a0CA293b7A

AgentServicesV2

0x94eC79352088aFb8B5336d30D07042AAC0c48A88

AgentVault

0xeaE922306EFbD86eAA37aDAd8c66af511F139803

Identity

  • ERC-8004: Agent #38580 — Profile

  • x402: Compatible with Coinbase/Stripe facilitator

  • A2A: Google Agent2Agent Protocol compatible

License

MIT

Available Tools

6 tools
compute_agent_scoreA

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.

Inputs: agent (required).

get_dex_priceA

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.

Inputs: pair (required).

get_pool_liquidityA

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.

Inputs: pair (required).

list_trading_pairsA

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.

Inputs: no named parameters.

lookup_agent_identityA

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.

Inputs: address (required).

search_defi_knowledgeA

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.

Inputs: query (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.6/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with minimal overlap: compute_agent_score focuses on agent utility scoring, get_dex_price and get_pool_liquidity handle different aspects of Uniswap pools (price vs liquidity), list_trading_pairs provides discovery, lookup_agent_identity retrieves identity metadata, and search_defi_knowledge offers educational content. The descriptions explicitly differentiate their functions and cross-reference each other appropriately.

    Naming Consistency5/5

    All tools follow a consistent verb_noun naming pattern (e.g., compute_agent_score, get_dex_price, list_trading_pairs) using snake_case throughout. The verbs are descriptive and aligned with their actions (compute, get, list, lookup, search), making the set predictable and easy to understand.

    Tool Count5/5

    With 6 tools, the count is well-scoped for the server's purpose of providing DeFi and agent-related utilities on Base mainnet. Each tool serves a specific, non-redundant function, covering agent scoring, Uniswap data access, identity lookup, and knowledge search, which feels complete without being overwhelming.

    Completeness4/5

    The tool set covers key areas for DeFi and agent interactions on Base, including data retrieval (prices, liquidity, identities), discovery (trading pairs), scoring (agent utility), and education (knowledge base). Minor gaps exist, such as no direct tools for executing transactions or managing agent registrations, but the provided tools support core workflows effectively.

    Resources

    Related MCP Connectors