MCP Tools Reference
This page documents all available MCP tools for credit scoring, financial reporting, identity verification, portfolio analysis, transaction graphs, and agentic reputation.All tools return live on-chain data and require an API key. Pass your key via the
Authorization: Bearer YOUR_API_KEY header.Credit Scoring
get_credit_score
Get the Cred Protocol credit score for an Ethereum address or ENS name. Score Ranges:- 920-1000: Excellent
- 840-919: Very Good
- 750-839: Good
- 640-749: Fair
- 300-639: Low
get_score_history
Get the recorded credit score history of an Ethereum address, newest first. A score is recorded each time it is computed (by any request, the cache warmer, or a refresh after on-chain activity on an address watched by ascore_change webhook), so an address that was never scored has an empty history.
get_credit_scores_batch
Get individual credit scores for multiple Ethereum addresses at once.get_aggregate_score
Get a single aggregated credit score across multiple Ethereum addresses. Useful for multi-sig wallets or portfolio-level assessments.Financial Reporting
get_financial_summary
Get a comprehensive financial summary for an Ethereum address. Includes assets, DeFi positions, credit events, and global percentile rankings. Includes:- Asset values (total assets, collateral, debt, stablecoins)
- Activity metrics (transactions, transfers, NFTs)
- DeFi positions (loans, collateral deposits)
- Credit events (liquidations, defaults, repayments)
- Identity attestations
get_comprehensive_report
Get the most detailed multi-chain credit report, including per-chain breakdowns with balances, transactions, NFTs, DeFi positions, and credit events.get_summary_report
Get aggregated metrics across all chains without per-chain breakdowns. Lighter than the comprehensive report.get_chain_report
Get a detailed credit report for a single blockchain including balances, transactions, NFTs, DeFi positions, and credit events.Blockchain network ID (see Supported Chains)
get_chain_summary
Get aggregated metrics for a single blockchain without detailed balance/transaction lists.Blockchain network ID (see Supported Chains)
Portfolio Value
get_portfolio_value
Get the total USD value of all assets across all supported blockchains.get_chain_portfolio_value
Get the portfolio value on a specific blockchain.Blockchain network ID (see Supported Chains)
get_portfolio_composition
Get portfolio value broken down by asset type (tokens, DeFi positions, stablecoins, collateral, debt).Identity Verification
get_identity_attestations
Get verified identity attestations for an Ethereum address. Attestation Types:- ENS Name - Ethereum Name Service domain ownership
- Basename - Base network name service (username.base.eth)
- Gitcoin Passport - Humanity verification (score ≥ 20)
- POAPs - Proof of Attendance Protocol tokens
- Worldcoin - Verified human
- BrightID - Social verification
get_sybil_score
Get a sybil detection score evaluating whether an address is a unique human or a sybil (duplicate/bot) account.low(0-25): Likely a unique humanmedium(26-50): Some suspicious indicatorshigh(51-75): Multiple sybil indicatorscritical(76-100): Very likely a sybil/bot
Transaction Graph
get_transaction_graph
Get a transaction graph showing ERC-20 token transfer relationships as nodes and edges. Useful for visualizing transaction flow, identifying counterparties, and analyzing wallet activity patterns.Agentic Reputation (ERC-8004)
ERC-8004 defines a standard for registering AI agent identities on-chain as ERC-721 tokens. Each agent has an owner address and metadata (name, description, image) resolved from its tokenURI. The registry lives on Base (chain ID 8453).
get_agent_count
Get the total number of AI agents registered in the ERC-8004 Identity Registry on Base.list_agents
Get a paginated list of AI agents from the ERC-8004 Identity Registry.search_agents
Search for AI agents by name or description using case-insensitive substring matching.get_agent
Get info for a specific AI agent by its ERC-8004 ID.submit_agent_reputation
Submit ERC-8004 reputation feedback for an AI agent. Computes credit score, sybil risk, and identity attestations, then submits results as on-chain feedback to the Reputation Registry on Base. Costs 10 Cred Units.The submission is asynchronous. This endpoint returns immediately with a tracking ID. Use
get_reputation_status to poll for completion.get_agent_kya
Know Your Agent: identity, operator, agent wallet, OFAC screening and apass / review / block verdict for an ERC-8004 agent. See Know Your Agent for the flags and fields.
Costs 10 Cred Units. An unknown agent is refused before payment.
cURL
get_wallet_kya
The same Know Your Agent profile, resolved from the wallet that is paying or calling you (the agent’s owner oragentWallet). The response adds resolved_from and agent_ids.
Costs 10 Cred Units. A wallet that controls no agent is refused before payment.
cURL
get_agent_reputation
Read the on-chain reputation summary for an AI agent from the ERC-8004 Reputation Registry. Costs 1 Cred Unit.get_reputation_status
Check the status of an on-chain reputation submission. Status values:pending → computing → submitting → confirmed (or failed)
Supported Chains
Error Handling
All endpoints return consistent error responses:400- Invalid request (bad address format, missing parameters)401- Authentication required (missing or invalid API key)404- Resource not found (agent doesn’t exist)503- API connection failed504- Request timeout