Floid Developers Contáctanos

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

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"
  }
}

Siguientes pasos