Behavioural Prediction MCP

El servidor MCP de Behavioural Prediction proporciona herramientas impulsadas por IA para analizar la predicción del comportamiento de billeteras, detección de fraudes y predicción de rug pulls.

GitHub

Prueba este MCPPatrocinado

Documentación

🧠 Servidor MCP de Predicción de Comportamiento ChainAware

Nombre del Servidor MCP: ChainAware Behavioural Prediction MCP

Categoría: Web3 / Seguridad / Analítica DeFi

Estado: Herramientas públicas – Backend privado

Acceso: Bajo solicitud (clave API · pago x402 compatible)

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

Repositorio: [https://github.com/ChainAware/behavioral-prediction-mcp]

Sitio web: [https://chainaware.ai/]

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

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

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

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

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

Destacado en: Mapa de Mercado de Prevención de Fraude de CB Insights para la Era de la IA — ChainAware reconocida como una solución líder de prevención de fraude para Web3 en la era de la IA (2026).

Listado en: Panorama de IA de BNB Chain — ChainAware listada por BNB Chain como un proyecto clave de IA en el ecosistema (2025).

Listado en: BNB Chain Kickstart — Herramientas de Marketing — Los Agentes de Crecimiento y Wallet Marketer de ChainAware destacados en la sección de Herramientas de Marketing del programa BNB Chain Kickstart (2025).

Premiado: Beca de $250k de Google Cloud — ChainAware seleccionada para una beca de $250,000 de Google Cloud (2025).

Seleccionado para: Aceleradora Fintech de AWS — ChainAware aceptada en el programa Aceleradora Fintech de AWS (2024).

Listado en: Panorama de Crecimiento Web3 de Safary Club — Herramientas de Crecimiento — ChainAware destacada en la categoría de Herramientas de Crecimiento para Proyectos Web3 (2024).

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

📖 Descripción

El Servidor MCP de Predicción de Comportamiento proporciona herramientas impulsadas por IA para analizar la predicción del comportamiento de carteras, la detección de fraude y la predicción de rug pulls.

Los desarrolladores y plataformas pueden integrar estas herramientas a través del protocolo MCP para proteger a los usuarios de DeFi, monitorear riesgos de liquidez y calificar la confiabilidad de carteras o contratos.

Todas las herramientas siguen el Protocolo de Contexto de Modelo (MCP) y pueden consumirse mediante clientes compatibles con MCP.

Verificación con backtesting: 98% de precisión en detección predictiva de fraude · 90.1% de precisión en detección de rug pulls

🏆 ChainAware está destacada en el Mapa de Mercado de Prevención de Fraude de CB Insights para la Era de la IA — reconocida como una solución líder de prevención de fraude impulsada por IA para Web3 (2026). 🌐 ChainAware está listada en el Panorama de IA de BNB Chain — reconocida como un proyecto clave de IA en el ecosistema de BNB Chain (2025). 🚀 ChainAware está listada en BNB Chain Kickstart — Herramientas de Marketing — Agentes de Crecimiento y Wallet Marketer destacados en el programa oficial de BNB Chain para el crecimiento del ecosistema (2025). 💰 ChainAware recibió una Beca de $250k de Google Cloud — seleccionada por Google Cloud para desarrollo de infraestructura e IA (2025). ☁️ ChainAware fue aceptada en la Aceleradora Fintech de AWS — seleccionada por AWS para su programa Aceleradora Fintech (2024). 🌱 ChainAware está destacada en el Panorama de Crecimiento Web3 de Safary Club — Herramientas de Crecimiento — listada en la categoría de Herramientas de Crecimiento para Proyectos Web3 (2024).

⚙️ Herramientas Disponibles

1. Herramienta de Detección Predictiva de Fraude

ID: predictive_fraud

Descripción: Este algoritmo impulsado por IA pronostica la probabilidad de actividad fraudulenta en una dirección de cartera determinada antes de que ocurra (≈98% de precisión en backtesting), y realiza verificaciones AML/anti-lavado de dinero. Úsalo cuando tu usuario quiera una evaluación de riesgo o una alerta temprana sobre una dirección de blockchain.

➡️ Ejemplos de casos de uso:

• ¿Es seguro interactuar con vitalik.eth?
• ¿Cuál es el estado fraudulento de esta dirección?
• ¿Mi nueva cartera está en riesgo de ser utilizada para fraude?

Entradas:

Nombre	Tipo	Requerido	Descripción
`apiKey`	string	✅*	Clave API de ChainAware — u omitir al usar pagos x402
`network`	string	✅	Red blockchain (`ETH`, `BNB`,`POLYGON`,`TON`,`BASE`, `TRON`, `HAQQ`)
`walletAddress`	string	✅	La dirección de cartera a evaluar

Salidas (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 error:

    • `402 Payment Required` → pago x402 requerido — los clientes compatibles lo liquidan automáticamente
• `400 Bad Request` → `network` o `walletAddress` malformados
• `500 Internal Server Error` → fallo temporal aguas abajo

2. Herramienta de Detección Predictiva de Fraude por Lotes

ID: predictive_fraud_batch

Descripción: Este algoritmo impulsado por IA pronostica la probabilidad de actividad fraudulenta en una dirección de cartera determinada antes de que ocurra (≈98% de precisión), y realiza verificaciones AML/anti-lavado de dinero por lotes. Programa un trabajo de cálculo de fraude por lotes para una lista de direcciones de cartera. Úsalo cuando el usuario proporcione un CSV o una lista de direcciones para analizar. Devuelve un job_id y una firma inmediatamente — informa el job_id al usuario y guarda tanto el job_id como la firma en el contexto; son necesarios para todas las llamadas de seguimiento. NO hagas polling ni esperes resultados después de programar.

➡️ Ejemplos de casos de uso:

• ¿Ejecutar lote de fraude para esta lista de direcciones en la red ETH?
• ¿Cuál es el estado fraudulento de estas direcciones en BNB?

Entradas:

Nombre	Tipo	Requerido	Descripción
`apiKey`	string	✅*	Clave API de ChainAware — u omitir al usar pagos x402
`network`	string	✅	Red blockchain (`ETH`, `BNB`,`POLYGON`,`TON`,`BASE`, `TRON`, `HAQQ`)
`addresses`	array[objects]	✅	La lista de direcciones de cartera a evaluar

Salidas (JSON):

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

Casos de error:

    • `402 Payment Required` → pago x402 requerido — los clientes compatibles lo liquidan automáticamente
• `400 Bad Request` → `network` o `walletAddress` malformados
• `500 Internal Server Error` → fallo temporal aguas abajo

3. Herramienta de Análisis Predictivo de Comportamiento

ID: predictive_behaviour

Úsalo cuando necesites:

  • Predicciones de siguiente mejor acción e intenciones ("¿Esta dirección depositará, comerciará o hará staking?")
  • Un perfil de tolerancia al riesgo y experiencia
  • Segmentación por categoría (p. ej., NFT, DeFi, uso de puentes)
  • Recomendaciones personalizadas basadas en patrones históricos

➡️ Ejemplos de casos de uso:

• "¿Qué hará esta dirección a continuación?"
• "¿Es el usuario de alto riesgo o experimentado?"
• "Recomienda las mejores estrategias DeFi para 0x1234... en la red ETH."

Entradas:

Nombre	Tipo	Requerido	Descripción
`apiKey`	string	✅*	Clave API de ChainAware — u omitir al usar pagos x402
`network`	string	✅	Red blockchain (`ETH`, `BNB`,`BASE`,`HAQQ`,`SOLANA`)
`walletAddress`	string	✅	La dirección de cartera a evaluar

Salidas (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 error:

    • `402 Payment Required` → pago x402 requerido — los clientes compatibles lo liquidan automáticamente
• `400 Bad Request` → `network` o `walletAddress` malformados
• `500 Internal Server Error` → fallo temporal aguas abajo

4. Herramienta de Análisis Predictivo de Comportamiento por Lotes

ID: predictive_behaviour_batch

Descripción: Este motor impulsado por IA proyecta cuáles son las intenciones de una dirección de cartera o qué es probable que haga a continuación, perfila su historial previo en cadena y recomienda acciones personalizadas. Programa un trabajo de cálculo de auditoría por lotes (predicción de comportamiento por lotes) para una lista de direcciones de cartera. Úsalo cuando el usuario proporcione un CSV o una lista de direcciones para analizar. Devuelve un job_id y una firma inmediatamente — informa el job_id al usuario y guarda tanto el job_id como la firma en el contexto; son necesarios para todas las llamadas de seguimiento. NO hagas polling ni esperes resultados después de programar.

Úsalo cuando necesites:

  • Predicciones de siguiente mejor acción e intenciones ("¿Estas direcciones depositarán, comerciarán o harán staking?")
  • Un perfil de tolerancia al riesgo y experiencia para una lista determinada de direcciones
  • Segmentación por categoría (p. ej., NFT, DeFi, uso de puentes)
  • Recomendaciones personalizadas basadas en patrones históricos

➡️ Ejemplos de casos de uso:

• "¿Qué harán estas direcciones a continuación?"
• "¿Son estos usuarios de alto riesgo o experimentados?"
• "Recomienda las mejores estrategias DeFi para [{ox1..,0x2,0x3}] en la red ETH."

Entradas:

Nombre	Tipo	Requerido	Descripción
`apiKey`	string	✅*	Clave API de ChainAware — u omitir al usar pagos x402
`network`	string	✅	Red blockchain (`ETH`, `BNB`,`BASE`,`HAQQ`,`SOLANA`)
`addresses`	array[objects]	✅	La dirección de cartera a evaluar

Salidas (JSON):

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

Casos de error:

    • `402 Payment Required` → pago x402 requerido — los clientes compatibles lo liquidan automáticamente
• `400 Bad Request` → `network` o `walletAddress` malformados
• `500 Internal Server Error` → fallo temporal aguas abajo

5. Herramienta Predictiva de Detección de Rug Pull

ID: predictive_rug_pull

Descripción: Este motor impulsado por IA pronostica qué pools de liquidez o contratos es probable que realicen un "rug pull" en el futuro (90.1% de precisión en backtesting). Úsalo cuando necesites advertir a los usuarios antes de que depositen en pools riesgosos o para monitorear la seguridad de contratos inteligentes en cadena.

➡️ Ejemplos de casos de uso:

• "¿Este nuevo pool DeFi hará rug pull si hago staking de mis activos?"
• "Monitorea mi posición de LP para detectar posibles explotaciones futuras."

Entradas:

Nombre	Tipo	Requerido	Descripción
`apiKey`	string	✅*	Clave API de ChainAware — u omitir al usar pagos x402
`network`	string	✅	Red blockchain (`ETH`, `BNB`, `BASE`, `HAQQ`)
`walletAddress`	string	✅	Dirección del contrato inteligente o pool de liquidez

Salidas (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 error: • 402 Payment Required → pago x402 requerido — los clientes compatibles se liquidan automáticamente
• 400 Bad Request → network o walletAddress malformados
• 500 Internal Server Error → fallo temporal aguas abajo

6. Credit Score Tool

ID: credit_score

Descripción: Puntuación de crédito/confianza criptográfica impulsada por IA para carteras blockchain. Combina probabilidad de fraude, análisis de entradas/salidas en cadena y análisis de grafo social para producir un riskRating del 1 (mayor riesgo) al 9 (mayor confianza). Diseñado para protocolos de préstamo DeFi que necesitan una señal rápida de solvencia de un solo número por cartera.

➡️ Casos de uso de ejemplo:

• "¿Cuál es la puntuación de crédito de esta cartera?"
• "¿Cuál es la puntuación de confianza calculada para este prestatario?"
• "Calcular la puntuación de crédito antes de aprobar este préstamo."

Entradas:

Nombre	Tipo	Requerido	Descripción
`apiKey`	string	✅*	Clave API de ChainAware — u omitir cuando se usan pagos x402
`network`	string	✅	Red blockchain (`ETH`)
`walletAddress`	string	✅	La dirección de la cartera a puntuar

Salidas (JSON):

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

riskRating	Nivel de Riesgo	Interpretación de Préstamo
9	Riesgo Muy Bajo	Prestatario principal
7–8	Riesgo Bajo	Prestatario confiable
5–6	Riesgo Moderado	Precaución elevada
3–4	Riesgo Alto	Términos restringidos
1–2	Riesgo Muy Alto	Rechazar

Casos de error:

• `401 Unauthorized` → `apiKey` inválido (no aplicable cuando se usan pagos x402)
• `400 Bad Request` → `network` o `walletAddress` malformados
• `500 Internal Server Error` → fallo temporal aguas abajo

7. Token Rank List Tool

ID: token_rank_list

Descripción: TokenRank analiza la comunidad de tenedores de tokens y clasifica cada token por la fortaleza de sus tenedores. ¡Cuanto más fuertes sean los tenedores del token, más fuerte será el token! Úsalo cuando necesites conocer el rango de token de un token o tokens, o comparar entre diferentes categorías y cadenas. Puedes usar búsqueda, filtro, ordenamiento y paginación, lo que devuelve una lista de tokens.

➡️ Casos de uso de ejemplo: – "¿Cuál es el mejor token en la categoría de Token IA?"
– "¿Comparar el token x en la cadena ETH y la cadena BNB?"

Entradas:

Nombre	Tipo	Requerido	Descripción
`limit`	string	✅	Número de elementos a obtener durante la paginación
`offset`	string	✅	Número de página (desplazamiento) durante la paginación
`network`	string		Red blockchain para filtrar (`ETH`, `BNB`, `BASE`, `SOLANA`)
`sort_by`	string		Ordenar los tokens devueltos según (por ejemplo: 'communityRank')
`sort_order`	string		'ASC' o 'DESC' para ordenar el valor de sort_by
`category`	string		Filtrar según la categoría del token (por ejemplo, 'AI Token','RWA Token','DeFi Token','DeFAI Token','DePIN Token')
`contract_name`	string		Buscar según el nombre del contrato

Salidas (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 error:

• `400 Bad Request` → `network` o `walletAddress` malformados  
• `500 Internal Server Error` → fallo temporal aguas abajo

8. Token Rank Single Tool

ID: token_rank_single

Descripción: Similar a la Lista de Rango de Tokens, Token Rank analiza la comunidad de tenedores de tokens y clasifica cada token por la fortaleza de sus tenedores. Excepto que el rango de token y los detalles del token, la herramienta de rango de token individual obtiene los mejores tenedores, sus detalles y su rango global junto con otros en la misma red. Úsalo cuando necesites conocer el rango de token de un solo token basado en la dirección del contrato y la cadena o red exacta, o cuando necesites los mejores tenedores de un token específico en una red o cadena específica.

➡️ Casos de uso de ejemplo: – "¿Cuál es el rango de token para el token en la red ETH?"
– "¿Cuáles son los mejores tenedores de esta dirección de contrato de token?" – "¿Cuál es el rango de token y sus mejores tenedores?"

Entradas:

Nombre	Tipo	Requerido	Descripción
`contract_address`	string	✅	La dirección del contrato del token a evaluar
`network`	string	✅	Red blockchain para filtrar (`ETH`, `BNB`, `BASE`, `SOLANA`)

Salidas (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 error:

• `400 Bad Request` → `network` o `walletAddress` malformados  
• `500 Internal Server Error` → fallo temporal aguas abajo

9. Run Token Audit Tool

ID: run_token_audit

Descripción: Solicita una Auditoría de Token para un contrato de token dado o devuelve los datos de auditoría ya calculados para el token solicitado. Esta herramienta es "obtener-o-crear": primero verifica si ya existe una auditoría completada para este contrato, y si es así devuelve el informe de riesgo COMPLETO de inmediato. Si aún no existe una auditoría, pone en cola una nueva y devuelve un job_id + estado "en cola" en su lugar.

Usa esta herramienta siempre que un usuario pida auditar, escanear, verificar o evaluar un token/contrato
por riesgo, señales de estafa, comportamiento de honeypot, riesgo de propiedad o riesgo de liquidez. Esta debería
ser la PRIMERA y ÚNICA herramienta llamada para una nueva solicitud — no llames a get_token_audit_result
primero "solo para verificar".

➡️ Casos de uso de ejemplo: – "Audita este contrato de token para mí: 0x..." – "¿Es seguro este token BSC? 0x..." – "Ejecuta un escaneo de riesgo en este contrato antes de comprar" – "Verifica si esta dirección es un honeypot"

Entradas:

Nombre	Tipo	Requerido	Descripción
`contract_address`	string	✅	La dirección del contrato del token a evaluar
`network`	string	✅	La red/cadena en la que vive el token (por ejemplo, 'arbitrum', 'avalanche', 'base', 'bsc', 'eth', 'optimism', 'polygon')

Salidas (JSON):

📤 Respuesta — DOS formas posibles, verifica cuál obtuviste: 1. En caché / ya auditado → audit_status = "complete" El informe de riesgo completo se devuelve de inmediato (mismo esquema que get_token_audit_result). Responde la pregunta del usuario directamente con estos datos. No se necesitan más llamadas a herramientas.

2. Aún no auditado → sin campo honeypot_analysis, en su lugar:

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

⚠️ Notas: • No vuelvas a activar una nueva auditoría para un contrato que devuelve un trabajo "en cola"/"en ejecución" ya en progreso. • Siempre verifica primero si el token fue auditado anteriormente según la respuesta para obtener directamente el resultado del token auditado en lugar de programar un nuevo cálculo.

Casos de error:

• `400 Bad Request` → `network` o `walletAddress` malformados  
• `500 Internal Server Error` → fallo temporal aguas abajo

10. Get Token Audit Result Tool

ID: get_token_audit_result

Descripción: Obtiene el estado actual o los resultados finales de un trabajo de Auditoría de Token previamente activado para una dirección de contrato y cadena dadas. Este es el SEGUNDO paso del flujo de trabajo de auditoría, utilizado para consultar y recuperar el informe de riesgo completo después de que se haya llamado a "Run Token Audit". Llama a esta herramienta inmediatamente después de "Run Token Audit" para verificar el progreso, y repetidamente (sondeo) hasta que el campo audit_status de la respuesta sea igual a "complete". Mientras audit_status sea cualquier otra cosa (por ejemplo, "en cola", "en ejecución", "pendiente"), trata el resultado como aún no listo: no resumas datos de módulos parciales/vacíos al usuario, solo informa que la auditoría aún está en progreso (opcionalmente mostrando el tiempo transcurrido si está disponible) y vuelve a sondear en breve. Una vez que audit_status = "complete", esta herramienta devuelve un informe de riesgo completo de múltiples módulos — que cubre control de propiedad, salud de liquidez, riesgo de suministro/emisión, integridad de transferencia, seguridad de approve/permit, reentrancia, comportamiento de honeypot, y una puntuación de riesgo agregada de 0-100 con veredicto. Usa estos datos para responder directamente la pregunta del usuario sobre seguridad del token, factores de riesgo o banderas rojas — no obtengas ni vuelvas a activar una nueva auditoría si ya existe un resultado completado para este contrato.

➡️ Casos de uso de ejemplo: – "¿Está lista mi auditoría para este token?" – "¿Cuál es la puntuación de riesgo y el veredicto para este contrato?" – "¿Quién es el propietario de este token, pueden acuñar o incluir en lista negra?" – "¿Es esto un honeypot? ¿Cuáles son las banderas?" – "Dame el desglose completo del riesgo de liquidez y propiedad de este contrato"

Entradas:

Nombre	Tipo	Requerido	Descripción
`contract_address`	string	✅	La dirección del contrato del token a evaluar
`network`	string	✅	La red/cadena en la que vive el token (por ejemplo, 'arbitrum', 'avalanche', 'base', 'bsc', 'eth', 'optimism', 'polygon')

Salidas (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: • Si audit_status no es "complete", la mayoría de los campos de módulos/agregados pueden ser nulos, vacíos o desactualizados — no los presentes como resultados finales. • Una risk_score alta o campos de tono/severidad "alto"/"crítico" indican peligro elevado; resáltalos prominentemente en lugar de ocultarlos bajo módulos que pasan.

Casos de error:

• `400 Bad Request` → `network` o `walletAddress` malformados  
• `500 Internal Server Error` → fallo temporal aguas abajo

11. Agents Trust Score List Tool

ID: agents_trust_score_list

Descripción: La Puntuación de Confianza de Agentes de ChainAware es una puntuación de 0-1000 que mide qué tan seguro es interactuar con cualquier agente de IA registrado en ERC-8004. A diferencia de los sistemas de reputación basados en votación — donde los agentes pueden votarse entre sí para fabricar confianza — la Puntuación de Confianza de Agentes se deriva enteramente del historial de comportamiento en cadena. No se puede ganar en horas. No se puede falsificar con un grupo de carteras nuevas. Refleja el historial real de la persona o entidad que controla el agente. A medida que el comercio agéntico escala — con agentes de IA completando compras de forma autónoma en nombre de consumidores en ChatGPT, Google Gemini y Shopify — la pregunta de qué agentes pueden ser confiables para transaccionar ya no es teórica. ChainAware la responde con evidencia en cadena, no con respaldos de pares. Devuelve una lista de Agentes y su resultado.

➡️ Casos de uso de ejemplo: – "Dame una lista de Agentes y su puntuación de confianza?" – "¿Cuál es el mejor Agente registrado después de 2025-01-01?"

Entradas:

Nombre	Tipo	Requerido	Descripción
`page`	string	✅	Número de página (page) durante la paginación
`limit`	string	✅	Número de elementos a obtener durante la paginación
`sort_by`	string	X	Ordenar los agentes devueltos según, p. ej.: 'registered_at'
`sort_order`	string	X	pero requerido si sort_by es 'asc' o 'desc' — ordena el valor de sort_by (por defecto desc)
`registered_after`	string	X	Filtrar según la fecha y hora en que se registró el agente

Salidas (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 error:

• `400 Bad Request` → malformado `network` o `walletAddress`  
• `500 Internal Server Error` → fallo temporal aguas abajo

12. Herramienta de Puntaje de Confianza de Agentes Individual

ID: agents_trust_score_single

Descripción: Similar a Agent Trust List, Agent Trust Score Single es una puntuación de 0-1000 que mide qué tan seguro es interactuar con cualquier agente de IA registrado en ERC-8004. A diferencia de los sistemas de reputación basados en votación — donde los agentes pueden votarse entre sí para fabricar confianza — el Agent Trust Score se deriva enteramente del historial de comportamiento en cadena. No se puede ganar en horas. No se puede falsificar con un grupo de billeteras nuevas. Refleja el historial real de la persona o entidad que controla al agente. A medida que el comercio agéntico escala — con agentes de IA completando compras de forma autónoma en nombre de consumidores en ChatGPT, Google Gemini y Shopify — la pregunta de qué agentes son confiables para transaccionar ya no es teórica. ChainAware la responde con evidencia en cadena, no con respaldos de pares. Devuelve los detalles individuales en profundidad para un agente solicitado.

➡️ Casos de uso de ejemplo: – "¿Cuál es el puntaje de confianza para este agente id 12314 en chain_id 56?"

Entradas:

Nombre	Tipo	Requerido	Descripción
`agent_id`	integer	✅	ID del agente devuelto por la herramienta agents_trust_score_list
`chain_id`	integer	✅	ID de la cadena donde el agente está desplegado/registrado, obtenido previamente de la herramienta agents_trust_score_list

Salidas (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 error:

• `400 Bad Request` → malformado `network` o `walletAddress`  
• `500 Internal Server Error` → fallo temporal aguas abajo

13. Verificar Estado de Trabajo por Lotes

ID: check_job_status

Descripción: Verifica el progreso de un trabajo de cálculo por lotes programado. Devuelve solo conteos (completados, fallidos, pendientes) — sin datos de billeteras. Llama a esto cuando el usuario pregunte si un trabajo está terminado o cómo va progresando. Si el estado es 'processing' o 'pending', informa al usuario y no llames a get_job_results. Solo sugiere obtener resultados cuando el estado sea 'completed' o 'partial'. Tanto job_id como signature de schedule_calculation son requeridos para llamar a esta herramienta. Nunca llames a esto sin que ambos valores estén presentes en el contexto.

➡️ Casos de uso de ejemplo:

• ¿Cuál es el estado del trabajo id 0fc5897a-ad64-4f21-88b5-1274d1cfec46 usando esta firma 260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a?

Entradas:

Nombre	Tipo	Requerido	Descripción
`job_id`	string	✅	El ID del trabajo devuelto por el cálculo programado (predictive_fraud_batch o predictive_behaviour_batch)
`signature`	string	✅	La firma devuelta por el cálculo programado (predictive_fraud_batch o predictive_behaviour_batch). Requerida para el acceso

Salidas (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 error:

• `403 Unauthorized` → inválido `apiKey` (no aplicable al usar pagos x402)
• `403 Unauthorized` → inválido `signature`
• `400 Bad Request` → malformado `network` o `walletAddress`  
• `500 Internal Server Error` → fallo temporal aguas abajo

14. Obtener Resultados de Trabajo por Lotes

ID: get_job_results

Descripción: Recupera los resultados de un trabajo por lotes completado o parcialmente completado. Solo llama a esto cuando check_job_status muestre que el estado es 'completed' o 'partial'. Devuelve una lista de direcciones de billetera completadas y la cadena/red compartida — úsalas para consultar el backend principal y obtener los datos reales de análisis de billeteras. Esto NO devuelve datos de billeteras directamente, solo la lista de direcciones necesaria para obtenerlos. Tanto job_id como signature de schedule_calculation son requeridos para llamar a esta herramienta. Nunca llames a esto sin que ambos valores estén presentes en el contexto.

➡️ Casos de uso de ejemplo:

• ¿Cuál es el resultado del trabajo id 0fc5897a-ad64-4f21-88b5-1274d1cfec46 usando esta firma 260866090d88bf61bdfb54f0533fe876bfd8ded7339691c50ada9de59a48124a?

Entradas:

Nombre	Tipo	Requerido	Descripción
`job_id`	string	✅	El ID del trabajo devuelto por el cálculo programado (predictive_fraud_batch o predictive_behaviour_batch)
`signature`	string	✅	La firma devuelta por el cálculo programado (predictive_fraud_batch o predictive_behaviour_batch). Requerida para el acceso

Salidas (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 error:

• `403 Unauthorized` → inválido `apiKey` (no aplicable al usar pagos x402)
• `403 Unauthorized` → inválido `signature`
• `400 Bad Request` → malformado `network` o `walletAddress`  
• `500 Internal Server Error` → fallo temporal aguas abajo

🧠 Ejemplo de Uso del Cliente

Ejemplo en 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);

Ejemplo en 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)

Configuración del servicio:

  "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 Integración

✅ Compatible con clientes MCP en entornos Node.js, Python y basados en navegador
🔁 Usa Server-Sent Events (SSE) para respuestas en streaming / tiempo real
📐 Los esquemas JSON cumplen con la especificación MCP
🚦 Pueden aplicarse límites de tasa según el nivel de uso
🔑 Clave API requerida para endpoints de producción
💳 Pago x402 compatible — pago por llamada mediante el protocolo x402 sin clave API de suscripción; los clientes x402 compatibles gestionan el pago automáticamente en respuestas HTTP 402

Configuración de Claude Code (CLI)

Usa la CLI de Claude para registrar el servidor MCP mediante 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"

📚 Documentación: https://code.claude.com/docs/en/mcp

Configuración del Conector de ChatGPT

Disponible en entornos ChatGPT que admiten Connectors / MCP (Modo Desarrollador).

Pasos

Abre Configuración de ChatGPT
Navega a Apps / Connectors
Haz clic en Añadir conector
Introduce el nombre de la integración y la URL a continuación
Guarda la configuración

Detalles de la integración

Nombre

ChainAware Behavioural Prediction MCP Server

URL de integración

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

Configuración de Claude Web y Claude Desktop

Pasos

Abre Claude Web o Claude Desktop
Ve a Configuración → Integraciones
Haz clic en Añadir integración
Introduce el nombre y la URL a continuación
Haz clic en Añadir para completar la configuración

Detalles de la integración

Nombre

ChainAware Behavioural Prediction MCP Server

URL de integración

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

📚 Documentación: https://platform.claude.com/docs/en/agents-and-tools/remote-mcp-servers

Configuración de Cursor

Añade el servidor MCP a tu archivo de configuración de Cursor (p. ej. mcp.json):

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

📚 Documentación: https://cursor.com/docs/context/mcp

🤖 Subagentes de Claude Code

Este repositorio incluye 34 subagentes de Claude Code listos para usar en .claude/agents/ — agentes especialistas que manejan tareas comunes de inteligencia Web3 de forma inmediata.

Agente	Propósito
`chainaware-wallet-auditor`	Debida diligencia completa: perfilado conductual profundo, incluidos indicadores de fraude
`chainaware-fraud-detector`	Detección rápida de fraude en carteras
`chainaware-rug-pull-detector`	Comprobaciones de seguridad de contratos inteligentes / LP
`chainaware-trust-scorer`	Puntuación de confianza (0,00–1,00)
`chainaware-credit-scorer`	Puntuación de crédito cripto (1–9) para decisiones de préstamo y solvencia
`chainaware-ltv-estimator`	Potencial de ingresos a 12 meses (LTV) como rango en USD basado en señales conductuales
`chainaware-reputation-scorer`	Puntuación de reputación (0–1000)
`chainaware-aml-scorer`	Puntuación de cumplimiento AML (0–100)
`chainaware-wallet-ranker`	Rango de experiencia de cartera + tabla de clasificación
`chainaware-wallet-marketer`	Mensajes de marketing personalizados
`chainaware-token-ranker`	Descubrir/clasificar tokens por fortaleza de la comunidad de tenedores
`chainaware-token-analyzer`	Análisis profundo de un solo token + principales tenedores
`chainaware-onboarding-router`	Enrutar carteras a incorporación principiante/intermedia/omitir
`chainaware-whale-detector`	Clasificar carteras en niveles de ballena (Mega/Ballena/Emergente)
`chainaware-defi-advisor`	Recomendaciones personalizadas de productos DeFi por experiencia + nivel de riesgo
`chainaware-airdrop-screener`	Detección por lotes de carteras para elegibilidad de airdrop, filtrar bots/fraude
`chainaware-lending-risk-assessor`	Grado de riesgo del prestatario (A–F), ratio de garantía, nivel de tasa de interés
`chainaware-token-launch-auditor`	Auditoría de seguridad previa al lanzamiento — APROBADO/CONDICIONAL/RECHAZADO
`chainaware-agent-screener`	Puntuación de confianza de agente IA 0–10 mediante comprobaciones del agente + carteras alimentadoras
`chainaware-cohort-analyzer`	Segmentar un lote de carteras en cohortes conductuales con estrategias de participación por cohorte
`chainaware-counterparty-screener`	Veredicto en tiempo real previo a la transacción (Seguro / Precaución / Bloquear) antes de una operación, transferencia o interacción con contrato
`chainaware-governance-screener`	Detección de votantes DAO: detección Sybil, nivel de gobernanza y multiplicador de peso de voto (admite modelos ponderados por token, por reputación y cuadráticos)
`chainaware-sybil-detector`	Detección masiva de ataques Sybil para votos DAO: clasifica votantes como ELEGIBLE / REVISAR / EXCLUIR, detecta patrones de fraude coordinados (granjas de carteras, oleadas de carteras nuevas) y produce multiplicadores de voto ponderados por reputación
`chainaware-transaction-monitor`	Puntuación de riesgo de transacción en tiempo real para agentes autónomos: puntuación compuesta (0–100) y acción de pipeline (PERMITIR / MARCAR / RETENER / BLOQUEAR)
`chainaware-lead-scorer`	Calificación de leads de ventas: puntuación de lead (0–100), nivel (Caliente/Tibio/Frío/Muerto), probabilidad de conversión y ángulo de contacto recomendado
`chainaware-upsell-advisor`	Ruta de venta adicional para usuarios existentes: puntuación de disposición a actualizar, siguiente recomendación de producto, evento desencadenante y mensaje de venta adicional listo para usar
`chainaware-platform-greeter`	Mensaje de bienvenida contextual para una cartera específica en una plataforma específica: la misma cartera recibe un mensaje diferente en Aave vs 1inch vs OpenSea
`chainaware-marketing-director`	Orquestador de campañas de ciclo completo: segmenta audiencia, puntúa leads, detecta ballenas, construye manual de mensajes por cohorte, identifica oportunidades de venta adicional y enruta nuevas carteras
`chainaware-compliance-screener`	Detección de cumplimiento de primera capa alineada con MiCA: orquesta detector de fraude, puntuador AML, monitor de transacciones y detector de contrapartes en un Informe de Cumplimiento con veredicto (PASS / EDD / REJECT)
`chainaware-gamefi-screener`	Detección de carteras para juegos Web3 y P2E: detecta granjas de bots, tramposos y carteras de granja; clasifica jugadores legítimos en niveles de experiencia para emparejamiento; genera elegibilidad de recompensas P2E
`chainaware-portfolio-risk-advisor`	Evaluación de rug pull a nivel de cartera y salud de la comunidad: escanea cada token, produce Puntuación de Riesgo de Cartera ponderada, grado (A–F), indicadores de concentración y plan de reequilibrio priorizado
`chainaware-rwa-investor-screener`	Detección de idoneidad de inversores RWA: evalúa riesgo de fraude, experiencia y alineación del perfil de riesgo con el nivel RWA; devuelve CUALIFICADO / CONDICIONAL / DERIVAR_A_KYC / DESCALIFICADO con límite de inversión
`chainaware-agent-trust-screener`	Detección de confianza de agentes IA ERC-8004: lista y clasifica agentes registrados por puntuación de confianza 0–1000, devuelve nivel de confianza e indicadores, advierte firmemente sobre carteras no verificadas
`chainaware-token-audit-analyst`	Auditoría profunda de contratos de tokens multi-módulo: propiedad, liquidez, oferta/acuñación, detección de honeypot, reentrancy; pipeline asíncrono con puntuación de riesgo 0–100 y desglose por módulo

Configuración

Paso 1 — Conecta el servidor MCP

Los agentes llaman a las herramientas de ChainAware a través de MCP. Registra el servidor primero:

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

Para Cursor / Windsurf, añade a mcp.json:

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

Paso 2 — Copia los archivos de agentes

Clona este repositorio y copia los agentes en tu proyecto:

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

O selecciona solo los agentes que necesites:

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

Paso 3 — Configura la clave API

export CHAINAWARE_API_KEY="your-key-here"

Obtén una clave en https://chainaware.ai/pricing

Notas importantes

La línea tools: en el frontmatter de cada agente hace referencia al servidor MCP por su nombre registrado. Si registras el servidor con un nombre diferente, actualiza las líneas tools: para que coincidan.
Los agentes especifican un model: en su frontmatter (claude-haiku-4-5-20251001 o claude-sonnet-4-6). Necesitas acceso a esos modelos.
La carpeta references/ contiene documentación detallada de herramientas que proporciona a los agentes un contexto más rico. Copiarla junto con los agentes es recomendable pero opcional.

🔐 Notas de seguridad

No incrustes claves API en repositorios públicos
Prefiere variables de entorno o gestores de secretos cuando estén disponibles
Rota las claves regularmente en entornos de producción

🔒 Política de acceso

El servidor MCP admite dos métodos de acceso:

Clave API — suscríbete a un plan en https://chainaware.ai/pricing y pasa la clave mediante el encabezado X-API-Key
Pagos x402 — usa cualquier cliente MCP compatible con x402 para acceso de pago por llamada sin necesidad de suscripción; el servidor devuelve HTTP 402 con los detalles de pago y el cliente liquida automáticamente

📖 Lecturas adicionales

Prensa y reconocimiento

CB Insights Fraud Prevention Market Map for the AI Era — ChainAware destacada como solución líder de prevención de fraude en la era de la IA para Web3 (2026)
BNB Chain AI Landscape — ChainAware incluida por BNB Chain como proyecto clave de IA en el ecosistema (2025)
BNB Chain Kickstart — Marketing Tools — Growth Agents y Wallet Marketer destacados en el programa Kickstart de BNB Chain (2025)
Google Cloud $250k Grant — ChainAware seleccionada para una subvención de $250,000 de Google Cloud (2025)
AWS Fintech Accelerator — ChainAware aceptada en el programa AWS Fintech Accelerator (2024)
Safary Club Web3 Growth Landscape — Growth Tools — ChainAware destacada en Growth Tools for Web3 Projects (2024)

Resúmenes de producto

ChainAware Complete Product Guide — Resumen de todas las herramientas, redes y cobertura
Web3 Business Potential — Caso de negocio y oportunidad de mercado para la inteligencia Web3
Use ChainAware as a Business — Cómo construir productos y servicios comerciales sobre ChainAware

Guías específicas de herramientas

Fraud Detector Guide — Cómo usar predictive_fraud: entradas, salidas, umbrales, casos de uso
Rug Pull Detector Guide — Cómo usar predictive_rug_pull: puntuación de contratos, riesgo del desplegador, análisis de LP
Token Rank Guide — Cómo usar token_rank_list y token_rank_single: puntuación de fortaleza de la comunidad
Wallet Rank Guide — Sistema de clasificación de carteras: niveles de experiencia, rango global, puntos
Wallet Auditor Guide — Flujo de trabajo completo de auditoría de carteras que combina múltiples herramientas
Transaction Monitoring Guide — Patrones de monitoreo de riesgo de transacciones en tiempo real
Web3 Behavioral User Analytics Guide — Uso de predictive_behaviour para analítica y segmentación de usuarios
Credit Score Guide — Metodología de puntuación de crédito Web3 y uso en préstamos DeFi
Credit Scoring Agent Guide — Cómo construir y usar el agente de puntuación de crédito de ChainAware
Agent Trust Score for Agentic Commerce — Detección de agentes ERC-8004 en más de 274k agentes registrados: niveles de confianza, detección de fraude a nivel de flota y control de acceso DeFi usando agents_trust_score_list / agents_trust_score_single
Token Audit: 10,000 CoinGecko Token Results — Estudio del mundo real: el 55% de los tokens principales reciben veredicto de ALTO RIESGO; 127 comprobaciones de seguridad automatizadas mediante run_token_audit

Analítica y estrategia

Web3 User Segmentation & Behavioral Analytics for DApp Growth — Estrategias de segmentación para retención y crecimiento de DApps
AI-Powered Blockchain Analysis: Machine Learning for Crypto Security — Enfoques de ML para seguridad on-chain y detección de fraude
Forensic Crypto Analytics vs AI-Based Crypto Analytics — Comparación de herramientas forenses tradicionales vs el enfoque de IA predictiva de ChainAware
MiCA Compliance DeFi Screener — Cómo ChainAware cubre ~70–75% de las obligaciones MiCA de DeFi; posiciona el compliance-screener frente a Chainalysis/Elliptic
Web3 Growth Platforms Compared 2026 — Marco de embudo de tres etapas; ChainAware opera en la Etapa 3 (post-conexión, personalización dentro de la DApp)
Web3 Analytics Tools for DApps Comparison 2026 — Mapea 10 plataformas de analítica en cuatro categorías de trabajo; ChainAware es la única plataforma de inteligencia predictiva
Why Personalization Is the Next Big Thing for AI Agents — El argumento a favor de la personalización a nivel de cartera en Web3

Integración para desarrolladores

12 Blockchain Capabilities Any AI Agent Can Use — MCP Integration Guide — Todas las capacidades explicadas, con instrucciones de configuración para Claude, ChatGPT, Cursor y sistemas multi-agente
Prediction MCP for AI Agents: Personalize Decisions from Wallet Behavior — Guía de integración en profundidad con ejemplos de código
Top 5 Ways Prediction MCP Will Turbocharge Your DeFi Platform — Casos de uso de préstamos, DEX, launchpad, gobernanza y personalización
DeFi Onboarding in 2026: Why 90% of Connected Wallets Never Transact and How AI Agents Fix It — Problema de conversión en la incorporación y soluciones impulsadas por IA
The Web3 Agentic Economy: How AI Agents Are Replacing Human Teams in DeFi — Cómo los agentes de IA autónomos están asumiendo las operaciones y la toma de decisiones en DeFi

🧾 Licencia

MIT (para ejemplos de cliente). La implementación del servidor y la lógica de backend son propietarias y permanecen privadas.

Recursos y terceros

🏆 Reconocimiento

ChainAware está destacada en el CB Insights Fraud Prevention Market Map for the AI Era como una solución líder de prevención de fraude impulsada por IA para la era de la IA (2026).

ChainAware está incluida en el BNB Chain AI Landscape — reconocida por BNB Chain como un proyecto clave de IA en el ecosistema (2025).

ChainAware está incluida en BNB Chain Kickstart — Marketing Tools — Growth Agents y Wallet Marketer destacados en el programa oficial Kickstart de BNB Chain (2025).

ChainAware recibió una $250k Google Cloud Grant — seleccionada por Google Cloud para desarrollo de infraestructura e IA (2025).

ChainAware fue aceptada en el AWS Fintech Accelerator — seleccionada por AWS para su programa Fintech Accelerator (2024).

ChainAware está destacada en el Safary Club Web3 Growth Landscape — Growth Tools — incluida en la categoría Growth Tools for Web3 Projects (2024).