Skip to main content

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
Score Ranges:
  • 920-1000: Excellent
  • 840-919: Very Good
  • 750-839: Good
  • 640-749: Fair
  • 300-639: Low
Response:

get_credit_scores_batch

Get individual credit scores for multiple Ethereum addresses at once.
array
required
List of Ethereum addresses or ENS names
Response:

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
Response:

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
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
Response:

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
Response:
Performance: Response time 5-10 seconds (aggregates data across multiple chains). Results cached for 5 minutes.

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
Response:

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
Response:

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)
Response:

get_portfolio_composition

Get portfolio value broken down by asset type (tokens, DeFi positions, stablecoins, collateral, debt).
string
required
Ethereum address or ENS name
Response:

Identity Verification

get_identity_attestations

Get verified identity attestations for an Ethereum address.
string
required
Ethereum address or ENS name
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
Response:

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
Response:
Risk Levels:
  • low (0-25): Likely a unique human
  • medium (26-50): Some suspicious indicators
  • high (51-75): Multiple sybil indicators
  • critical (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)
Response:
Graph structure: Tripartite graph (wallet → token → wallet) built from historical ERC-20 transfers. Performance: Response time 2-5 seconds on first request, ~50-100ms on cached requests. Cached for 10 minutes.

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.
Response:

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)
Response:

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)
Response:
Performance: Results served from a cached agent index (refreshed every 12 hours). Response time typically under 1 second.

get_agent

Get info for a specific AI agent by its ERC-8004 ID.
integer
required
ERC-8004 agent ID (starts at 1)
Response:

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.
Costs 10 Cred Units.
The submission is asynchronous. This endpoint returns immediately with a tracking ID. Use get_reputation_status to poll for completion.
Response (202 Accepted):

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)
Costs 1 Cred Unit.
Response:

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_reputation
Status values: pendingcomputingsubmittingconfirmed (or failed)
Response:

Supported Chains


Error Handling

All endpoints return consistent error responses:
Common error codes:
  • 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 failed
  • 504 - Request timeout