Skip to main content

Getting Started with MCP Services

This guide shows you how to connect to Cred Protocol’s MCP services using different methods.

Prerequisites

All MCP endpoints require an API key. Generate one from the Cred Protocol Dashboard.

Method 1: HTTP Endpoints (Simplest)

The easiest way to use MCP services is through the HTTP endpoints.

Base URL

https://api.credprotocol.com/mcp

Quick Test

# Get a credit score
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.credprotocol.com/mcp/score/vitalik.eth"

# List available tools
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.credprotocol.com/mcp/tools"

Response

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "score": 774,
  "decile": 5,
  "range": "good",
  "model_version": "andromeda_1.0",
  "timestamp": "2026-03-31T06:21:16.423948Z",
  "source": "live"
}

Method 2: Cursor IDE Integration

If you’re using Cursor, you can integrate Cred Protocol as an MCP server.

Step 1: Configure Cursor

Add to your .cursor/mcp.json file:
{
  "mcpServers": {
    "cred-protocol": {
      "url": "https://api.credprotocol.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Step 2: Use in Cursor

Once configured, you can ask Cursor’s AI:
“What’s the credit score for vitalik.eth?”
The AI will automatically call the MCP tool and respond with the result.

Method 3: Claude Code

For Claude Code (CLI, desktop app, or IDE extensions), add to your project’s .mcp.json:
{
  "mcpServers": {
    "cred-protocol": {
      "type": "url",
      "url": "https://api.credprotocol.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Once configured, you can ask Claude Code directly:
“What’s the credit score for vitalik.eth?”

Method 4: Claude Desktop

For Claude Desktop, add to your MCP configuration:
{
  "mcpServers": {
    "cred-protocol": {
      "url": "https://api.credprotocol.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Method 5: Custom HTTP Client

Build your own client using standard HTTP requests:

Python

import httpx

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.credprotocol.com/mcp"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

async def get_credit_score(address: str) -> dict:
    """Get credit score via MCP HTTP endpoint."""
    async with httpx.AsyncClient() as client:
        response = await client.get(
            f"{BASE_URL}/score/{address}",
            headers=HEADERS,
        )
        return response.json()

# Usage
score = await get_credit_score("vitalik.eth")
print(f"Score: {score['score']} ({score['range']})")

JavaScript/TypeScript

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://api.credprotocol.com/mcp";

async function getCreditScore(address: string): Promise<CreditScore> {
  const response = await fetch(`${BASE_URL}/score/${address}`, {
    headers: { Authorization: `Bearer ${API_KEY}` },
  });
  return response.json();
}

// Usage
const score = await getCreditScore("vitalik.eth");
console.log(`Score: ${score.score} (${score.range})`);

Available Endpoints

All endpoints require Authorization: Bearer YOUR_API_KEY header. Score & Reports:
EndpointMethodDescription
/mcp/score/{address}GETGet credit score
/mcp/score/batchPOSTBatch score multiple addresses
/mcp/score/aggregate?addresses=...GETAggregated score for multiple addresses
/mcp/summary/{address}GETGet financial summary
/mcp/report/{address}GETComprehensive multi-chain credit report
/mcp/report/{address}/summaryGETSummary report (no per-chain details)
/mcp/report/{address}/chain/{chain_id}GETSingle-chain detailed report
/mcp/report/{address}/chain/{chain_id}/summaryGETSingle-chain summary
Portfolio:
EndpointMethodDescription
/mcp/portfolio/{address}GETGet total portfolio value
/mcp/portfolio/{address}/chain/{chain_id}GETGet chain-specific portfolio
/mcp/portfolio/{address}/compositionGETPortfolio breakdown by asset type
Identity & Graph:
EndpointMethodDescription
/mcp/identity/{address}GETGet identity attestations
/mcp/identity/{address}/sybilGETSybil detection score
/mcp/graph/{address}?chain_id=1GETTransaction graph visualization
Agents (ERC-8004):
EndpointMethodDescription
/mcp/agents/countGETTotal registered agents
/mcp/agentsGETPaginated agent list
/mcp/agents/search?q={query}GETSearch agents by name/description
/mcp/agents/{agent_id}GETGet agent info by ID
/mcp/agents/{agent_id}/reputationPOSTSubmit reputation feedback (10 CU)
/mcp/agents/{agent_id}/reputationGETRead reputation summary (1 CU)
/mcp/agents/{agent_id}/reputation/status/{id}GETTrack submission status
/mcp/toolsGETList all available tools

Next Steps

Explore Tools

Learn about each available tool

See Examples

Practical usage examples