Skip to main content

​
MCP Tools Reference

This page documents all available MCP tools for credit scoring, financial reporting, identity verification, and agentic reputation.

​
Credit Scoring

​
get_credit_score

Get the Cred Protocol credit score for an Ethereum address or ENS name.
​
address
string
required
Ethereum address (0x…) or ENS name (e.g., vitalik.eth)
​
include_factors
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
curl "https://api.credprotocol.com/mcp/sandbox/score/vitalik.eth?include_factors=true"
Response: 
{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "score": 870,
  "decile": 9,
  "range": "very_good",
  "model_version": "andromeda_1.0",
  "timestamp": "2024-01-15T10:30:00Z",
  "factors": [
    {
      "label": "Borrowing History",
      "rating": "very_good",
      "description": "You have a very_good track record of using lending products."
    },
    {
      "label": "Wallet Composition",
      "rating": "very_good",
      "description": "You have a very_good breakdown of tokens in your account."
    }
  ]
}

​
get_credit_scores_batch

Get individual credit scores for multiple Ethereum addresses at once.
​
addresses
array
required
List of Ethereum addresses or ENS names
curl -X POST "https://api.credprotocol.com/mcp/sandbox/score/batch" \
  -H "Content-Type: application/json" \
  -d '{"addresses": ["vitalik.eth", "0x1234..."]}'
Response: 
{
  "scores": [
    {
      "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "score": 870,
      "decile": 9,
      "range": "very_good"
    },
    {
      "address": "0x1234...",
      "score": 650,
      "decile": 6,
      "range": "fair"
    }
  ],
  "count": 2
}

​
Financial Reporting

​
get_financial_summary

Get a comprehensive financial summary for an Ethereum address.
​
address
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
curl "https://api.credprotocol.com/mcp/sandbox/summary/vitalik.eth"
Response: 
{
  "report": {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "timestamp": "2024-01-15T10:30:00Z",
    "first_transaction": {
      "timestamp": "2021-05-01T00:00:00Z",
      "age_human": "3 years ago"
    },
    "summary": {
      "net_worth_usd": 31457.65,
      "total_asset_usd": 37009,
      "total_collateral_usd": 11102.70,
      "total_debt_usd": 5551.35,
      "count_transactions": 2509,
      "count_nfts": 9,
      "count_active_loans": 1,
      "count_liquidations": 0
    }
  }
}

​
Identity Verification

​
get_identity_attestations

Get verified identity attestations for an Ethereum address.
​
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
curl "https://api.credprotocol.com/mcp/sandbox/identity/vitalik.eth"
Response: 
{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "attestations": [
    "ENS Name",
    "Gitcoin Passport",
    "Proof of Humanity"
  ],
  "count": 3
}

​
Portfolio Value

​
get_portfolio_value

Get the total USD value of all assets across all supported blockchains.
​
address
string
required
Ethereum address or ENS name
Supported Chains: Ethereum, Optimism, BSC, Polygon, Base, Arbitrum, Celo, Avalanche, Scroll, Linea 
curl "https://api.credprotocol.com/mcp/sandbox/portfolio/vitalik.eth"
Response: 
{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "total_asset_usd": 125750.50,
  "timestamp": "2024-01-15T10:30:00Z"
}

​
get_chain_portfolio_value

Get the portfolio value on a specific blockchain.
​
address
string
required
Ethereum address or ENS name
​
chain_id
integer
required
Blockchain network ID
Chain IDs:
ChainID
Ethereum1
Optimism10
BSC56
Polygon137
Base8453
Arbitrum42161
Celo42220
Avalanche43114
Scroll534352
Linea59144
# Get Ethereum portfolio
curl "https://api.credprotocol.com/mcp/sandbox/portfolio/vitalik.eth/chain/1"

