Skip to main content
FL

Flow

v0.1.0HMAC

PSP nativo de Chile. Órdenes de pago alojadas que cubren Webpay, ETpay, tarjetas, transferencia bancaria y efectivo, autenticadas con HMAC firmado.

8 herramientas3 env vars🇨🇱 Chileestable en npm

Qué puede hacer tu agente

Flow le da a tu agente 8 tools que llama directo — elegí las que necesite, en Claude, Cursor o cualquier cliente MCP.

  • create_paymentCreate a hosted payment order (POST /payment/create). Returns url + token + flowOrder; the customer pays at url + '?token=' + token. paymentMethod 9 offers every method Flow has enabled for the merchant (Webpay, ETpay bank transfer, cash, international cards).
  • create_payment_by_emailCreate a collection order Flow emails to the customer (POST /payment/createEmail). Same shape as create_payment but Flow delivers the payment link by email — no checkout redirect needed.
  • get_payment_statusGet a payment order's status by Flow token (GET /payment/getStatus). status: 1 pending, 2 paid, 3 rejected, 4 canceled.
Ejemplo de llamada
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("create_payment", { /* ... */ });

Instalar

terminal
$ npm install @codespar/mcp-flow-cl

Quickstart

Agregá esta entrada a tu claude_desktop_config.json (o a la config de cualquier cliente compatible con MCP).

claude_desktop_config.json
{
  "mcpServers": {
    "flow-cl": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-flow-cl"
      ],
      "env": {
        "FLOW_API_KEY": "<your_flow_api_key>",
        "FLOW_SECRET_KEY": "<your_flow_secret_key>"
      }
    }
  }
}

Después de reiniciar, tu agente puede llamar cualquiera de las 8 herramientas de abajo — probá create_payment primero.

Variables de entorno · 3

Necesarias para autenticar el server. Almacenadas cifradas al usar el hosting gestionado de CodeSpar.

FLOW_API_KEY
obligatoriosecret

Flow merchant API key

FLOW_SECRET_KEY
obligatoriosecret

Flow secret key used to HMAC-SHA256 sign every request

FLOW_ENV
opcional

Environment: 'sandbox' or 'production'. Defaults to 'sandbox'.

Herramientas disponibles · 8

Cada herramienta es independiente — tu agente carga solo lo que necesita para reducir contexto y tiempo de respuesta.

WRITEcreate_payment
Create a hosted payment order (POST /payment/create). Returns url + token + flowOrder; the customer pays at url + '?token=' + token. paymentMethod 9 offers every method Flow has enabled for the merchant (Webpay, ETpay bank transfer, cash, international cards).
WRITEcreate_payment_by_email
Create a collection order Flow emails to the customer (POST /payment/createEmail). Same shape as create_payment but Flow delivers the payment link by email — no checkout redirect needed.
WRITEget_payment_status
Get a payment order's status by Flow token (GET /payment/getStatus). status: 1 pending, 2 paid, 3 rejected, 4 canceled.
WRITEget_payment_status_by_commerce_id
Get a payment order's status by your commerceOrder id (GET /payment/getStatusByCommerceId).
WRITEget_payment_status_by_flow_order
Get a payment order's status by Flow order number (GET /payment/getStatusByFlowOrder).
WRITElist_payments
List payments received on a given date (GET /payment/getPayments). Paged; date is the merchant's local day.
DELETEcreate_refund
Create a refund order (POST /refund/create). Refund a received payment fully or partially; Flow notifies urlCallBack when the refund resolves.
DELETEget_refund_status
Get a refund order's status by refund token (GET /refund/getStatus). status: created, accepted, rejected, refunded, canceled.

Frameworks compatibles

MCP es un protocolo — cualquier framework que lo hable puede montar este server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Cualquier cliente MCPProtocolo

Preguntas frecuentes

Corré `npx -y @codespar/mcp-flow-cl` y agregá el bloque de config de arriba a tu cliente MCP — Claude, Cursor, VS Code o cualquier cliente compatible con MCP. Sin build, sin SDK. ¿Preferís hosted? El tier gestionado de CodeSpar lo corre por vos, con la auth resuelta.
Flow — MCP server · 8 tools | CodeSpar