Cred Protocol
Pontuação de crédito on-chain, relatórios financeiros e verificação de identidade para endereços Ethereum. Obtenha pontuações de crédito (300-1000), valores de portfólio e atestações de identidade.
Documentação
Visão Geral dos Serviços MCP
Acesse a pontuação de crédito e reputação de agentes do Cred Protocol através do Model Context Protocol para agentes de IA
Serviços MCP
O Cred Protocol fornece serviços de Model Context Protocol (MCP) que permitem que agentes e assistentes de IA acessem dados de pontuação de crédito on-chain, relatórios financeiros, atestados de identidade e reputação de agentes.
Info
MCP é um protocolo aberto que permite que sistemas de IA interajam de forma segura com ferramentas e fontes de dados externas. Saiba mais sobre MCP →
O que é MCP?
O Model Context Protocol (MCP) é uma forma padronizada para agentes de IA (como Claude, GPT ou aplicações LLM personalizadas) de:
- Descobrir ferramentas disponíveis e suas capacidades
- Chamar ferramentas com parâmetros estruturados
- Receber respostas estruturadas
Diferente das APIs REST tradicionais que exigem integração manual, o MCP permite que agentes de IA entendam e usem suas ferramentas automaticamente através de linguagem natural.
Por que Usar os Serviços MCP?
Agentes de IA podem descobrir e usar as ferramentas do Cred Protocol sem código personalizado Usuários podem perguntar "Qual é a pontuação de crédito desta carteira?" e o agente resolve Dados reais de blockchain de mais de 10 redes EVM — pontuações de crédito, relatórios, identidade e mais Cobertura abrangente: pontuação, relatórios, identidade, detecção de sybil, reputação de agentesFerramentas Disponíveis (21 no Total)
Todas as ferramentas retornam dados on-chain em tempo real e exigem uma chave de API (Authorization: Bearer <your-api-key>).
| Ferramenta | Descrição |
|---|---|
| Pontuação de Crédito | |
get_credit_score | Obter pontuação de crédito (300-1000) para um endereço Ethereum |
get_credit_scores_batch | Obter pontuações para vários endereços de uma vez |
get_aggregate_score | Pontuação agregada única para vários endereços |
| Relatórios | |
get_financial_summary | Relatório financeiro abrangente com ativos, posições DeFi e atividade |
get_comprehensive_report | Relatório de crédito multi-chain completo com detalhamento por rede |
get_summary_report | Métricas agregadas sem detalhes por rede |
get_chain_report | Relatório detalhado para uma única blockchain |
get_chain_summary | Métricas resumidas para uma única blockchain |
| Portfólio | |
get_portfolio_value | Valor total do portfólio em USD em todas as redes |
get_chain_portfolio_value | Valor do portfólio em uma blockchain específica |
get_portfolio_composition | Detalhamento do portfólio por tipo de ativo (tokens, DeFi, stablecoins, dívida) |
| Identidade | |
get_identity_attestations | Credenciais de identidade verificadas (ENS, Gitcoin Passport, POAPs) |
get_sybil_score | Pontuação de detecção de sybil com indicadores comportamentais |
| Grafo | |
get_transaction_graph | Visualização do grafo de transferência de tokens (nós + arestas) |
| Agentes (ERC-8004) | |
get_agent_count | Total de agentes registrados no Identity Registry |
list_agents | Lista paginada de todos os agentes registrados |
get_agent | Obter informações de um agente específico por ID |
search_agents | Buscar agentes por nome ou descrição |
submit_agent_reputation | Enviar feedback de reputação on-chain (10 CU) |
get_agent_reputation | Ler resumo de reputação on-chain (1 CU) |
get_reputation_status | Acompanhar o status de um envio de reputação |
Nota
Todas as ferramentas exigem uma chave de API. Gere uma no Cred Protocol Dashboard.
Reputação de Agentes (ERC-8004)
Além da pontuação de crédito de carteiras, os serviços MCP do Cred Protocol fornecem acesso completo aos ERC-8004 Identity e Reputation Registries na Base — permitindo que agentes de IA descubram, avaliem e classifiquem outros agentes on-chain.
7 ferramentas de agentes cobrem o ciclo de vida completo:
- Descoberta —
get_agent_count,list_agents,search_agents,get_agent - Pontuação de reputação —
submit_agent_reputationcalcula pontuação de crédito, risco de sybil e atestados de identidade, e então grava os resultados on-chain - Leitura de reputação —
get_agent_reputationlê feedback agregado do Reputation Registry - Acompanhamento —
get_reputation_statusacompanha envios on-chain assíncronos
Info
O ERC-8004 define um padrão para registrar identidades de agentes de IA on-chain como tokens ERC-721. Cada agente tem um endereço de proprietário e metadados (nome, descrição, imagem) armazenados via tokenURI. O registro está na Base (chain ID 8453).
Diferente das ferramentas de pontuação de crédito que avaliam a reputação de carteiras, as ferramentas de agentes operam na camada de agentes — ajudando sistemas de IA a descobrir, avaliar e fornecer feedback sobre outros agentes de IA no ecossistema.
Métodos de Acesso
Os serviços MCP do Cred Protocol podem ser acessados de duas formas:
1. Endpoints HTTP/REST
Endpoints HTTP padrão em https://api.credprotocol.com/mcp/* — funciona com qualquer cliente HTTP:
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.credprotocol.com/mcp/score/vitalik.eth"
Cada rota /mcp/* é um pass-through para o endpoint /api/v2/* equivalente, então aceita as mesmas credenciais — uma chave de API, um X-PAYMENT x402, ou um Authorization: Payment … MPP — e retorna o mesmo desafio 402 quando nenhum é fornecido. Os preços estão listados em GET /mcp/tools; veja Machine Payments.
2. Protocolo MCP
Protocolo MCP nativo para agentes de IA como Cursor, Claude Code, Claude Desktop ou clientes MCP personalizados. Usa transporte streamable-http — um único endpoint que lida tanto com requisição/resposta quanto com streaming:
{
"mcpServers": {
"cred-protocol": {
"url": "https://api.credprotocol.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Instruções de Habilidades do Agente
Quando um agente de IA se conecta via MCP, o servidor fornece automaticamente instruções de habilidades que orientam o agente sobre:
- Qual ferramenta usar para diferentes intenções do usuário
- Como interpretar pontuações de crédito, resumos financeiros e atestados
- Quando escalar de uma verificação rápida de pontuação para um relatório financeiro completo
- Melhores práticas como agrupar requisições e sinalizar alertas
Essas instruções são entregues aos agentes durante a inicialização do MCP — sem necessidade de configuração extra. Veja a referência completa de Agent Skill.
MCP vs API REST
| Recurso | Serviços MCP | API REST |
|---|---|---|
| Dados | Dados on-chain em tempo real | Dados on-chain em tempo real |
| Autenticação | Chave de API necessária | Chave de API necessária |
| Propósito | Agentes e assistentes de IA | Aplicações de produção |
| Protocolo | MCP (streamable-http) + HTTP | HTTP |
| Cobrança | Consome Cred Units | Consome Cred Units |