> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockgence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Herramientas

> Las herramientas que el servidor MCP le da a tu asistente, qué hace cada una y cuánto cuesta.

Cada herramienta llama a un endpoint de la API con tu clave y consume los mismos créditos que ese endpoint. Las que
cuestan 0 sirven para orientarse antes de gastar.

> [!NOTE]
>
> Tu asistente recibe con cada herramienta las mismas reglas que la API: una falla de la fuente no es «sin datos», un
> resultado parcial trae `degraded_sources` y una pista se presenta como pista, nunca como un hecho.

## Cobertura y cuenta

| Herramienta | Qué hace | Créditos |
| - | - | - |
| `list_chains` | Las redes soportadas y qué se puede consultar en cada una. Conviene usarla antes de afirmar qué se ve en una red. | 0 |
| `source_health` | El estado de las fuentes de datos: cuáles responden, cuáles están caídas o fuera del plan y hasta cuándo. | 0 |
| `account_usage` | Tu plan, tus límites y lo que llevás consumido en el mes. | 0 |

## Screening y atribución

| Herramienta | Qué hace | Créditos |
| - | - | - |
| `screen_address` | Riesgo de una dirección: categoría, sanciones de OFAC con su historial, score y recomendación (`block`, `review` o `allow`). Acepta EVM, Tron y Monero. | 3 |
| `get_address_labels` | Las labels conocidas de una dirección, incluidas las que aportaste vos, con su riesgo y su estado de sanciones. | 1 |
| `enrich_address` | Datos on-chain de una dirección y sus contrapartes principales etiquetadas. | 4 |
| `check_contract_security` | Seguridad de un contrato: verificado, honeypot, impuestos, proxy, holders y marcas maliciosas. Si la fuente falla, lo dice: nunca responde «no malicioso» por una falla. | 3 |
| `get_funding_source` | Quién fondeó primero una wallet, resuelto contra entidades conocidas. | 1 |
| `probe_chains` | En qué redes tiene actividad real una dirección. Una red que no se pudo consultar sale como desconocida, no como «sin actividad». | 2 |
| `osint_web` | Qué se sabe públicamente de una dirección en la web abierta. Solo cuenta como mención un resultado que muestra la dirección completa. | 5 |
| `resolve_ens` | Resuelve nombres ENS (`.eth`). | 2 |

## Rastreo de fondos

| Herramienta | Qué hace | Créditos |
| - | - | - |
| `trace_funds` | Rastrea los fondos desde una dirección: riesgo, exposición por categoría, contrapartes, entidades notables y mayores flujos. | 25 |
| `trace_from_tx` | Rastrea desde la transacción de una pérdida: qué salió de la víctima y adónde llegó (exchanges, bridges, mixers). | 25 |
| `follow_bridge` | Desde un depósito en un bridge, reconstruye el otro lado del cruce (red destino y destinatario) por el identificador del protocolo. | 25 |
| `unswap_transaction` | Sigue el valor a través de un swap: qué activo entró, cuál salió, cuánto y hacia quién. | 10 |
| `demix_tornado` | Desde quien depositó en Tornado Cash, los retiros que probablemente le corresponden. Son pistas con confianza, no pruebas. | 15 |
| `get_transaction` | Los movimientos internos de una transacción. | 5 |
| `get_onchain_messages` | Mensajes de texto en las transacciones de una dirección. | 4 |

## Contratos, tokens y transacciones

| Herramienta | Qué hace | Créditos |
| - | - | - |
| `inspect_contract` | Quién controla un contrato y quién puede mover, mintear o congelar sus fondos, leído on-chain a un bloque fijo. | 10 |
| `simulate_transaction` | Simula una transacción antes de firmarla: si pasa o revierte, cambios de saldo, permisos que otorga y delegaciones. | 15 |
| `token_profile` | La ficha de un token para analizar un rug pull: deployer, pools, liquidez, mints, ventas y blacklist. | 25 |
| `decode_transaction` | La ejecución de una transacción decodificada: árbol de llamadas, eventos, cambios de saldo y flashloans. | 15 |

## Permisos, drenajes y víctimas

