Servidor MCP remoto que conecta la inteligencia artificial con la cuenta de un cliente de IOL para consultar, analizar y operar los mercados argentinos desde la conversación.
https://mcp.invertironline.com
La vinculación se realiza mediante OAuth con el flujo de consentimiento estándar del usuario: cada cliente autoriza el acceso desde su propia cuenta de IOL y puede revocarlo en cualquier momento desde la configuración de su cuenta. Se recomienda el uso del doble factor de autenticación.
Al vincular la cuenta, el usuario puede optar por un permiso de solo lectura. Con esta opción activada, el conector expone únicamente las herramientas de consulta y queda inhabilitado para invocar cualquier herramienta operativa o de aceptación de declaraciones juradas. Es el nivel recomendado para quienes solo quieran consultar y analizar su cuenta sin operar. El conector opera bajo el principio de acceso cerrado por defecto (default deny): las capacidades operativas solo se habilitan mediante scopes explícitamente autorizados por el usuario.
El servidor no registra ni almacena el contenido de las conversaciones del usuario con la aplicación cliente. El acceso se limita a los datos de la cuenta autenticada necesarios para ejecutar cada herramienta.
Ninguna orden se envía al mercado de forma automática. Toda operación con efecto real (compra, venta, caución, suscripción/rescate de FCI, stop loss / take profit, aceptación de DDJJ) requiere un paso previo de validación y la confirmación explícita del usuario antes de ejecutarse. Ante cualquier discrepancia, prevalece siempre la información oficial de las secciones "Portfolio" y "Estado de Cuenta" de la plataforma y app de IOL.
El conector expone 27 herramientas agrupadas en tres categorías según su efecto.
Consultan datos. No modifican ningún estado.
Simulan una operación. No envían nada al mercado.
Ejecutan operaciones reales o persisten declaraciones.
Todas realizan peticiones GET y no crean, modifican ni eliminan estado alguno en IOL ni en ningún otro sistema.
| Herramienta | Qué hace | Datos que accede |
|---|---|---|
get_portfolio | Devuelve las tenencias actuales de la cartera del usuario. | Posiciones de la cuenta autenticada. |
get_balance | Devuelve el saldo en efectivo por plazo de liquidación (T0–T3) y moneda (ARS, USD). | Saldos de la cuenta autenticada. |
get_activities | Devuelve el historial de actividad: movimientos y operaciones ejecutadas. | Historial de la cuenta autenticada. |
get_asset_quote | Devuelve el precio actual y la caja de puntas de un activo. | Datos de mercado. |
get_asset_info | Devuelve datos de referencia de un activo: tipo, moneda, lote, símbolos relacionados. | Catálogo de instrumentos de IOL. |
get_price_history | Devuelve barras históricas OHLCV de un activo. | Datos históricos de mercado. |
get_options_chain | Devuelve la cadena de opciones de un subyacente: strikes, vencimientos, precios y griegas. | Datos de opciones. |
get_next_corporate_events | Devuelve las próximas fechas ex-dividendo y de pago de un ticker. | Calendario de acciones corporativas de IOL. |
get_caucion_rates | Devuelve las tasas de caución colocadora para los próximos 3 días hábiles. | Datos de mercado de caución. |
get_caucion_rate | Devuelve la tasa de caución colocadora para un plazo puntual en días. | Datos de mercado de caución. |
get_fixed_income_analytics | Devuelve analítica de renta fija de un bono, letra o nota (TIR, duration, paridad, interés corrido, flujos). | Datos de renta fija. |
get_fci_funds | Lista los fondos comunes de inversión (FCI) disponibles. | Catálogo de FCI de IOL. |
get_order_status | Devuelve el estado de una orden puntual (pendiente, parcial, ejecutada, cancelada, rechazada). | Órdenes de la cuenta autenticada. |
get_stop_loss_and_take_profit | Devuelve los stop loss y take profit configurados en la cuenta. | Configuración de la cuenta autenticada. |
get_ddjj | Devuelve el texto de la declaración jurada (DDJJ) requerida para una operación. Solo lectura: no registra aceptación. | Contenido regulatorio para el usuario autenticado. |
Simulan una operación contra el motor de validación de IOL para devolver comisiones, detalles de liquidación y DDJJ requerida. No envían ninguna orden al mercado ni modifican fondos, posiciones o datos de la cuenta.
| Herramienta | Qué simula |
|---|---|
validate_order | Una orden de compra/venta, devolviendo costo estimado, comisiones, impuestos y DDJJ requerida. |
validate_caucion | Una colocación de caución colocadora, devolviendo tasa, plazo y capital. |
validate_fci_subscription | Una suscripción a un FCI, devolviendo montos, comisiones y horarios de corte. |
validate_fci_redemption | Un rescate de un FCI, devolviendo montos, comisiones y horarios de corte. |
Ejecutan operaciones reales sobre la cuenta del usuario o persisten declaraciones con efecto legal. Todas requieren confirmación explícita del usuario. Se recomienda ejecutar la herramienta de validación correspondiente antes de invocarlas.
| Herramienta | Efecto | Reversibilidad |
|---|---|---|
accept_ddjj | Registra la aceptación formal de una declaración jurada en IOL. Precondición para ciertas órdenes. | Declaración con efecto legal bajo normativa argentina; auditable por el bróker. No se revierte por la herramienta. |
place_order | Envía una orden de compra o venta a IOL para su ejecución en el mercado. | De ejecutarse, modifica efectivo y posiciones. Puede cancelarse con cancel_order mientras siga pendiente. |
cancel_order | Cancela una orden pendiente por su ID. | Una vez cancelada, la orden no se ejecuta. No se deshace. |
place_caucion | Coloca una caución colocadora: presta fondos a la tasa y plazo indicados. | Fondos comprometidos por el plazo de la caución. No se desarma a voluntad antes del vencimiento. |
subscribe_fci | Suscribe fondos del usuario a un FCI. | Aplican plazos de liquidación y rescate. No se revierte a voluntad antes de la ventana de rescate. |
redeem_fci | Rescata cuotapartes de un FCI a efectivo. | Aplican plazos de liquidación. Una vez enviada antes del corte, no se cancela a voluntad. |
create_stop_loss_or_take_profit | Crea una orden contingente que vende automáticamente al alcanzarse un precio disparador. | Al dispararse, coloca una venta real. Puede eliminarse con delete_stop_loss_or_take_profit. |
delete_stop_loss_or_take_profit | Elimina un stop loss o take profit configurado por su ID. | Removida la protección, no habrá venta automática si el mercado se mueve en contra. |