> For the complete documentation index, see [llms.txt](https://docs.lid.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lid.pro/es/agents/tools.md). # Referencia de herramientas Cada herramienta del catálogo MCP de Lid agrupada por tarea: productos, compartir, enlaces y campañas, retos, ventas, webhooks, y las herramientas de compra en vista previa. Cada herramienta que expone la conexión de agentes de Lid, agrupada por tarea. Los nombres coinciden con el catálogo MCP. Montos: `priceUsdc` va en unidades humanas (`"5"` son cinco dólares); los premios y recompensas van como strings de USDC atómicos (`"1000000"` es un dólar). Cada fila dice lectura, escritura o dinero. Las herramientas de escritura cambian el estado. Las de dinero mueven dólares digitales (USDC) fuera de la billetera del agente. ## Identidad y salud | Herramienta | Qué hace | | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `api_health` | Si la API responde. Lectura. | | `my_agent_wallet` | En nombre de quién actúa esta clave: id de usuario, billetera real (a donde va el ingreso), billetera del agente (actúa en Solana). Lectura. | | `get_my_usage` | Límites de creación con usado y restante, hora de reinicio, saldos de la billetera del agente. Lectura, gratis. | ## Productos | Herramienta | Qué hace | | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `create_product` | Crea un producto. Requerido: `name`, `priceUsdc`, `maxSupply`. Opcional: descripción, portada, etiquetas, comisión (`affiliateCommissionBps`, de 100 a 5000, por defecto 1000), límite por billetera, hora de inicio de venta, traducciones. El ingreso va 100% a la billetera real del dueño de la clave. Un producto de pago sin archivos se crea como borrador. Los cursos se arman en el panel. Escritura. | | `update_product` | Campos editoriales: los archivos que descargan los compradores (`extraFiles`), portada, texto, publicar o despublicar. Precio, unidades y comisión quedan fijos al crear. Escritura. | | `upload_file` | Aloja un archivo desde una URL pública, 25 MB máximo. `gated: true` devuelve una `key` para contenido de pago; `gated: false` devuelve una `url` pública para portadas. Escritura. | | `my_products` | Los productos que posee esta clave. Lectura. | | `product_analytics` | Ventas, volumen, ingreso, sharers y series diarias de un producto. Lectura. | | `get_reviews_by_product` | Reseñas y calificación promedio de un producto. Lectura. | ## Compartir y ganar | Herramienta | Qué hace | | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | `affiliate_to_product` | Únete a un producto como sharer. Devuelve el código y el enlace para compartir. No puedes compartir tu propio producto. Escritura. | | `my_affiliations` | Cada producto que comparte esta clave, con código, enlace, clics, conversiones y ganancias. Lectura. | | `get_affiliate_by_code` | Consulta pública de un código para compartir. Cuenta un clic. Lectura. | | `get_solana_affiliate_earnings` | Registros de comisión y totales de una billetera. Lectura. | ## Enlaces y campañas | Herramienta | Qué hace | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `create_tracked_link` | Un enlace corto que cuenta clics, referidos y resultados. Slug opcional, campaña opcional. Escritura. | | `list_my_links` | Enlaces que esta clave posee o comparte. Lectura. | | `get_link_analytics` | Clics, eventos, conversiones y el embudo de un enlace. Lectura. | | `create_campaign` | Una campaña con metas. Cada meta nombra un evento y una recompensa en USDC atómicos. Ventana de atribución de 1 a 90 días, por defecto 7. Las conversiones con recompensa pasan por revisión manual por defecto. Las metas con recompensa necesitan una bolsa fondeada antes de que la campaña abra. Escritura. | | `get_campaign_analytics` | El embudo de una campaña y su ranking de sharers. Lectura. | | `list_conversions` | Conversiones de tu campaña por estado: pendiente, aprobada, rechazada, pagada. Lectura. | | `review_conversion` | Aprueba o rechaza una conversión pendiente. Las aprobadas pasan a ser pagables. Escritura. | ## Retos La API llama bounty a un reto. Es lo mismo. | Herramienta | Qué hace | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `create_bounty` | Publica un reto: título, descripción, criterios, premios por posición, fecha límite. `fund: true` mueve el premio de la billetera del agente a la bolsa y lo abre. Debes pasar `acceptTerms: true`: un reto con dinero en la bolsa o entregas recibidas no se puede borrar, solo archivar; la bolsa solo sale hacia las personas a las que la asignas; la comisión se cobra al crear. Pregunta primero al humano. Escritura, dinero. | | `list_bounties` | Retos abiertos (público) o los tuyos con `mine: true`. Lectura. | | `get_bounty` | Un reto con el estado de su bolsa. Lectura. | | `list_submissions` | Entregas a tu reto, con archivos de evidencia. Lectura. | | `review_submission` | Marca una entrega como aceptada, rechazada o ganadora. Ganadora requiere `assignedAmount`. Escritura. | | `assign_bounty_winners` | Asigna cada premio pendiente de la bolsa. Cada titular de premio lo reclama después desde su propia billetera. Escritura, dinero. | | `get_bounty_winners` | Titulares de premio y estado del pago: pendiente, asignado, reclamado, con las referencias públicas. Lectura. | | `get_pool` | La bolsa por dirección: fondeado, asignado, pagado, con el registro público completo. Lectura. | | `my_pending_prizes` | Premios asignados a esta clave que todavía no se reclaman. Lectura. | ## Ventas y analítica | Herramienta | Qué hace | | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `my_sales` | Lo que vendiste, lo más nuevo primero, con los archivos como enlaces firmados para que puedas entregarlos al comprador desde tu propia app. Filtra por comprador. Lectura. | | `my_analytics` | Tus números como creador o como sharer, de 7 días a todo el tiempo. Lectura. | | `search_creators`, `get_latest_creators` | Busca creadores por nombre, bio o país; quién es nuevo. Lectura. | ## Webhooks | Herramienta | Qué hace | | --------------------------------- | ------------------------------------------------------------------------------------------------------ | | `create_webhook` | Registra una URL para los eventos que elijas. El secreto de firma se devuelve una sola vez. Escritura. | | `list_webhooks`, `delete_webhook` | Tus endpoints. Lectura, escritura. | | `webhook_deliveries` | Intentos recientes de un endpoint, con estado y error. Lectura. | Detalles y la verificación de firma: [Webhooks y eventos](/es/agents/webhooks.md). ## Vista previa: comprar Estas herramientas responden hoy. Están en vista previa: úsalas para probar, no para dinero en producción. | Herramienta | Qué hace | | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `purchase_product` | Compra un producto con el saldo propio de la billetera del agente. Pasa `maxPriceUsdc` como tope; si el precio es mayor no se firma nada. La billetera del agente es dueña del recibo y descarga el contenido con `my_purchases`. Pregunta al humano antes de gastar. Escritura, dinero. | | `my_purchases` | Lo que compró la billetera del agente, con los archivos como enlaces firmados. Lectura. | | `prepare_purchase` | Arma una compra sin firmar para que tu usuario final la firme dentro de tu app, con un código para compartir opcional para que el reparto pague al sharer. Después haces POST de la transacción firmada a `/api/v1/lidpro/sponsor` para que la plataforma pague la comisión de red y la transmita. Nada sale de la billetera del agente. Escritura. | | `confirm_purchase` | Confirma una compra que transmitiste, para que el recibo y los archivos aparezcan en segundos. Se puede llamar dos veces sin riesgo. Escritura. | | `prepare_usdc_transfer`, `prepare_sol_transfer` | Arma una transferencia sin firmar para que la firme una billetera que controlas. Nada se mueve del lado del servidor. Lectura. | --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.lid.pro/es/agents/tools.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.