| Herramienta | Qué hace | Créditos |
| - | - | - |
| `get_approvals` | Cada permiso que dio una dirección y su estado de hoy (abierto, cerrado o vencido), con cuánto puede mover cada spender. | 10 |
| `approvals_by_spender` | Consulta inversa: quiénes le dieron permiso a un spender y cuáles siguen abiertos. | 15 |
| `signature_drains` | Salidas de una dirección en transacciones que no envió, con el mecanismo que las autorizó (firma, permit, delegación). | 20 |
| `get_delegation` | Delegaciones EIP-7702 de una dirección y la transacción que instaló la vigente. | 3 |
| `detect_address_poisoning` | Envenenamiento de direcciones: direcciones parecidas a las contrapartes de una víctima y la pérdida, si la hubo. | 5 |
| `drainer_victims` | Las víctimas de un drainer, con lo robado en USD y los permisos que siguen abiertos. | 25 |
| `scam_victims` | Las víctimas de un estafador con evidencia, separadas de los indicios y del resto de quienes le mandaron fondos. | 40 |
| `classify_compromise_vector` | Por cada transacción de pérdida, quién autorizó la salida, con la evidencia y lo que se descartó. Describe el mecanismo, nunca la culpa. | 30 |

## Incidentes

| Herramienta | Qué hace | Créditos |
| - | - | - |
| `incident_playbook` | Desde la transacción de un exploit, arranca un trabajo que decodifica, identifica al atacante, calcula lo robado, rastrea y arma el caso. | 40 más cada paso completado |
| `stolen_funds_tracker` | Sigue los fondos robados de un hack: cuánto se devolvió, congeló, llegó a exchanges, mixers o bridges, o sigue quieto. | 40 al empezar o recalcular; 0 al leer |
| `incident_postmortem` | Un borrador de post-mortem del incidente de un caso, con la parte on-chain citada. | 40; 0 si ya estaba armado en las últimas 24 h |
| `exploit_attempts` | Los intentos fallidos del atacante, con el motivo de cada revert. | 10 |
| `fund_returns` | Qué se devolvió de un hack y cómo se clasifica, contra el acuerdo de SEAL Safe Harbor o el bounty ofrecido. | 40 |
| `safe_harbor_lookup` | Si una dirección está cubierta por un acuerdo de SEAL Safe Harbor on-chain. | 5 |
| `issuer_freeze_status` | Si una dirección está congelada hoy por los emisores de USDT o USDC, y cuándo la congelaron o liberaron. | 3 |
| `freeze_evidence_pack` | El paquete para pedirle un congelamiento a la autoridad o al emisor, desde un caso guardado. Blockgence no envía nada. | 30 |

## Monero

| Herramienta | Qué hace | Créditos |
| - | - | - |
| `get_monero_transaction` | La ficha pública de una transacción de Monero. Monero no publica remitentes, destinatarios ni montos: no hay rastreo. | 5 |
| `verify_monero_payment` | Verifica un pago en XMR con la tx key de quien pagó o una prueba firmada, sin que la clave salga del servidor. | 10 |

> [!NOTE]
>
> Las herramientas de Monero necesitan un nodo de Monero configurado en el servidor. Si no lo hay, responden
> `source_unavailable` con `reason: "not_configured"`.

## Guard

| Herramienta | Qué hace | Créditos |
| - | - | - |
| `list_guard_alerts` | Las alertas activas de tus vigilancias y de las compartidas de tu organización. | 0 |
| `get_guard_alert` | Una alerta: los eventos de la transacción, su historia y los saltos seguidos. | 0 |
| `create_guard_watch` | Vigila una dirección EVM en una red, propia o de un atacante. Respeta el tope de vigilancias de tu plan. | 0 |

Las herramientas de Guard necesitan una clave asignada a una persona.

## Prompts de ejemplo

* «Screeneá 0x098b716b8aaf21512996dc57eb0615e2383e2f96 y decime si la bloqueo.»
* «¿El contrato 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48 es seguro o es un honeypot?»
* «Seguí la plata desde 0x098b… tres saltos y contame a qué exchanges o mixers llegó.»
* «¿Cuánto llevo consumido este mes?»

> [!TIP]
>
> Las labels que cargaste con tu clave las ven todas las herramientas. Las que cargaste dentro de un caso no, porque el
> MCP no trabaja dentro de un caso.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.