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 elige un modo de acceso: Automático (el MCP ejecuta las operaciones de manera autónoma, después de validarlas), Confirmar operaciones (órdenes, cauciones y suscripciones o rescates de FCI solo se ejecutan desde un enlace de confirmación; las herramientas de ejecución directa quedan ocultas e inhabilitadas) o Solo lectura (el conector expone únicamente las herramientas de consulta y queda inhabilitado para invocar cualquier herramienta operativa o de aceptación de declaraciones juradas). Después puede cambiarlo pidiéndoselo a la IA, que devuelve un enlace de configuración de un solo uso y con vencimiento; el cambio se aplica sin volver a vincular la cuenta. El modo se guarda del lado del servidor y cada cambio queda registrado.
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.
Las compras, ventas, cauciones y suscripciones o rescates de FCI requieren un paso previo de validación antes de ejecutarse. En modo Confirmar operaciones, además, solo se envían cuando el usuario las confirma desde un enlace de un solo uso y con vencimiento; en modo Automático, el MCP las ejecuta de manera autónoma una vez validadas; en modo Solo lectura no se ejecuta ninguna operación. 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. |
simulate_fixed_income_by_amount | Calcula los nominales y pagos proyectados para un monto a invertir en renta fija. El monto debe ser positivo; la moneda predeterminada es ARS. No envía una orden ni mueve fondos. | Simulación por monto (solo lectura). |
simulate_fixed_income_by_nominals | Calcula el costo y los pagos proyectados para una cantidad positiva de nominales de renta fija. No envía una orden ni mueve fondos. | Simulación por nominales (solo lectura). |
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. |