Skip to main content
FL

Flow

v0.1.0HMAC

PSP nativo do Chile. Ordens de pagamento hospedadas cobrindo Webpay, ETpay, cartões, transferência bancária e dinheiro, autenticadas com HMAC assinado.

8 ferramentas3 env vars🇨🇱 Chileestável no npm

O que seu agente faz

O Flow dá ao seu agente 8 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer 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.
Exemplo de chamada
// 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

Adicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com 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>"
      }
    }
  }
}

Depois de reiniciar, seu agente pode chamar qualquer uma das 8 ferramentas abaixo — teste create_payment primeiro.

Variáveis de ambiente · 3

Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.

FLOW_API_KEY
obrigatóriosecret

Flow merchant API key

FLOW_SECRET_KEY
obrigatóriosecret

Flow secret key used to HMAC-SHA256 sign every request

FLOW_ENV
opcional

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

Ferramentas disponíveis · 8

Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.

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 compatíveis

MCP é um protocolo — qualquer framework que o fale pode montar este server.

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

Perguntas frequentes

Rode `npx -y @codespar/mcp-flow-cl` e adicione o bloco de config acima ao seu cliente MCP — Claude, Cursor, VS Code ou qualquer cliente compatível com MCP. Sem build, sem SDK. Prefere hospedado? O tier gerenciado da CodeSpar roda pra você, com a auth resolvida.
Flow — MCP server · 8 tools | CodeSpar