# Get Base portfolio
curl "https://api.credprotocol.com/mcp/sandbox/portfolio/vitalik.eth/chain/8453"
Response: 
{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "chain_id": 1,
  "chain_name": "Ethereum",
  "total_asset_usd": 98500.25,
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Live API Tools

The following tools call the real Cred Protocol API with actual blockchain data. These require the CRED_API_KEY environment variable to be set.
Live tools consume Cred Units and require an API key. Use sandbox tools for development and testing.
Generate your API key from the Cred Protocol Dashboard, then set it as the CRED_API_KEY environment variable.

​
get_live_credit_score

Get a real credit score using the live Cred Protocol API with the Andromeda 1.0 scoring model and real on-chain data.
​
address
string
required
Ethereum address (0x…) or ENS name (e.g., vitalik.eth)
​
include_factors
boolean
default:"false"
Include detailed score factors explaining what influences the score
Unlike the sandbox get_credit_score tool (which returns mock data), this tool calls the real API endpoint at /api/v2/score/address/{address} to compute an actual credit score.
Requires: CRED_API_KEY environment variable Score Ranges:
  • 920-1000: Excellent
  • 840-919: Very Good
  • 750-839: Good
  • 640-749: Fair
  • 300-639: Low
curl "https://api.credprotocol.com/mcp/score/vitalik.eth?include_factors=true"
Response: 
{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "score": 847,
  "decile": 7,
  "range": "very_good",
  "model_version": "andromeda_1.0",
  "timestamp": "2024-01-15T10:30:00Z",
  "factors": [
    {
      "label": "Borrowing History",
      "rating": "very_good",
      "description": "You have a very_good track record of using lending products."
    },
    {
      "label": "Wallet Composition",
      "rating": "very_good",
      "description": "You have a very_good breakdown of tokens in your account."
    }
  ],
  "source": "live"
}
Performance: Response time 3-5 seconds. Results cached for 5 minutes per address.

​
get_live_financial_summary

Get a comprehensive, multi-chain financial report using the live Cred Protocol API with real on-chain data.
​
address
string
required
Ethereum address (0x…) or ENS name (e.g., vitalik.eth)
Unlike the sandbox get_financial_summary tool (which returns mock data), this tool calls the real API endpoint at /api/v2/report/address/{address} to generate a detailed credit report aggregated across multiple chains.
Requires: CRED_API_KEY environment variable Report 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
  • Global percentile rankings
curl "https://api.credprotocol.com/mcp/summary/vitalik.eth"
Response: 
{
  "report": {
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "timestamp": "2024-01-15T10:30:00Z",
    "first_transaction": {
      "timestamp": "2015-08-07T00:00:00Z",
      "age_human": "9 years ago"
    },
    "summary": {
      "net_worth_usd": 2450000.50,
      "total_asset_usd": 2500000.00,
      "total_collateral_usd": 500000.00,
      "total_debt_usd": 50000.00,
      "count_transactions": 15230,
      "count_nfts": 142,
      "count_active_loans": 2,
      "count_liquidations": 0
    },
    "global_percentiles": {
      "net_worth_percentile": 99,
      "transaction_count_percentile": 98,
      "nft_count_percentile": 95
    }
  },
  "source": "live"
}
Performance: Response time 5-10 seconds (aggregates data across multiple chains). Results cached for 5 minutes per address.

​
get_live_identity_attestations

Get verified identity attestations using the live Cred Protocol API with real blockchain data.
​
address
string
required
Ethereum address (0x…) or ENS name (e.g., vitalik.eth)
Unlike the sandbox get_identity_attestations tool (which returns mock data), this tool calls the real API endpoint at /api/v2/identity/address/{address}/attestations with actual blockchain data.
Requires: CRED_API_KEY environment variable 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 credentials
  • BrightID - Social verification
curl "https://api.credprotocol.com/mcp/identity/vitalik.eth"
Response: 
{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "attestations": [
    "ENS Name",
    "Gitcoin Passport",
    "Proof of Attendance - ETHDenver 2024"
  ],
  "count": 3,
  "source": "live"
}

​
Agentic Reputation (ERC-8004)

​
search_agents

Search for AI agents registered in the ERC-8004 Identity Registry on Base. Returns matching agents with their on-chain IDs, owner addresses, and registration metadata.
​
query
string
required
Search query — matches against agent name or description (case-insensitive)
​
page
integer
default:"1"
Page number for pagination
​
limit
integer
default:"20"
Results per page (max: 100)
This is a live-only tool — it queries the real ERC-8004 Identity Registry index on Base (chain ID 8453). Requires the CRED_API_KEY environment variable.
Requires: CRED_API_KEY environment variable
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.
curl "https://api.credprotocol.com/mcp/agents/search?q=lending&limit=5"
Response: 
{
  "agents": [
    {
      "agent_id": 42,
      "owner": "0x742d35Cc6634C0532925a3b844Bc9e7595f32345",
      "metadata": {
        "name": "DeFi Lending Advisor",
        "description": "An AI agent that evaluates lending opportunities across DeFi protocols",
        "image": "ipfs://QmExample..."
      }
    },
    {
      "agent_id": 87,
      "owner": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
      "metadata": {
        "name": "Lending Risk Analyst",
        "description": "Assesses borrower risk profiles for undercollateralized lending",
        "image": null
      }
    }
  ],
  "total_results": 2,
  "query": "lending",
  "page": 1,
  "limit": 5,
  "source": "live"
}
Performance: Results are served from a cached agent index (refreshed every 12 hours). Response time is typically under 1 second.

​
Error Handling

All endpoints return consistent error responses: 
{
  "error": "Invalid Ethereum address format: abc123",
  "status_code": 400
}
Common error codes:
  • 400 - Invalid request (bad address format, missing parameters)
  • 401 - Authentication required (for live tools without API key)
  • 404 - Resource not found
  • 500 - Server error