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.string
required
Ethereum address (0x…) or ENS name (e.g., vitalik.eth)
boolean
default:"false"
Include detailed score factors explaining the score
- 920-1000: Excellent
- 840-919: Very Good
- 750-839: Good
- 640-749: Fair
- 300-639: Low
get_credit_scores_batch
Get individual credit scores for multiple Ethereum addresses at once.array
required
List of Ethereum addresses or ENS names
get_aggregate_score
Get a single aggregated credit score across multiple Ethereum addresses. Useful for multi-sig wallets or portfolio-level assessments.string
required
Comma-separated Ethereum addresses or ENS names
Financial Reporting
get_financial_summary
Get a comprehensive financial summary for an Ethereum address. Includes assets, DeFi positions, credit events, and global percentile rankings.string
required
Ethereum address or ENS name
- 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.string
required
Ethereum address or ENS name
get_summary_report
Get aggregated metrics across all chains without per-chain breakdowns. Lighter than the comprehensive report.string
required
Ethereum address or ENS name
get_chain_report
Get a detailed credit report for a single blockchain including balances, transactions, NFTs, DeFi positions, and credit events.string
required
Ethereum address or ENS name
integer
required
Blockchain network ID (see Supported Chains)
get_chain_summary
Get aggregated metrics for a single blockchain without detailed balance/transaction lists.string
required
Ethereum address or ENS name
integer
required
Blockchain network ID (see Supported Chains)
Portfolio Value
get_portfolio_value
Get the total USD value of all assets across all supported blockchains.string
required
Ethereum address or ENS name
get_chain_portfolio_value
Get the portfolio value on a specific blockchain.string
required
Ethereum address or ENS name
integer
required
Blockchain network ID (see Supported Chains)
get_portfolio_composition
Get portfolio value broken down by asset type (tokens, DeFi positions, stablecoins, collateral, debt).string
required
Ethereum address or ENS name
Identity Verification
get_identity_attestations
Get verified identity attestations for an Ethereum address.string
required
Ethereum address or ENS name
- 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.string
required
Ethereum address or ENS name
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.string
required
Ethereum address or ENS name
integer
default:"1"
Blockchain network ID (default: Ethereum)
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.integer
default:"1"
Page number for pagination
integer
default:"20"
Results per page (max: 100)
search_agents
Search for AI agents by name or description using case-insensitive substring matching.string
required
Search query — matches against agent name or description
integer
default:"1"
Page number for pagination
integer
default:"20"
Results per page (max: 100)
get_agent
Get info for a specific AI agent by its ERC-8004 ID.integer
required
ERC-8004 agent ID (starts at 1)
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.integer
required
ERC-8004 agent ID from Identity Registry (>= 1)
string
required
Ethereum address to score for this agent
array
Feedback tags to submit. Options:
creditScore, sybilRisk, identityCount. Default: all three.The submission is asynchronous. This endpoint returns immediately with a tracking ID. Use
get_reputation_status to poll for completion.get_agent_reputation
Read the on-chain reputation summary for an AI agent from the ERC-8004 Reputation Registry.integer
required
ERC-8004 agent ID (>= 1)
get_reputation_status
Check the status of an on-chain reputation submission.integer
required
ERC-8004 agent ID
string
required
Submission UUID returned by
submit_agent_reputationpending → 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