Behavioural Prediction MCP

O servidor MCP de Previsão Comportamental fornece ferramentas baseadas em IA para analisar previsão de comportamento de carteiras, detecção de fraudes e previsão de rug pulls.

GitHub

Experimente este MCPPatrocinado

Documentação

🧠 ChainAware Behavioural Prediction MCP Server

Nome do Servidor MCP: ChainAware Behavioural Prediction MCP

Categoria: Web3 / Segurança / Análise DeFi

Status: Ferramentas públicas – Backend privado

Acesso: Sob solicitação (chave de API · pagamento x402 suportado)

URL do Servidor: [https://prediction.mcp.chainaware.ai/sse]

Repositório: [https://github.com/ChainAware/behavioral-prediction-mcp]

Site: [https://chainaware.ai/]

Twitter: [https://x.com/ChainAware/]

LinkedIn: [https://www.linkedin.com/company/chainaware]

Blog: [https://chainaware.ai/blog]

Aprenda: [https://chainaware.ai/learn]

Exemplos: [https://github.com/ChainAware/examples]

Destaque em: CB Insights Fraud Prevention Market Map for the AI Era — ChainAware reconhecida como uma solução líder de prevenção a fraudes para Web3 na era da IA (2026).

Listada em: BNB Chain AI Landscape — ChainAware listada pela BNB Chain como um projeto-chave de IA no ecossistema (2025).

Listada em: BNB Chain Kickstart — Marketing Tools — Growth Agents e Wallet Marketer da ChainAware em destaque na seção Marketing Tools do programa BNB Chain Kickstart (2025).

Premiada: Google Cloud $250k Grant — ChainAware selecionada para uma bolsa de US$ 250.000 do Google Cloud (2025).

Selecionada para: AWS Fintech Accelerator — ChainAware aceita no programa AWS Fintech Accelerator (2024).

Listada em: Safary Club Web3 Growth Landscape — Growth Tools — ChainAware em destaque na categoria Growth Tools for Web3 Projects (2024).

mcp-name: io.github.ChainAware/chainaware-behavioral-prediction-mcp

📖 Descrição

O Behavioural Prediction MCP Server fornece ferramentas com tecnologia de IA para analisar previsão de comportamento de carteiras, detecção de fraudes e previsão de rug pull.

Desenvolvedores e plataformas podem integrar essas ferramentas por meio do protocolo MCP para proteger usuários de DeFi, monitorar riscos de liquidez e avaliar a confiabilidade de carteiras ou contratos.

Todas as ferramentas seguem o Model Context Protocol (MCP) e podem ser consumidas por clientes compatíveis com MCP.

Backtesting verificado: 98% de precisão na detecção preditiva de fraudes · 90,1% de precisão na detecção de rug pull

🏆 A ChainAware está em destaque no CB Insights Fraud Prevention Market Map for the AI Era — reconhecida como uma solução líder de prevenção a fraudes com IA para Web3 (2026). 🌐 A ChainAware está listada no BNB Chain AI Landscape — reconhecida como um projeto-chave de IA no ecossistema BNB Chain (2025). 🚀 A ChainAware está listada no BNB Chain Kickstart — Marketing Tools — Growth Agents e Wallet Marketer em destaque no programa oficial da BNB Chain para crescimento do ecossistema (2025). 💰 A ChainAware recebeu uma $250k Google Cloud Grant — selecionada pelo Google Cloud para desenvolvimento de infraestrutura e IA (2025). ☁️ A ChainAware foi aceita no AWS Fintech Accelerator — selecionada pela AWS para seu programa Fintech Accelerator (2024). 🌱 A ChainAware está em destaque no Safary Club Web3 Growth Landscape — Growth Tools — listada na categoria Growth Tools for Web3 Projects (2024).

⚙️ Ferramentas Disponíveis

1. Ferramenta de Detecção Preditiva de Fraudes

ID: predictive_fraud

Descrição: Este algoritmo com tecnologia de IA prevê a probabilidade de atividade fraudulenta em um determinado endereço de carteira antes que ela aconteça (≈98% de precisão em backtesting) e realiza verificações de AML/Combate à Lavagem de Dinheiro. Use esta ferramenta quando o usuário quiser uma avaliação de risco ou alerta antecipado sobre um endereço de blockchain.

➡️ Exemplos de Casos de Uso:

• É seguro interagir com vitalik.eth?
• Qual é o status fraudulento deste endereço?
• Minha nova carteira está em risco de ser usada para fraudes?

Entradas:

Nome	Tipo	Obrigatório	Descrição
`apiKey`	string	✅*	Chave de API da ChainAware — ou omita ao usar pagamentos x402
`network`	string	✅	Rede blockchain (`ETH`, `BNB`,`POLYGON`,`TON`,`BASE`, `TRON`, `HAQQ`)
`walletAddress`	string	✅	O endereço da carteira a ser avaliado

Saídas (JSON):

{
  "message": "string",                         // e.g. “Success” or error description
  "walletAddress": "string",                   // blockchain wallet address that was analyzed
  "chain": "string",                           // blockchain network identifier (e.g. ETH, BNB,POLYGON,TON,BASE, TRON, HAQQ)
  "status": "string",                          // classification result (e.g. “Fraud” | “Not Fraud” | “New Address”)
  "probabilityFraud": "0.00–1.00",             // decimal fraud probability score (string to preserve precision)
  
  "token": "string | null",                    // optional token associated with the check (may be null)
  "lastChecked": "ISO-8601 timestamp",         // last time the wallet risk analysis was executed
  
  "forensic_details": {
    "cybercrime": "string",                    // indicator score for cybercrime activity
    "money_laundering": "string",              // indicator score for money laundering activity
    "number_of_malicious_contracts_created": "string",  // number of malicious contracts deployed by this wallet
    "gas_abuse": "string",                     // gas abuse indicator
    "financial_crime": "string",               // financial crime indicator
    "darkweb_transactions": "string",          // interaction with darkweb-linked wallets
    "reinit": "string",                        // reinitialization exploit indicator
    "phishing_activities": "string",           // phishing activity indicator
    "fake_kyc": "string",                      // fake KYC related activity
    "blacklist_doubt": "string",               // suspected blacklist association
    "fake_standard_interface": "string",       // fake ERC interface indicator
    "data_source": "string",                   // source of forensic intelligence (may be empty)
    "stealing_attack": "string",               // stealing attack indicator
    "blackmail_activities": "string",          // blackmail activity indicator
    "sanctioned": "string",                    // sanction exposure indicator
    "malicious_mining_activities": "string",   // malicious mining indicator
    "mixer": "string",                         // interaction with mixing services
    "fake_token": "string",                    // fake token creation or usage indicator
    "honeypot_related_address": "string"       // interaction with honeypot-related addresses
  },
  "checked_times": 0,                          // integer — number of times this wallet has been analyzed
  
  "createdAt": "ISO-8601 timestamp",           // record creation timestamp
  "updatedAt": "ISO-8601 timestamp",           // record last update timestamp

  "sanctionData": [
    {
      "category": "string | null",              // sanction category (may be null)
      "name": "string | null",                  // sanction list name
      "description": "string | null",           // sanction description
      "url": "string | null",                   // source URL for sanction information
      "isSanctioned": false,                    // boolean — whether the wallet is officially sanctioned
      "createdAt": "ISO-8601 timestamp",        // sanction record creation timestamp
      "updatedAt": "ISO-8601 timestamp"         // sanction record last update timestamp
    }
  ]
}

Casos de erro:

    • `402 Payment Required` → pagamento x402 necessário — clientes compatíveis liquidam automaticamente  
• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

2. Ferramenta de Detecção Preditiva de Fraudes em Lote

ID: predictive_fraud_batch

Descrição: Este algoritmo com tecnologia de IA prevê a probabilidade de atividade fraudulenta em um determinado endereço de carteira antes que ela aconteça (≈98% de precisão) e realiza verificações de AML/Combate à Lavagem de Dinheiro em lote. Agende um job de cálculo de fraude em lote para uma lista de endereços de carteira. Use esta ferramenta quando o usuário fornecer um CSV ou lista de endereços para análise. Retorna um job_id e assinatura imediatamente — informe o job_id ao usuário e armazene tanto o job_id quanto a assinatura no contexto; eles são necessários para todas as chamadas de acompanhamento. NÃO faça polling nem aguarde resultados após o agendamento.

➡️ Exemplos de Casos de Uso:

• Executar lote de fraude para esta lista de endereços na rede ETH?
• Qual é o status fraudulento destes endereços na BNB?

Entradas:

Nome	Tipo	Obrigatório	Descrição
`apiKey`	string	✅*	Chave de API da ChainAware — ou omita ao usar pagamentos x402
`network`	string	✅	Rede blockchain (`ETH`, `BNB`,`POLYGON`,`TON`,`BASE`, `TRON`, `HAQQ`)
`addresses`	array[objects]	✅	A lista de endereços de carteira a ser avaliada

Saídas (JSON):

{
  "message": "Job scheduled successfully.",
  "job_id": "0fc5897a-ad64-4f21-88b5-1274d1cfec46",
  "signature": "260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a",
  "total_items": 5,
  "chunks_enqueued": 1,
  "status": "pending"
}

Casos de erro:

    • `402 Payment Required` → pagamento x402 necessário — clientes compatíveis liquidam automaticamente  
• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

3. Ferramenta de Análise Preditiva de Comportamento

ID: predictive_behaviour

Use esta ferramenta quando precisar de:

  • Previsões de próxima melhor ação e intenções ("Este endereço vai depositar, negociar ou fazer staking?")  
  • Um perfil de tolerância a risco e experiência  
  • Segmentação por categoria (ex.: NFT, DeFi, uso de Bridge)  
  • Recomendações personalizadas com base em padrões históricos

➡️ Exemplos de Casos de Uso:

• "O que este endereço fará em seguida?"  
• "O usuário é de alto risco ou experiente?"  
• "Recomende as melhores estratégias DeFi para 0x1234... na rede ETH."

Entradas:

Nome	Tipo	Obrigatório	Descrição
`apiKey`	string	✅*	Chave de API da ChainAware — ou omita ao usar pagamentos x402
`network`	string	✅	Rede blockchain (`ETH`, `BNB`,`BASE`,`HAQQ`,`SOLANA`)
`walletAddress`	string	✅	O endereço da carteira a ser avaliado

Saídas (JSON):

{
      "message": "string",                           // e.g. “Success” or error description
      "walletAddress": "string",                     // blockchain wallet address analyzed
      "status": "string",                            // fraud classification result (e.g. “Fraud” | “Not Fraud” | “New Address”)

      "probabilityFraud": "0.00–1.00",               // decimal probability score indicating fraud risk
      "token": "string | null",                      // optional token context for the analysis
      "chain": "string",                             // blockchain network identifier (e.g. ETH, BNB,BASE,HAQQ,SOLANA)

      "lastChecked": "ISO-8601 timestamp",           // last time the wallet was analyzed

      "forensic_details": {
        "cybercrime": "string",                      // indicator of cybercrime association
        "money_laundering": "string",                // money laundering activity indicator
        "number_of_malicious_contracts_created": "string", // malicious contracts deployed by wallet
        "gas_abuse": "string",                       // abnormal gas usage indicator
        "financial_crime": "string",                 // financial crime activity indicator
        "darkweb_transactions": "string",            // interaction with darkweb-linked wallets
        "reinit": "string",                          // contract reinitialization exploit indicator
        "phishing_activities": "string",             // phishing activity indicator
        "fake_kyc": "string",                        // fake KYC interaction indicator
        "blacklist_doubt": "string",                 // suspected blacklist association
        "fake_standard_interface": "string",         // fake token interface indicator
        "data_source": "string",                     // source of forensic intelligence
        "stealing_attack": "string",                 // stealing attack indicator
        "blackmail_activities": "string",            // blackmail activity indicator
        "sanctioned": "string",                      // sanction exposure indicator
        "malicious_mining_activities": "string",     // malicious mining activity indicator
        "mixer": "string",                           // interaction with mixing services
        "fake_token": "string",                      // fake token creation/use indicator
        "honeypot_related_address": "string"         // honeypot contract interaction indicator
      },

      "categories": [
        {
          "Category": "string",                      // wallet interaction category (e.g. DeFi, NFT, Bridge)
          "Count": 0                                 // number of transactions/interactions in this category
        }
      ],

      "riskProfile": [
        {
          "Category": "Risk_Profile",                 // willingnes to take risk object
          "Balance_age": 0.0                         // 1-10 willingnes to take risk value
        }
      ],

      "segmentInfo": "string (JSON encoded)",        // serialized JSON containing protocol engagement flags (e.g "{\"Maker\":0,\"Aave_borrow\":0,\"Aave_lend\":1,\"Lido\":0,\"Uniswap\":1,\"Compound_lend\":0,\"Compound_borrow\":0}")

      "experience": {
        "Type": "string",                            // descriptor label (e.g. “Experience”)
        "Value": 0                                   // numeric experience score level
      },

      "intention": {
        "Type": "string",                            // descriptor label (e.g. “Intentions”)
        "Value": {
          "Prob_Lend": "Low | Medium | High",
          "Prob_Trade": "Low | Medium | High",
          "Prob_Game": "Low | Medium | High",
          "Prob_NFT": "Low | Medium | High",
          "Prob_Stake_ETH": "Low | Medium | High",
          "Prob_Borrow": "Low | Medium | High",
          "Prob_Gamble": "Low | Medium | High",
          "Prob_Stake": "Low | Medium | High",
          "Prob_Yield_Farm": "Low | Medium | High",
          "Prob_Leveraged_Stake": "Low | Medium | High",
          "Prob_Leveraged_Stake_ETH": "Low | Medium | High",
          "Prob_Leveraged_Lend": "Low | Medium | High",
          "Prob_Leverage_Long_ETH": "Low | Medium | High",
          "Prob_Leverage_Long": "Low | Medium | High"
        }
      },

      "protocols": [
        {
          "Protocol": "string",                      // protocol name (e.g. Uniswap, Curve, MakerDAO)
          "Count": 0                                 // number of interactions with this protocol
        }
      ],

      "userDetails": {
        "wallet_age_days": 0,                        // age of wallet in days
        "total_balance_usd": 0.0,                    // current wallet balance in USD
        "transaction_count": 0,                      // total number of transactions executed
        "wallet_rank": 0                             // ranking of wallet in the scoring system
      },

      "riskCapability": 0,                           // numeric risk capability score

      "recommendation": {
        "Type": "string",                            // descriptor label (e.g. “Recommendation”)
        "Value": [
          "string"                                   // recommended strategies or actions
        ]
      },

      "checked_times": 0,                            // number of times the wallet analysis was executed
      "createdAt": "ISO-8601 timestamp",             // record creation timestamp
      "updatedAt": "ISO-8601 timestamp",             // record last update timestamp

      "sanctionData": [
        {
          "category": "string | null",               // sanction category
          "name": "string | null",                   // sanction list name
          "description": "string | null",            // sanction description
          "url": "string | null",                    // reference source URL
          "isSanctioned": false,                     // whether the wallet is officially sanctioned
          "createdAt": "ISO-8601 timestamp",
          "updatedAt": "ISO-8601 timestamp"
        }
      ]
    }

Casos de erro:

    • `402 Payment Required` → pagamento x402 necessário — clientes compatíveis liquidam automaticamente  
• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

4. Ferramenta de Análise Preditiva de Comportamento em Lote

ID: predictive_behaviour_batch

Descrição: Este mecanismo orientado por IA projeta quais são as intenções de um endereço de carteira ou o que o endereço provavelmente fará em seguida, traça o perfil de seu histórico on-chain passado e recomenda ações personalizadas. Agende um job de cálculo de auditoria em lote (previsão de comportamento em lote) para uma lista de endereços de carteira. Use esta ferramenta quando o usuário fornecer um CSV ou lista de endereços para análise. Retorna um job_id e assinatura imediatamente — informe o job_id ao usuário e armazene tanto o job_id quanto a assinatura no contexto; eles são necessários para todas as chamadas de acompanhamento. NÃO faça polling nem aguarde resultados após o agendamento.

Use esta ferramenta quando precisar de:

  • Previsões de próxima melhor ação e intenções ("Estes endereços vão depositar, negociar ou fazer staking?")  
  • Um perfil de tolerância a risco e experiência para uma determinada lista de endereços
  • Segmentação por categoria (ex.: NFT, DeFi, uso de Bridge)  
  • Recomendações personalizadas com base em padrões históricos

➡️ Exemplos de Casos de Uso:

• "O que estes endereços farão em seguida?"  
• "Estes usuários são de alto risco ou experientes?"  
• "Recomende as melhores estratégias DeFi para [{ox1..,0x2,0x3}] na rede ETH."

Entradas:

Nome	Tipo	Obrigatório	Descrição
`apiKey`	string	✅*	Chave de API da ChainAware — ou omita ao usar pagamentos x402
`network`	string	✅	Rede blockchain (`ETH`, `BNB`,`BASE`,`HAQQ`,`SOLANA`)
`addresses`	array[objects]	✅	O endereço da carteira a ser avaliado

Saídas (JSON):

{
  "message": "Job scheduled successfully.",
  "job_id": "0fc5897a-ad64-4f21-88b5-1274d1cfec46",
  "signature": "260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a",
  "total_items": 5,
  "chunks_enqueued": 1,
  "status": "pending"
}

Casos de erro:

    • `402 Payment Required` → pagamento x402 necessário — clientes compatíveis liquidam automaticamente  
• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

5. Ferramenta Preditiva de Detecção de Rug‑Pull

ID: predictive_rug_pull

Descrição: Este mecanismo com tecnologia de IA prevê quais pools de liquidez ou contratos provavelmente realizarão um "rug pull" no futuro (90,1% de precisão em backtesting). Use esta ferramenta quando precisar alertar usuários antes que eles depositem em pools arriscados ou para monitorar a segurança de contratos inteligentes on-chain.

➡️ Exemplos de Casos de Uso:

• "Este novo pool DeFi vai fazer rug pull se eu fizer staking dos meus ativos?"  
• "Monitore minha posição de LP para possíveis explorações futuras."

Entradas:

Nome	Tipo	Obrigatório	Descrição
`apiKey`	string	✅*	Chave de API da ChainAware — ou omita ao usar pagamentos x402
`network`	string	✅	Rede blockchain (`ETH`, `BNB`, `BASE`, `HAQQ`)
`walletAddress`	string	✅	Endereço do contrato inteligente ou pool de liquidez

Saídas (JSON):

{
      "message": "string",                         // e.g. “Success” or error description

      "contractAddress": "string",                 // smart contract address analyzed
      "pairAddress": "string",                     // liquidity pair address on DEX
      "contractCreatorAddress": "string | null",   // creator address of the contract if known

      "risk_score": 0,                             // numeric internal risk score
      "risk_status": "string",                     // qualitative risk level (e.g. “Low Risk”, “Medium Risk”, “High Risk”)

      "risk_indicators": {
        "is_honeypot": 0,                          // honeypot detection flag
        "honeypot_with_same_creator": 0,           // creator deployed previous honeypots
        "can_take_back_ownership": 0,              // contract allows reclaiming ownership
        "is_mintable": 0,                          // token supply can be minted
        "hidden_owner": 0,                         // hidden ownership mechanism detected

        "buy_tax": 0,                              // buy transaction tax percentage
        "sell_tax": 0,                             // sell transaction tax percentage

        "cannot_buy": 0,                           // trading restriction preventing buys
        "cannot_sell_all": 0,                      // restriction preventing full sell

        "is_blacklisted": 0,                       // blacklist functionality detected
        "is_whitelisted": 0,                       // whitelist-only functionality detected

        "creator_percent": 0,                      // percentage of supply owned by creator
        "lp_holders_locked": false,                // liquidity lock status

        "liquidity": 0.0,                          // liquidity amount in base token
        "market_cap": 0,                           // estimated market capitalization

        "is_in_dex": 0,                            // token listed on DEX

        "slippage_modifiable": 0,                  // contract can modify slippage parameters
        "transfer_pausable": 0,                    // transfers can be paused
        "is_anti_whale": 0,                        // anti-whale protection mechanism
        "anti_whale_modifiable": 0,                // anti-whale parameters modifiable

        "trading_cooldown": 0,                     // cooldown period between trades
        "personal_slippage_modifiable": 0,         // per-wallet slippage modification

        "is_open_source": 0,                       // contract source verified
        "is_proxy": 0,                             // proxy contract indicator

        "owner_address": "string",                 // owner address of contract
        "owner_change_balance": 0,                 // owner ability to modify balances

        "selfdestruct": 0,                         // self-destruct capability
        "external_call": 0,                        // external calls present
        "gas_abuse": 0                             // abnormal gas manipulation behavior
      },

      "liquidityEvent": [
        {
          "eventType": "string",                   // liquidity event type (e.g. add/remove)
          "amount": 0.0,                           // liquidity amount affected
          "token": "string",                       // token symbol involved in liquidity

          "tx_hash": "string",                     // transaction hash

          "from_address": "string",                // address initiating liquidity action
          "from_fraud_probability": "0.00–1.00",   // fraud probability score for sender
          "from_fraud_status": "string",           // fraud classification of sender

          "createdAt": "ISO-8601 timestamp"        // timestamp of liquidity event
        }
      ],

      "status": "string",                          // overall fraud classification of contract
      "probabilityFraud": "0.00–1.00",             // probability of contract being fraudulent

      "chain": "string",                           // blockchain network identifier (e.g. BNB, ETH, BASE, HAQQ)
      "lastChecked": "ISO-8601 timestamp",         // last time contract analysis was performed

      "contractCreationTime": "ISO-8601 timestamp | null", // contract deployment timestamp

      "forensic_details": {
        "owner": "object",                         // owner metadata
        "privilege_withdraw": 0,                   // privileged withdraw capability
        "withdraw_missing": 0,                     // missing withdraw function
        "is_open_source": 0,                       // contract source verification status
        "blacklist": 0,                            // blacklist functionality
        "contract_name": "string",                 // contract/token name
        "selfdestruct": 0,                         // self-destruct capability
        "is_proxy": 0,                             // proxy contract indicator
        "approval_abuse": 0                        // abnormal token approval behavior
      },

      "checked_times": 0,                          // number of times contract has been analyzed

      "createdAt": "ISO-8601 timestamp",           // record creation time
      "updatedAt": "ISO-8601 timestamp"            // last update time
    }

Casos de erro: • 402 Payment Required → pagamento x402 exigido — clientes compatíveis liquidam automaticamente
• 400 Bad Request → network ou walletAddress malformados
• 500 Internal Server Error → falha temporária downstream

6. Ferramenta de Pontuação de Crédito

ID: credit_score

Descrição: Pontuação de crédito/confiança cripto orientada por IA para carteiras blockchain. Combina probabilidade de fraude, análises de entrada/saída on-chain e análise de grafo social para produzir uma riskRating de 1 (maior risco) a 9 (maior confiança). Projetada para protocolos de empréstimo DeFi que precisam de um sinal rápido e numérico de credibilidade por carteira.

➡️ Exemplos de casos de uso:

• "Qual é a pontuação de crédito desta carteira?"
• "Qual é a pontuação de confiança calculada para este tomador?"
• "Calcule a pontuação de crédito antes de aprovar este empréstimo."

Entradas:

Nome	Tipo	Obrigatório	Descrição
`apiKey`	string	✅*	Chave de API ChainAware — ou omita ao usar pagamentos x402
`network`	string	✅	Rede blockchain (`ETH`)
`walletAddress`	string	✅	O endereço da carteira a ser pontuado

Saídas (JSON):

{
  "message": "Success",
  "creditData": {
    "riskRating": 7,
    "walletAddress": "0x..."
  }
}

riskRating	Nível de Risco	Interpretação para Empréstimos
9	Risco Muito Baixo	Tomador primário
7–8	Risco Baixo	Tomador confiável
5–6	Risco Moderado	Cautela elevada
3–4	Risco Alto	Termos restritos
1–2	Risco Muito Alto	Recusar

Casos de erro:

• `401 Unauthorized` → `apiKey` inválido (não aplicável ao usar pagamentos x402)
• `400 Bad Request` → `network` ou `walletAddress` malformados
• `500 Internal Server Error` → falha temporária downstream

7. Ferramenta de Lista de Classificação de Tokens

ID: token_rank_list

Descrição: TokenRank analisa a comunidade de detentores de tokens e classifica cada token pela força de seus detentores. Quanto mais fortes os detentores do token, mais forte é o token! Use esta ferramenta quando precisar saber a classificação de um token ou de tokens, ou comparar entre diferentes categorias e redes. Você pode usar busca, filtro, ordenação e paginação, que retorna uma lista de tokens.

➡️ Exemplos de casos de uso: – "Qual é o melhor token na categoria AI Token?"
– "Compare o token x na rede ETH e na rede BNB?"

Entradas:

Nome	Tipo	Obrigatório	Descrição
`limit`	string	✅	Número de itens a buscar durante a paginação
`offset`	string	✅	Número da página (deslocamento) durante a paginação
`network`	string		Rede blockchain para filtrar (`ETH`, `BNB`, `BASE`, `SOLANA`)
`sort_by`	string		Ordenar os tokens retornados com base em (ex.: 'communityRank')
`sort_order`	string		'ASC' ou 'DESC' para ordenar o valor de sort_by
`category`	string		Filtrar com base na categoria do token (ex.: 'AI Token','RWA Token','DeFi Token','DeFAI Token','DePIN Token')
`contract_name`	string		Buscar com base no nome do contrato

Saídas (JSON):

  {
    "message": "string",                    // e.g. “Successfully fetched records” or error description
    "data": {
      "total": 0,                           // integer — total number of matching contracts
      "contracts": [
        {
          "contractAddress": "string",       // unique contract or mint address (chain-specific format)
          "contractName": "string",          // human-readable token name
          "ticker": "string",                // token symbol (usually uppercase, but not guaranteed)
          "chain": "string",                 // blockchain network (e.g. SOLANA | ETH | BNB | BASE)
          "category": "string",              // primary category label (e.g. 'AI Token','RWA Token','DeFi Token','DeFAI Token','DePIN Token') 
          "type": "string",                  // asset classification (e.g. “token” | “nft”)
          "communityRank": 0,                // integer — raw ranking based on community metrics
          "normalizedRank": 0,               // integer — normalized or scaled ranking score
          "totalHolders": 0,                 // integer — total unique wallet holders
          "lastProcessedAt": "ISO-8601",     // timestamp when analytics were last computed
          "createdAt": "ISO-8601",           // record creation timestamp
          "updatedAt": "ISO-8601"            // record last update timestamp
        }
      ]
    }
  }

Casos de erro:

• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

8. Ferramenta de Classificação de Token Único

ID: token_rank_single

Descrição: Semelhante à Lista de Classificação de Tokens, o TokenRank analisa a comunidade de detentores de tokens e classifica cada token pela força de seus detentores. Além da classificação do token e dos detalhes do token, a ferramenta de classificação de token único busca os melhores detentores, seus detalhes e sua classificação global, juntamente com outros na mesma rede. Use esta ferramenta quando precisar saber a classificação de um único token com base no endereço do contrato e na rede ou chain exata, ou quando precisar dos melhores detentores de um token específico em uma rede ou chain específica.

➡️ Exemplos de casos de uso: – "Qual é a classificação do token na rede ETH?"
– "Quais são os melhores detentores deste endereço de contrato do token?"
– "Qual é a classificação do token e seus melhores detentores?"

Entradas:

Nome	Tipo	Obrigatório	Descrição
`contract_address`	string	✅	O endereço do contrato do token a ser avaliado
`network`	string	✅	Rede blockchain para filtrar (`ETH`, `BNB`, `BASE`, `SOLANA`)

Saídas (JSON):

 {
      "message": "string",                      // e.g. “Successfully fetched records” or error description
      "data": {
        "contract": {
            "contractAddress": "string",       // unique contract or mint address (chain-specific format)
            "contractName": "string",          // human-readable token name
            "ticker": "string",                // token symbol (usually uppercase, but not guaranteed)
            "chain": "string",                 // blockchain network (e.g. SOLANA | ETH | BNB | BASE)
            "category": "string",              // primary category label (e.g. 'AI Token','RWA Token','DeFi Token','DeFAI Token','DePIN Token') 
            "type": "string",                  // asset classification (e.g. “token” | “nft”)
            "communityRank": 0,                // integer — raw ranking based on community metrics
            "normalizedRank": 0,               // integer — normalized or scaled ranking score
            "totalHolders": 0,                 // integer — total unique wallet holders
            "lastProcessedAt": "ISO-8601",     // timestamp when analytics were last computed
            "createdAt": "ISO-8601",           // record creation timestamp
            "updatedAt": "ISO-8601"            // record last update timestamp
        },
        "topHolders": [
          {
            "contractAddress": "string",        // associated contract address
            "Holder": {
              "walletAddress": "string",        // holder wallet address
              "chain": "string",                // blockchain network of the wallet
              "balance": "string",              // token balance (string to preserve precision)
              "walletAgeInDays": 0,             // integer — age of wallet in days
              "transactionsNumber": 0,          // integer — total transaction count
              "totalPoints": 0.0,               // float — computed wallet scoring metric
              "globalRank": 0                   // integer — wallet rank across entire system
            }
          }
        ]
      }
    }

Casos de erro:

• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

9. Ferramenta de Execução de Auditoria de Token

ID: run_token_audit

Descrição: Solicita uma Auditoria de Token para um determinado contrato de token ou retorna dados de auditoria já calculados para o token solicitado. Esta ferramenta é do tipo "obter-ou-criar": primeiro verifica se uma auditoria concluída já existe para este contrato e, se existir, retorna o relatório de risco COMPLETO imediatamente. Se nenhuma auditoria existir ainda, ela enfileira uma nova e retorna um job_id + status "queued" (na fila).

Use esta ferramenta sempre que um usuário pedir para auditar, escanear, verificar ou avaliar um token/contrato
quanto a risco, sinais de golpe, comportamento de honeypot, risco de propriedade ou risco de liquidez. Esta deve
ser a PRIMEIRA e ÚNICA ferramenta chamada para uma nova solicitação — não chame get_token_audit_result
primeiro "apenas para verificar".

➡️ Exemplos de casos de uso: – "Audite este contrato de token para mim: 0x..." – "Este token BSC é seguro? 0x..." – "Execute uma varredura de risco neste contrato antes de eu comprar" – "Verifique se este endereço é um honeypot"

Entradas:

Nome	Tipo	Obrigatório	Descrição
`contract_address`	string	✅	O endereço do contrato do token a ser avaliado
`network`	string	✅	A rede/chain onde o token está (ex.: 'arbitrum', 'avalanche', 'base', 'bsc', 'eth', 'optimism', 'polygon')

Saídas (JSON):

📤 Resposta — DUAS formas possíveis, verifique qual você recebeu: 1. Em cache / já auditado → audit_status = "complete" O relatório de risco completo é retornado imediatamente (mesmo esquema de get_token_audit_result). Responda à pergunta do usuário diretamente com esses dados. Nenhuma chamada adicional de ferramenta é necessária.

2. Ainda não auditado → sem campo honeypot_analysis, em vez disso:

 {
    "contract_address": "string",
    "chain": "string",
    "job_id": "string",
    "status": "queued",
    "message": "string"  
  }

⚠️ Notas: • Não re-dispare uma nova auditoria para um contrato que retorna um job "queued"/"running" já em andamento. • Sempre verifique primeiro se o token foi auditado anteriormente com base na resposta, para obter diretamente o resultado auditado do token em vez de agendar um novo cálculo.

Casos de erro:

• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

10. Ferramenta de Obtenção de Resultado de Auditoria de Token

ID: get_token_audit_result

Descrição: Busca o status atual ou os resultados finais de um job de Auditoria de Token previamente acionado para um determinado endereço de contrato e chain. Esta é a SEGUNDA etapa do fluxo de auditoria, usada para consultar e recuperar o relatório de risco completo após "Run Token Audit" ter sido chamado. Chame esta ferramenta imediatamente após "Run Token Audit" para verificar o progresso e repetidamente (poll) até que o campo audit_status da resposta seja igual a "complete". Enquanto audit_status for qualquer outro valor (ex.: "queued", "running", "pending"), trate o resultado como ainda não pronto: não resuma dados parciais/vazios de módulos ao usuário, apenas informe que a auditoria ainda está em andamento (opcionalmente mostrando o tempo decorrido, se disponível) e consulte novamente em breve. Quando audit_status = "complete", esta ferramenta retorna um relatório de risco completo com múltiplos módulos — cobrindo controle de propriedade, saúde de liquidez, risco de oferta/mint, integridade de transferência, segurança de approve/permit, reentrância, comportamento de honeypot e uma pontuação de risco agregada de 0 a 100 com veredito. Use esses dados para responder diretamente à pergunta do usuário sobre segurança do token, fatores de risco ou bandeiras vermelhas — não busque nem re-dispare uma nova auditoria se um resultado concluído já existir para este contrato.

➡️ Exemplos de casos de uso: – "Minha auditoria para este token já está pronta?" – "Qual é a pontuação de risco e o veredito para este contrato?" – "Quem é o proprietário deste token, eles podem mintar ou colocar na lista negra?" – "Isto é um honeypot? Quais são as bandeiras?" – "Dê-me o detalhamento completo do risco de liquidez e propriedade deste contrato"

Entradas:

Nome	Tipo	Obrigatório	Descrição
`contract_address`	string	✅	O endereço do contrato do token a ser avaliado
`network`	string	✅	A rede/chain onde o token está (ex.: 'arbitrum', 'avalanche', 'base', 'bsc', 'eth', 'optimism', 'polygon')

Saídas (JSON):

  {
      "contract_address": "string",
      "chain": "string",
      "audit_status": "string",
      "token_name": "string",
      "token_symbol": "string",
      "token_decimals": "integer",
      "token_creator": "string",
      "token_feeder": "string",
      "source_verified": "boolean",
      "is_proxy": "boolean",
      "behavioral_is_honeypot": "boolean",
      "honeypot_analysis": {
          "verdict": "string",
          "score": "integer",
          "findings": [
              {
                  "rule": "string",
                  "severity": "string",
                  "function": "string or null" ,
                  "detail": "string"
              }
          ],
          "flags": [
              "string"
          ]
      },
      "aggregate": {
          "verdict": "string",
          "risk_score": "integer",
          "primary_signal": "string",
          "simulate": "boolean",
          "version": "string",
          "duration_ms": "integer",
          "last_run": "ISO-8601"
      },
      "quick_stats": [
          {
              "label": "string",
              "value": "string",
              "tone": "string"
          },
          {
              "label": "string",
              "value": "string",
              "tone": "string"
          },
          {
              "label": "string",
              "value": "string",
              "tone": "string"
          }
      ],
      "modules": {
          "ownership": {
              "status": "string",
              "risk_score": "integer",
              "owner_address": "string",
              "owner_is_eoa": "boolean",
              "owner_is_renounced": "boolean",
              "blast_radius": "critical",
              "can_mint": "boolean",
              "can_pause": "boolean",
              "can_blacklist": "boolean",
              "can_upgrade": "boolean",
              "can_drain": "boolean",
              "has_timelock": "boolean",
              "has_shadow": "boolean"
          },
          "liquidity": {
              "status": "string",
              "summary": "string",
              "risk_score": "integer",
              "pool_count": "integer",
              "unknown_pool": "boolean",
              "invariants": [
                  {
                      "code": "string",
                      "label": "string",
                      "status": "string",
                      "severity": "string",
                      "detail": "string"
                  }
              ]
          },
          "supply": {
              "status": "pass",
              "risk_score": "integer",
              "has_mint": "boolean",
              "deployer_pct": "decimal",
              "hidden_mint": "boolean"
          },
          "transfer": {
              "status": "pass",
              "risk_score": "integer",
              "method": "string",
              "monitoring": "boolean",
              "inv_t1_pass": "boolean",
              "inv_t2_pass": "boolean",
              "inv_t3_pass": "boolean",
              "inv_t4_pass": "boolean",
              "inv_t5_pass": "boolean",
              "inv_t6_pass": "boolean",
              "inv_t7_pass": "boolean"
          },
          "pausability": {
              "status": "string",
              "applicable": "boolean"
          },
          "approve": {
              "status": "string",
              "risk_score": "integer",
              "method": "string",
              "coverage": "string",
              "inv1_pass": "boolean",
              "inv2_pass": "boolean",
              "inv3_pass": "boolean",
              "inv5_pass": "boolean",
              "inv6_pass": "boolean"
          },
          "permit": {
              "status": "string",
              "applicable": "boolean"
          },
          "reentrancy": {
              "status": "string",
              "risk_score": "integer"
          }
        }
    }

⚠️ Notas: • Se audit_status não for "complete", a maioria dos campos de módulos/agregados pode ser null, vazia ou desatualizada — não os apresente como resultados finais. • Uma risk_score alta ou campos de tom/severidade "high"/"critical" indicam perigo elevado; destaque-os de forma proeminente em vez de escondê-los sob módulos aprovados.

Casos de erro:

• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

11. Ferramenta de Lista de Pontuação de Confiança de Agentes

ID: agents_trust_score_list

Descrição: A Pontuação de Confiança de Agentes ChainAware é uma pontuação de 0 a 1000 que mede o quão seguro é interagir com qualquer agente de IA registrado no ERC-8004. Diferente de sistemas de reputação baseados em votação — onde agentes podem votar uns nos outros para fabricar confiança — a Pontuação de Confiança de Agentes é derivada inteiramente do histórico comportamental on-chain. Ela não pode ser conquistada em horas. Não pode ser falsificada com um conjunto de carteiras novas. Ela reflete o histórico real no mundo real do humano ou entidade que controla o agente. À medida que o comércio agêntico escala — com agentes de IA concluindo compras autonomamente em nome de consumidores em ChatGPT, Google Gemini e Shopify — a questão de quais agentes podem ser confiáveis para transacionar não é mais teórica. A ChainAware responde com evidências on-chain, não com endossos de pares. Ela retorna uma lista de Agentes e seus resultados.

➡️ Exemplos de casos de uso: – "Dê-me uma lista de Agentes e suas pontuações de confiança?" – "Qual é o melhor Agente registrado após 2025-01-01?"

Entradas:

Nome	Tipo	Obrigatório	Descrição
`page`	string	✅	Número da página (page) durante a paginação
`limit`	string	✅	Quantidade de itens a buscar durante a paginação
`sort_by`	string	X	Ordenar os agentes retornados com base em, ex.: 'registered_at'
`sort_order`	string	X	Mas obrigatório se sort_by 'asc' ou 'desc' ordenando o valor de sort_by (padrão desc)
`registered_after`	string	X	Filtrar com base na data/hora em que o Agente foi registrado

Saídas (JSON):

{
    "total": "integer",
    "page": 1,
    "limit": 2,
    "results": [
      {
          "chain_id": "integer",
          "agent_id": "integer",
          "owner_address": "string",
          "agent_wallet": "string",
          "agent_uri": "string",
          "meta_name": "string",
          "registered_at": "ISO-8601",
          "reputation_score": "integer",
          "trust_score": "integer",
          "trust_tier": "string"
      },
      {
          "chain_id": "integer",
          "agent_id": "integer",
          "owner_address": "string",
          "agent_wallet": "string",
          "agent_uri": "string",
          "meta_name": "string",
          "registered_at": "ISO-8601",
          "reputation_score": "integer",
          "trust_score": "integer",
          "trust_tier": "string"
      }
      ]
    }

Casos de erro:

• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

12. Ferramenta de Pontuação de Confiança de Agente Individual

ID: agents_trust_score_single

Descrição: Semelhante à Lista de Confiança de Agentes, a Pontuação de Confiança de Agente Individual é uma pontuação de 0 a 1000 que mede o quão seguro é interagir com qualquer agente de IA registrado no ERC-8004. Diferente de sistemas de reputação baseados em votação — onde agentes podem votar uns nos outros para fabricar confiança — a Pontuação de Confiança de Agente é derivada inteiramente do histórico comportamental on-chain. Ela não pode ser conquistada em horas. Não pode ser falsificada com um conjunto de carteiras novas. Ela reflete o histórico real da pessoa ou entidade que controla o agente. À medida que o comércio agêntico escala — com agentes de IA concluindo compras autonomamente em nome de consumidores em ChatGPT, Google Gemini e Shopify — a questão de quais agentes podem ser confiáveis para transacionar não é mais teórica. A ChainAware responde com evidências on-chain, não com endossos de pares. Retorna os detalhes individuais em profundidade para um agente solicitado.

➡️ Exemplos de Casos de Uso: – "Qual é a pontuação de confiança para o agente id 12314 na chain_id 56?"

Entradas:

Nome	Tipo	Obrigatório	Descrição
`agent_id`	integer	✅	ID do agente retornado pela ferramenta agents_trust_score_list
`chain_id`	integer	✅	ID da chain onde o agente está implantado/registrado, previamente obtido da ferramenta agents_trust_score_list

Saídas (JSON):

{
    "agent_id": "integer",
    "chain": "string",
    "chain_id": "integer",
    "owner_address": "string",
    "agent_wallet": "string",
    "wallet_verified": "boolean",
    "agent_uri": "string",
    "registered_at": "ISO-8601",
    "fetched_at": "ISO-8601",
    "error": "string",
    "meta_name": "string",
    "meta_description": "string",
    "meta_image": "string",
    "metadata_json": {
        "type": "string",
        "name": "string",
        "description": "string",
        "image": "string",
        "active": "boolean",
        "supportedTrust": "array[string]"
    },
    "registration": {
        "agent_name": "string",
        "agent_desc": "string",
        "fetch_status": "string",
        "fetched_at": "ISO-8601",
        "raw_json": {
            "type": "string",
            "name": "string",
            "description": "string",
            "image": "string",
            "active": "boolean",
            "supportedTrust": "array[string]"
        }
    },
    "wallets": [
        {
            "wallet_chain_id": "integer",
            "wallet_address": "string",
            "source": "registry",
            "fetched_at": "ISO-8601"
        }
    ],
    "reputation_score": "string",
    "trust_score": "integer",
    "trust_tier": "string",
    "trust_flags": "array[string]"
}

Casos de erro:

• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

13. Verificar Status de Trabalho em Lote

ID: check_job_status

Descrição: Verifica o progresso de um trabalho de cálculo em lote agendado. Retorna apenas contagens (concluídos, falhos, pendentes) — sem dados de carteira. Chame esta função quando o usuário perguntar se um trabalho foi concluído ou como está progredindo. Se o status for 'processing' ou 'pending', informe o usuário e não chame get_job_results. Sugira buscar resultados apenas quando o status for 'completed' ou 'partial'. Tanto o job_id quanto a assinatura de schedule_calculation são obrigatórios para chamar esta ferramenta. Nunca chame esta função sem que ambos os valores estejam presentes no contexto.

➡️ Exemplos de Casos de Uso:

• Qual é o status do trabalho id 0fc5897a-ad64-4f21-88b5-1274d1cfec46 usando esta assinatura 260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a?

Entradas:

Nome	Tipo	Obrigatório	Descrição
`job_id`	string	✅	O ID do trabalho retornado pelo cálculo agendado (predictive_fraud_batch ou predictive_behaviour_batch)
`signature`	string	✅	A assinatura retornada pelo cálculo agendado (predictive_fraud_batch ou predictive_behaviour_batch). Obrigatória para acesso

Saídas (JSON):

{
    "job_id": "0fc5897a-ad64-4f21-88b5-1274d1cfec46",
    "status": "partial",
    "chain": "ETH",
    "total_items": 5,
    "completed_items": 1,
    "failed_items": 4,
    "pending_items": 0,
    "expires_at": "2026-07-01T13:51:20.000Z"
}

Casos de erro:

• `403 Unauthorized` → `apiKey` inválido (não aplicável ao usar pagamentos x402)
• `403 Unauthorized` → `signature` inválido
• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

14. Obter Resultados de Trabalho em Lote

ID: get_job_results

Descrição: Recupera os resultados de um trabalho em lote concluído ou parcialmente concluído. Chame esta função apenas quando check_job_status mostrar status 'completed' ou 'partial'. Retorna uma lista de endereços de carteira concluídos e a chain/rede compartilhada — use-os para consultar o backend principal para obter dados reais de análise de carteira. Isso NÃO retorna dados de carteira diretamente, apenas a lista de endereços necessária para buscá-los. Tanto o job_id quanto a assinatura de schedule_calculation são obrigatórios para chamar esta ferramenta. Nunca chame esta função sem que ambos os valores estejam presentes no contexto.

➡️ Exemplos de Casos de Uso:

• Qual é o resultado do trabalho id 0fc5897a-ad64-4f21-88b5-1274d1cfec46 usando esta assinatura 260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a?

Entradas:

Nome	Tipo	Obrigatório	Descrição
`job_id`	string	✅	O ID do trabalho retornado pelo cálculo agendado (predictive_fraud_batch ou predictive_behaviour_batch)
`signature`	string	✅	A assinatura retornada pelo cálculo agendado (predictive_fraud_batch ou predictive_behaviour_batch). Obrigatória para acesso

Saídas (JSON):

{    
  "message": "string",                               // e.g. “Success” or error description
  "data":[{
      "walletAddress": "string",                     // blockchain wallet address analyzed
      "status": "string",                            // fraud classification result (e.g. “Fraud” | “Not Fraud” | “New Address”)

      "probabilityFraud": "0.00–1.00",               // decimal probability score indicating fraud risk
      "token": "string | null",                      // optional token context for the analysis
      "chain": "string",                             // blockchain network identifier (e.g. ETH, BNB,BASE,HAQQ,SOLANA)

      "lastChecked": "ISO-8601 timestamp",           // last time the wallet was analyzed

      "forensic_details": {
          "cybercrime": "string",                      // indicator of cybercrime association
          "money_laundering": "string",                // money laundering activity indicator
          "number_of_malicious_contracts_created": "string", // malicious contracts deployed by wallet
          "gas_abuse": "string",                       // abnormal gas usage indicator
          "financial_crime": "string",                 // financial crime activity indicator
          "darkweb_transactions": "string",            // interaction with darkweb-linked wallets
          "reinit": "string",                          // contract reinitialization exploit indicator
          "phishing_activities": "string",             // phishing activity indicator
          "fake_kyc": "string",                        // fake KYC interaction indicator
          "blacklist_doubt": "string",                 // suspected blacklist association
          "fake_standard_interface": "string",         // fake token interface indicator
          "data_source": "string",                     // source of forensic intelligence
          "stealing_attack": "string",                 // stealing attack indicator
          "blackmail_activities": "string",            // blackmail activity indicator
          "sanctioned": "string",                      // sanction exposure indicator
          "malicious_mining_activities": "string",     // malicious mining activity indicator
          "mixer": "string",                           // interaction with mixing services
          "fake_token": "string",                      // fake token creation/use indicator
          "honeypot_related_address": "string"         // honeypot contract interaction indicator
      },

      "categories": [
          {
          "Category": "string",                      // wallet interaction category (e.g. DeFi, NFT, Bridge)
          "Count": 0                                 // number of transactions/interactions in this category
          }
      ],

      "riskProfile": [
          {
          "Category": "Risk_Profile",                 // willingnes to take risk object
          "Balance_age": 0.0                         // 1-10 willingnes to take risk value
          }
      ],

      "segmentInfo": "string (JSON encoded)",        // serialized JSON containing protocol engagement flags (e.g "{\"Maker\":0,\"Aave_borrow\":0,\"Aave_lend\":1,\"Lido\":0,\"Uniswap\":1,\"Compound_lend\":0,\"Compound_borrow\":0}")

      "experience": {
          "Type": "string",                            // descriptor label (e.g. “Experience”)
          "Value": 0                                   // numeric experience score level
      },

      "intention": {
          "Type": "string",                            // descriptor label (e.g. “Intentions”)
          "Value": {
          "Prob_Lend": "Low | Medium | High",
          "Prob_Trade": "Low | Medium | High",
          "Prob_Game": "Low | Medium | High",
          "Prob_NFT": "Low | Medium | High",
          "Prob_Stake_ETH": "Low | Medium | High",
          "Prob_Borrow": "Low | Medium | High",
          "Prob_Gamble": "Low | Medium | High",
          "Prob_Stake": "Low | Medium | High",
          "Prob_Yield_Farm": "Low | Medium | High",
          "Prob_Leveraged_Stake": "Low | Medium | High",
          "Prob_Leveraged_Stake_ETH": "Low | Medium | High",
          "Prob_Leveraged_Lend": "Low | Medium | High",
          "Prob_Leverage_Long_ETH": "Low | Medium | High",
          "Prob_Leverage_Long": "Low | Medium | High"
          }
      },

      "protocols": [
          {
          "Protocol": "string",                      // protocol name (e.g. Uniswap, Curve, MakerDAO)
          "Count": 0                                 // number of interactions with this protocol
          }
      ],

      "userDetails": {
          "wallet_age_days": 0,                        // age of wallet in days
          "total_balance_usd": 0.0,                    // current wallet balance in USD
          "transaction_count": 0,                      // total number of transactions executed
          "wallet_rank": 0                             // ranking of wallet in the scoring system
      },

      "riskCapability": 0,                           // numeric risk capability score

      "recommendation": {
          "Type": "string",                            // descriptor label (e.g. “Recommendation”)
          "Value": [
          "string"                                   // recommended strategies or actions
          ]
      },

      "checked_times": 0,                            // number of times the wallet analysis was executed
      "createdAt": "ISO-8601 timestamp",             // record creation timestamp
      "updatedAt": "ISO-8601 timestamp",             // record last update timestamp

      "sanctionData": [
          {
          "category": "string | null",               // sanction category
          "name": "string | null",                   // sanction list name
          "description": "string | null",            // sanction description
          "url": "string | null",                    // reference source URL
          "isSanctioned": false,                     // whether the wallet is officially sanctioned
          "createdAt": "ISO-8601 timestamp",
          "updatedAt": "ISO-8601 timestamp"
          }
      ]
  }]
}

Casos de erro:

• `403 Unauthorized` → `apiKey` inválido (não aplicável ao usar pagamentos x402)
• `403 Unauthorized` → `signature` inválido
• `400 Bad Request` → `network` ou `walletAddress` malformados  
• `500 Internal Server Error` → falha temporária downstream

🧠 Exemplo de Uso pelo Cliente

Exemplo em Node.js

import { MCPClient } from "mcp-client";

const client = new MCPClient("https://prediction.mcp.chainaware.ai/");

const result = await client.call("predictive_rug_pull", {
  apiKey: "your_api_key",
  network: "BNB",
  walletAddress: "0x1234..."
});

console.log(result);

Exemplo em Python

from mcp_client import MCPClient

client = MCPClient("https://prediction.mcp.chainaware.ai/")

res = client.call("chat", {"query": "What is the rug pull risk of 0x1234?"})
print(res)

Configuração do Serviço:

  "type": "sse",
  "config": {
    "mcpServers": {
      "chainaware-behavioural_prediction_mcp": {
        "type": "sse",
        "url": "https://prediction.mcp.chainaware.ai/sse",
        "description": "The Behavioural Prediction MCP Server provides AI-powered tools to analyze wallet behaviour prediction,fraud detection and rug pull prediction.",
        "headers":{
          "x-api-key":""
        },
        "params":{
          "walletAddress":"",
          "network":""
        },
        "auth": {
          "type": "api_key",
          "header": "X-API-Key"
        }
      }
    }
  }
}

🔌 Notas de Integração

✅ Compatível com clientes MCP em ambientes Node.js, Python e baseados em navegador
🔁 Usa Server-Sent Events (SSE) para streaming / respostas em tempo real
📐 Esquemas JSON em conformidade com a especificação MCP
🚦 Limites de taxa podem ser aplicados dependendo do nível de uso
🔑 Chave de API necessária para endpoints de produção
💳 Pagamento x402 suportado — pague por chamada via protocolo x402 sem chave de API de assinatura; clientes x402 compatíveis lidam com o pagamento automaticamente em respostas HTTP 402

Configuração do Claude Code (CLI)

Use o CLI do Claude para registrar o servidor MCP via transporte SSE:

claude mcp add --transport sse chainaware-behavioural-prediction-mcp-server https://prediction.mcp.chainaware.ai/sse \
  --header "X-API-Key: your-key-here"

📚 Documentação: https://code.claude.com/docs/en/mcp

Configuração do Conector ChatGPT

Disponível em ambientes ChatGPT que suportam Connectors / MCP (Modo Desenvolvedor).

Etapas

Abra Configurações do ChatGPT
Navegue até Apps / Connectors
Clique em Adicionar Conector
Insira o nome da integração e a URL abaixo
Salve a configuração

Detalhes da Integração

Nome

ChainAware Behavioural Prediction MCP Server

URL de Integração

https://prediction.mcp.chainaware.ai/sse?apiKey=your-key-here

Configuração do Claude Web e Claude Desktop

Etapas

Abra o Claude Web ou Claude Desktop
Vá para Configurações → Integrações
Clique em Adicionar integração
Insira o nome e a URL abaixo
Clique em Adicionar para concluir a configuração

Detalhes da Integração

Nome

ChainAware Behavioural Prediction MCP Server

URL de Integração

https://prediction.mcp.chainaware.ai/sse?apiKey=your-key-here

📚 Documentação: https://platform.claude.com/docs/en/agents-and-tools/remote-mcp-servers

Configuração do Cursor

Adicione o servidor MCP ao seu arquivo de configuração do Cursor (ex.: mcp.json):

{
  "mcpServers": {
    "chainaware-behavioural-prediction-mcp-server": {
      "url": "https://prediction.mcpbeta.chainaware.ai/sse",
      "transport": "sse",
      "headers": {
        "X-API-Key": "your-key-here"
      }
    }
  }
}

📚 Documentação: https://cursor.com/docs/context/mcp

🤖 Subagentes do Claude Code

Este repositório inclui 34 subagentes do Claude Code prontos para uso em .claude/agents/ — agentes especializados que lidam com tarefas comuns de inteligência Web3 prontas para uso.

Agent	Finalidade
`chainaware-wallet-auditor`	Due diligence completa — perfil comportamental profundo, incluindo sinais de fraude
`chainaware-fraud-detector`	Triagem rápida de fraude em carteiras
`chainaware-rug-pull-detector`	Verificações de segurança de contratos inteligentes / LP
`chainaware-trust-scorer`	Pontuação de confiança (0,00–1,00)
`chainaware-credit-scorer`	Pontuação de crédito cripto (1–9) para decisões de empréstimo e capacidade de crédito
`chainaware-ltv-estimator`	Potencial de receita em 12 meses (LTV) como faixa em USD com base em sinais comportamentais
`chainaware-reputation-scorer`	Pontuação de reputação (0–1000)
`chainaware-aml-scorer`	Pontuação de conformidade AML (0–100)
`chainaware-wallet-ranker`	Ranking de experiência da carteira + leaderboard
`chainaware-wallet-marketer`	Mensagens de marketing personalizadas
`chainaware-token-ranker`	Descobrir/classificar tokens pela força da comunidade de detentores
`chainaware-token-analyzer`	Análise aprofundada de um único token + principais detentores
`chainaware-onboarding-router`	Direcionar carteiras para onboarding iniciante/intermediário/pular
`chainaware-whale-detector`	Classificar carteiras em níveis de baleia (Mega/Baleia/Emergente)
`chainaware-defi-advisor`	Recomendações personalizadas de produtos DeFi por experiência + nível de risco
`chainaware-airdrop-screener`	Triagem em lote de carteiras para elegibilidade a airdrops, filtrar bots/fraudes
`chainaware-lending-risk-assessor`	Nota de risco do tomador (A–F), índice de garantia, nível de taxa de juros
`chainaware-token-launch-auditor`	Auditoria de segurança pré-listagem — APROVADO/CONDICIONAL/REJEITADO
`chainaware-agent-screener`	Pontuação de confiança de agente de IA 0–10 via verificações do agente + carteiras alimentadoras
`chainaware-cohort-analyzer`	Segmentar um lote de carteiras em coortes comportamentais com estratégias de engajamento por coorte
`chainaware-counterparty-screener`	Veredito em tempo real pré-transação (Seguro / Cautela / Bloquear) antes de uma negociação, transferência ou interação com contrato
`chainaware-governance-screener`	Triagem de votantes DAO — detecção Sybil, nível de governança e multiplicador de peso de voto (suporta modelos ponderados por token, por reputação e quadráticos)
`chainaware-sybil-detector`	Detecção em massa de ataques Sybil para votos DAO — classifica votantes como ELEGÍVEL / REVISAR / EXCLUIR, detecta padrões coordenados de fraude (fazendas de carteiras, surtos de novas carteiras) e gera multiplicadores de voto ponderados por reputação
`chainaware-transaction-monitor`	Pontuação de risco de transação em tempo real para agentes autônomos — pontuação composta (0–100) e ação do pipeline (PERMITIR / SINALIZAR / SEGURAR / BLOQUEAR)
`chainaware-lead-scorer`	Qualificação de leads de vendas — pontuação do lead (0–100), nível (Quente/Morno/Frio/Morto), probabilidade de conversão e abordagem recomendada
`chainaware-upsell-advisor`	Caminho de upsell para usuários existentes — pontuação de prontidão para upgrade, recomendação do próximo produto, evento gatilho e mensagem de upsell pronta para uso
`chainaware-platform-greeter`	Mensagem de boas-vindas contextual para uma carteira específica em uma plataforma específica — a mesma carteira recebe mensagens diferentes na Aave vs 1inch vs OpenSea
`chainaware-marketing-director`	Orquestrador de campanha de ciclo completo — segmenta o público, pontua leads, detecta baleias, cria playbook de mensagens por coorte, revela oportunidades de upsell e direciona novas carteiras
`chainaware-compliance-screener`	Triagem de conformidade de primeira camada alinhada à MiCA — orquestra detector de fraude, pontuador AML, monitor de transações e triador de contrapartes em um Relatório de Conformidade com veredito (APROVADO / EDD / REJEITADO)
`chainaware-gamefi-screener`	Triagem de carteiras para jogos Web3 e P2E — detecta fazendas de bots, trapaceiros e carteiras de farm; classifica jogadores legítimos em níveis de experiência para matchmaking; gera elegibilidade de recompensas P2E
`chainaware-portfolio-risk-advisor`	Avaliação de rug pull e saúde da comunidade em nível de portfólio — examina cada token, gera Pontuação de Risco de Portfólio ponderada, nota (A–F), sinalizadores de concentração e plano de rebalanceamento priorizado
`chainaware-rwa-investor-screener`	Triagem de adequação de investidor RWA — avalia risco de fraude, experiência e alinhamento do perfil de risco com o nível RWA; retorna QUALIFICADO / CONDICIONAL / ENCAMINHAR_PARA_KYC / DESQUALIFICADO com limite de investimento
`chainaware-agent-trust-screener`	Triagem de confiança de agentes de IA ERC-8004 — lista e classifica agentes registrados por pontuação de confiança 0–1000, retorna nível de confiança e sinalizadores, alerta fortemente sobre carteiras não verificadas
`chainaware-token-audit-analyst`	Auditoria profunda de contrato de token multi-módulo — propriedade, liquidez, oferta/cunhagem, detecção de honeypot, reentrância; pipeline assíncrono com pontuação de risco 0–100 e detalhamento por módulo

Configuração

Etapa 1 — Conecte o servidor MCP

Os agentes chamam as ferramentas ChainAware via MCP. Registre o servidor primeiro:

claude mcp add --transport sse chainaware-behavioral-prediction \
  https://prediction.mcp.chainaware.ai/sse \
  --header "X-API-Key: YOUR_KEY"

Para Cursor / Windsurf, adicione ao mcp.json:

{
  "mcpServers": {
    "chainaware-behavioral-prediction": {
      "url": "https://prediction.mcp.chainaware.ai/sse",
      "transport": "sse",
      "headers": { "X-API-Key": "YOUR_KEY" }
    }
  }
}

Etapa 2 — Copie os arquivos dos agentes

Clone este repositório e copie os agentes para o seu projeto:

git clone https://github.com/ChainAware/behavioral-prediction-mcp.git
cp -r behavioral-prediction-mcp/.claude/agents/ your-project/.claude/agents/

Ou selecione apenas os agentes que você precisa:

mkdir -p your-project/.claude/agents
cp behavioral-prediction-mcp/.claude/agents/chainaware-fraud-detector.md \
   your-project/.claude/agents/

Etapa 3 — Defina a chave de API

export CHAINAWARE_API_KEY="your-key-here"

Obtenha uma chave em https://chainaware.ai/pricing

Notas Importantes

A linha tools: no frontmatter de cada agente referencia o servidor MCP pelo seu nome registrado. Se você registrar o servidor com um nome diferente, atualize as linhas tools: para corresponder.
Os agentes especificam um model: no frontmatter (claude-haiku-4-5-20251001 ou claude-sonnet-4-6). Você precisa ter acesso a esses modelos.
A pasta references/ contém documentação detalhada das ferramentas que dá aos agentes um contexto mais rico. Copiá-la junto com os agentes é recomendado, mas opcional.

🔐 Notas de Segurança

Não coloque chaves de API hard-coded em repositórios públicos
Prefira variáveis de ambiente ou gerenciadores de segredos quando suportados
Rotacione as chaves regularmente em ambientes de produção

🔒 Política de Acesso

O servidor MCP suporta dois métodos de acesso:

Chave de API — assine um plano em https://chainaware.ai/pricing e envie a chave via cabeçalho X-API-Key
Pagamentos x402 — use qualquer cliente MCP compatível com x402 para acesso pay-per-call sem necessidade de assinatura; o servidor retorna HTTP 402 com detalhes de pagamento e o cliente liquida automaticamente

📖 Leitura Adicional

Imprensa e Reconhecimento

Mapa de Mercado de Prevenção de Fraude da CB Insights para a Era da IA — ChainAware destacada como solução líder de prevenção de fraude da era da IA para Web3 (2026)
Panorama de IA da BNB Chain — ChainAware listada pela BNB Chain como um projeto-chave de IA no ecossistema (2025)
BNB Chain Kickstart — Ferramentas de Marketing — Growth Agents e Wallet Marketer em destaque no programa Kickstart da BNB Chain (2025)
Subvenção de $250 mil do Google Cloud — ChainAware selecionada para uma subvenção de US$ 250.000 do Google Cloud (2025)
AWS Fintech Accelerator — ChainAware aceita no programa AWS Fintech Accelerator (2024)
Panorama de Crescimento Web3 do Safary Club — Ferramentas de Crescimento — ChainAware em destaque em Ferramentas de Crescimento para Projetos Web3 (2024)

Visões Gerais do Produto

Guia Completo do Produto ChainAware — Visão geral de todas as ferramentas, redes e cobertura
Potencial de Negócio Web3 — Caso de negócio e oportunidade de mercado para inteligência Web3
Use a ChainAware como Negócio — Como construir produtos e serviços comerciais sobre a ChainAware

Guias Específicos de Ferramentas

Guia do Fraud Detector — Como usar o predictive_fraud: entradas, saídas, limites, casos de uso
Guia do Rug Pull Detector — Como usar o predictive_rug_pull: pontuação de contratos, risco do deployer, análise de LP
Guia do Token Rank — Como usar o token_rank_list e o token_rank_single: pontuação de força da comunidade
Guia do Wallet Rank — Sistema de classificação de carteiras: níveis de experiência, classificação global, pontos
Guia do Wallet Auditor — Fluxo de trabalho completo de auditoria de carteiras combinando múltiplas ferramentas
Guia de Monitoramento de Transações — Padrões de monitoramento de risco de transações em tempo real
Guia de Análise Comportamental de Usuários Web3 — Usando o predictive_behaviour para análise e segmentação de usuários
Guia de Credit Score — Metodologia de pontuação de crédito Web3 e uso em empréstimos DeFi
Guia do Agente de Pontuação de Crédito — Como construir e usar o agente de pontuação de crédito da ChainAware
Pontuação de Confiança de Agentes para Comércio Agentico — Triagem de agentes ERC-8004 em mais de 274 mil agentes registrados: níveis de confiança, detecção de fraude em nível de frota e controle de acesso DeFi usando agents_trust_score_list / agents_trust_score_single
Auditoria de Tokens: 10.000 Resultados de Tokens CoinGecko — Estudo do mundo real: 55% dos principais tokens recebem veredito de ALTO RISCO; 127 verificações de segurança automatizadas via run_token_audit

Análise e Estratégia

Segmentação de Usuários Web3 e Análise Comportamental para Crescimento de DApps — Estratégias de segmentação para retenção e crescimento de DApps
Análise de Blockchain com IA: Machine Learning para Segurança Cripto — Abordagens de ML para segurança on-chain e detecção de fraude
Análise Cripto Forense vs Análise Cripto Baseada em IA — Comparação entre ferramentas forenses tradicionais e a abordagem preditiva de IA da ChainAware
Screener de Conformidade MiCA para DeFi — Como a ChainAware cobre ~70–75% das obrigações MiCA em DeFi; posiciona o compliance-screener vs Chainalysis/Elliptic
Plataformas de Crescimento Web3 Comparadas 2026 — Estrutura de funil em três etapas; a ChainAware opera na Etapa 3 (pós-conexão, personalização dentro do DApp)
Ferramentas de Análise Web3 para DApps Comparação 2026 — Mapeia 10 plataformas de análise em quatro categorias de trabalho; a ChainAware é a única plataforma de inteligência preditiva
Por que a Personalização é a Próxima Grande Coisa para Agentes de IA — O caso da personalização em nível de carteira no Web3

Integração para Desenvolvedores

12 Capacidades de Blockchain que Qualquer Agente de IA Pode Usar — Guia de Integração MCP — Todas as capacidades explicadas, com instruções de configuração para Claude, ChatGPT, Cursor e sistemas multi-agente
Prediction MCP para Agentes de IA: Personalize Decisões a partir do Comportamento da Carteira — Guia de integração aprofundado com exemplos de código
5 Principais Formas de o Prediction MCP Turbinar Sua Plataforma DeFi — Casos de uso em empréstimos, DEX, launchpad, governança e personalização
Onboarding DeFi em 2026: Por que 90% das Carteiras Conectadas Nunca Transacionam e Como os Agentes de IA Resolvem Isso — Problema de conversão no onboarding e soluções orientadas por IA
A Economia Agentica Web3: Como os Agentes de IA Estão Substituindo Equipes Humanas em DeFi — Como agentes de IA autônomos estão assumindo operações e tomada de decisões em DeFi

🧾 Licença

MIT (para exemplos de clientes). A implementação do servidor e a lógica de backend são proprietárias e permanecem privadas.

Recursos e terceiros

🏆 Reconhecimento

A ChainAware está em destaque no Mapa de Mercado de Prevenção de Fraude da CB Insights para a Era da IA como uma solução líder de prevenção de fraude com IA para a era da IA (2026).

A ChainAware está listada no Panorama de IA da BNB Chain — reconhecida pela BNB Chain como um projeto-chave de IA no ecossistema (2025).

A ChainAware está listada no BNB Chain Kickstart — Ferramentas de Marketing — Growth Agents e Wallet Marketer em destaque no programa oficial Kickstart da BNB Chain (2025).

A ChainAware recebeu uma Subvenção de $250 mil do Google Cloud — selecionada pelo Google Cloud para desenvolvimento de infraestrutura e IA (2025).

A ChainAware foi aceita no AWS Fintech Accelerator — selecionada pela AWS para seu programa Fintech Accelerator (2024).

A ChainAware está em destaque no Panorama de Crescimento Web3 do Safary Club — Ferramentas de Crescimento — listada na categoria Ferramentas de Crescimento para Projetos Web3 (2024).