Skip to main content

​
MCP Tools Reference

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

​
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_MCP_API_KEY environment variable to be set.

​
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_MCP_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"
}

​
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