For AI agents

The Final Flows MCP server

Final Flows is the MCP (Model Context Protocol) server for the Final commerce platform. Connect it to Claude Code, Cursor, ChatGPT, Codex, or any MCP client, and your AI agent can build a complete point-of-sale app end to end: ground every API call in version-locked catalogs, adapt vetted screen blueprints, write files into a cloud flow with restorable checkpoints, boot a live HTTPS preview, persist data in offline-capable custom tables, run the same validation gates Final's own builder uses, and deploy to real payment terminals, tablets, and kiosk hardware.

Quick start (no manual setup)

The fastest way to connect is from Build itself: on build.finalpos.com, start a prompt and choose "Connect your own AI (MCP)". Build creates your flow and generates one self-contained block — setup instructions, the server address, a one-time key, and your build brief. Paste that block into your AI tool and it wires up the connection on its own.

Manual configuration

Already have an organization API key? Point your client straight at the server. Keys are minted in Build (chat rail → Connect your AI tool) and shown once — treat them like a database password.

claude mcp add final-flows --transport http https://build.finalpos.com/api/mcp \
  --header "Authorization: Bearer sk_YOUR_ORG_KEY"

{
  "mcpServers": {
    "final-flows": {
      "url": "https://build.finalpos.com/api/mcp",
      "headers": { "Authorization": "Bearer sk_YOUR_ORG_KEY" }
    }
  }
}

[mcp_servers.final-flows]
url = "https://build.finalpos.com/api/mcp"
http_headers = { "Authorization" = "Bearer sk_YOUR_ORG_KEY" }

Settings → Apps & Connectors → enable developer mode → Create
Connector URL: https://build.finalpos.com/api/mcp

Tool catalog

Every tool is org-scoped. Read tools are annotated read-only; writes and deploys are marked destructive so clients can ask before acting.

Worked examples

Paste any of these into a connected client and watch the flow appear in Build with a live preview.

Build a bakery counter POS: a product grid organized by category (breads, pastries, drinks), a running cart with per-item notes, tap-to-pay checkout, and a receipt with our logo. Start from the closest blueprint, then start a live preview so I can watch.

Create a self-checkout kiosk flow for a cafe. Add a loyalty punch card: create a custom table for customers and stamps, give every 10th drink free, and let customers look themselves up by phone number at checkout. Validate the flow when you're done.

Build a mobile line-busting flow for one-handed use on a phone: quick-add buttons for our 12 best sellers, order notes, and Tap to Pay. When it validates green, give me the link to open it in Build so I can deploy it.

Frequently asked questions