Servidor MCP

El servidor MCP de Skipo expone la API pública v2 a través del Model Context Protocol, para que puedas conectar tu cuenta a Claude (Desktop, Code o cualquier cliente compatible) y preguntar por tus balances, transacciones y actividad de cambio en lenguaje natural. El agente traduce tus preguntas a llamadas de lectura contra la API.

Solo lectura

El servidor MCP de Skipo solo emite peticiones GET. No puede mover dinero, crear retiros ni ejecutar conversiones — aunque se lo pidas. No existe ninguna herramienta de escritura.

Cómo conectar

Skipo aloja el servidor; no hay nada que instalar y no manejas llaves de API.

• Conector remoto (OAuth) — añade https://api.skipo.com/mcp como conector personalizado en tu cliente, inicia sesión con tu cuenta Skipo (OAuth 2.1) y aprueba el acceso de solo lectura. Puedes revocarlo cuando quieras desde el panel, en Aplicaciones conectadas.

Herramientas

Son 15 herramientas, todas de solo lectura, y se corresponden con operaciones GET de la API v2. Los importes se devuelven como cadenas decimales (conserva la precisión) y las fechas en ISO-8601.

Las colecciones paginadas llegan como { items, pagination }. Ojo: no es la misma envoltura que la API REST, que usa { data, pagination } — el servidor MCP renombra data a items para que todas las herramientas devuelvan la misma forma. El bloque pagination es idéntico. get_balances es la excepción: devuelve la lista completa como arreglo, sin envoltura ni paginación.

Cuenta y balances

Requiere el scope accounts:read.

Herramienta	Devuelve
get_account	Perfil de la cuenta: nombre, identificación, estado de verificación, moneda preferida.
get_balances	Balances por moneda (disponible, congelado, pendiente, valor en USD).
get_balance_history	Instantáneas históricas de balance de una moneda (por día/semana/mes).
get_ledger	Asientos del libro contable de una moneda, cada uno con su source — la superficie de conciliación.

Transferencias

Requiere el scope transfers:read.

Herramienta	Devuelve
get_withdrawals	Historial de retiros con filtros; o uno por transaction_id.
get_deposits	Historial de depósitos con filtros; o uno por transaction_id.

Convert (órdenes y fills)

Requiere el scope trading:read.

Herramienta	Devuelve
get_orders	Órdenes de conversión, con filtros. No trae una por id: usa los filtros para acotar.
get_fills	Fills (ejecuciones) de todas las órdenes — cuando la pregunta abarca varias.
get_order_fills	Fills de una orden concreta, cuando ya tienes su id.

Contactos

Requiere el scope contacts:read.

Herramienta	Devuelve
get_contacts	Destinos de transferencia guardados (cripto/banco); o uno por contact_id.

Datos de mercado

Requiere el scope market_data:read.

Herramienta	Devuelve
get_assets	Activos soportados (fiat, stablecoin, cripto, acción) y sus restricciones; o uno por asset_symbol.
get_markets	Mercados soportados (pares, mínimos); o uno por market.
get_indicative_price	Precio indicativo (no vinculante) de un mercado: tasa e importe convertido, para compra o venta. Nada queda reservado, no tiene vencimiento y no devuelve id de orden, así que no se puede ejecutar.

Un precio indicativo no es una cotización

get_indicative_price responde «¿a qué tasa quedaría?», no «resérvame esta tasa». Skipo cobra un spread de dealer, por lo que la tasa depende del tamaño y no escala linealmente: pasa amount + amount_asset para un monto concreto, o omite ambos y el precio será para el mínimo del mercado (no lo multipliques para estimar un monto mayor). amount está limitado por el maxIndicativeQuoteAmount del activo (ver get_assets); por encima del límite la llamada se rechaza y el error indica el máximo.

Obtener una cotización confirmable es POST /v2/quotes (scope trading:write) y ejecutarla requiere una petición firmada — ninguna de las dos es accesible desde este conector.

Además es la herramienta más cara: 10 puntos por llamada, frente a 1–3 del resto, porque llega a un proveedor de precios externo. Ver coste por herramienta.

Estado del servicio

Sin scope; sirven para diagnóstico y para anclar fechas relativas.

Herramienta	Devuelve
check_api_health	Comprobación de disponibilidad/salud de la API.
get_server_time	Hora del servidor de Skipo (desfase de reloj / fechas relativas).

Errores

El servidor propaga los errores RFC 9457 de la API v2 al agente: el code estable, el detail legible y el enlace al catálogo de errores. Cuando se alcanza el límite de tasa, el error indica además cuánto hay que esperar. Con eso el asistente puede decidir si vuelve a intentarlo por su cuenta: Skipo no reintenta la llamada por ti.