Guías
Inicio rápido
En cinco minutos haces tu primera consulta en sandbox. Después, la misma llamada funciona en producción quitando /sandbox de la URL.
Antes de empezar
- Un token Floid. Identifica a tu empresa y define qué servicios tienes contratados. Lo entrega Floid; para pruebas, pide uno de sandbox.
- MCP activado. Para usar el MCP, tu ejecutivo comercial de Floid debe activarlo para tu empresa.
- La URL base:
https://mcp.floid.app
Guarda el token en una variable de entorno (
FLOID_TOKEN) y nunca lo pegues en el chat de un agente ni lo subas a un repositorio.1. Busca la herramienta
El catálogo es público y se puede filtrar por palabras, sin tildes ni orden.
curl "https://mcp.floid.app/v1/herramientas?q=productos+persona"
2. Lee su ficha
La ficha trae el esquema de entrada (JSON Schema), los bancos disponibles y los avisos de uso.
curl https://mcp.floid.app/v1/herramientas/banco_persona.productos.consultar
3. Ejecútala en sandbox
El sandbox responde con datos ficticios y acepta el RUT de prueba 11111111-1 con clave 1234.
curl https://mcp.floid.app/sandbox/v1/ejecutar \
-H "Authorization: Bearer $FLOID_TOKEN" \
-H "Content-Type: application/json" \
-d '{"herramienta": "banco_persona.productos.consultar",
"parametros": {"banco": "bci", "rut": "11111111-1", "clave": "1234"}}'
import os
import httpx
respuesta = httpx.post(
"https://mcp.floid.app/sandbox/v1/ejecutar",
headers={"Authorization": f"Bearer {os.environ['FLOID_TOKEN']}"},
json={
"herramienta": "banco_persona.productos.consultar",
"parametros": {"banco": "bci", "rut": "11111111-1", "clave": "1234"},
},
timeout=300, # un login bancario puede tardar más de un minuto
)
print(respuesta.json())
const respuesta = await fetch("https://mcp.floid.app/sandbox/v1/ejecutar", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.FLOID_TOKEN}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
herramienta: "banco_persona.productos.consultar",
parametros: { banco: "bci", rut: "11111111-1", clave: "1234" },
}),
});
console.log(await respuesta.json());
4. Lee la respuesta
Siempre llega como {data, meta}. Los montos vienen como números y las fechas en ISO, sin importar el banco.
{
"data": {
"products": {
"accounts": [
{
"type": "corriente",
"number": 12345678,
"currency": "CLP",
"balance": 10000,
"line_balance": 10000
},
{
"type": "vista",
"number": 700654321,
"currency": "CLP",
"balance": 5000000
}
],
"cards": [
{
"number": "1234",
"type": "credito",
"name": "MasterCard",
"CLP": {
"total": 100000,
"used": 0,
"available": 100000
},
"USD": {
"total": 3000,
"used": 0,
"available": 3000
}
},
{
"number": "4321",
"type": "credito",
"name": "MasterCard",
"CLP": {
"total": 100000,
"used": 0,
"available": 100000
},
"USD": {
"total": 3000,
"used": 0,
"available": 3000
}
}
],
"lines": [
{
"number": 123123131,
"CLP": {
"total": 600000,
"used": 0,
"available": 600000
}
}
]
}
},
"meta": {
"herramienta": "banco_persona.productos.consultar",
"caseid": "xxxxx"
}
}