Use Final from Your AI Agent
Final's official MCP server is https://ai.finalpos.com/mcp. Connect Claude, ChatGPT, Cursor, VS Code, Gemini CLI, Codex or any MCP client and sign in with your Final account; your agent can then work in Hub (catalog, stock, orders, customers, reports) and build POS apps with Flow, grounding REST calls with flow_lookup_pos_api.
Final's official MCP (Model Context Protocol) server connects your AI agent to your Final account. One remote endpoint reaches every Final product you allow:
Hub, the back office: products and catalog, stock and purchase orders, orders, customers, sales reports, team and roles, outlets, taxes, bookings.
Flow, the app builder: create, preview, validate and deploy custom POS, kiosk, self-checkout and payment-terminal apps, with every call grounded in the Final POS API.
You sign in with your Final account and choose the company and what the agent may do. There is nothing to install.
Endpoint
https://ai.finalpos.com/mcpTransport: Streamable HTTP. Auth: OAuth 2.1 with PKCE (sign in with Final), or a fai_ connection key from ai.finalpos.com/connections for clients without OAuth. The full setup guide for every client is on GitHub.
Setup
Claude (claude.ai, Claude Desktop)
Settings → Connectors → Add custom connector, with URL https://ai.finalpos.com/mcp.
ChatGPT
Settings → Apps & Connectors → Advanced settings → Developer mode, then Create with the URL https://ai.finalpos.com/mcp.
Claude Code
claude mcp add --transport http final https://ai.finalpos.com/mcpThen run /mcp and choose Authenticate.
Cursor
Add to Cursor, or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"final": { "url": "https://ai.finalpos.com/mcp" }
}
}VS Code (GitHub Copilot)
code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'Gemini CLI
gemini extensions install https://github.com/Final-Commerce/final-pos-mcpThen sign in once with /mcp auth final.
Codex and scripts
Create a connection key at ai.finalpos.com/connections (it is shown once) and add it to ~/.codex/config.toml:
[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }What your agent can use
Tools are grouped in packs, which are also what you allow when you connect. A connection lists only a few packs at a time to keep the model's context small; find_tools searches every allowed pack and call_tool calls any allowed tool.
| Pack | Product | What it covers |
|---|---|---|
catalog | Hub | Products, variants, categories, options, modifiers, product photos and the media library |
inventory | Hub | Stock levels and history, transfers, suppliers, purchase orders, reorder rules |
orders | Hub | Orders, refunds and e-commerce order sync (read-only: the till takes payments) |
customers | Hub | Customer records, notes, order history and customer import |
reports | Hub | Financial summary, sales and payment breakdowns, employee sales, sessions, transactions |
team | Hub | Team members, roles and permissions |
store | Hub | Outlets, stations, taxes and Hub extensions |
bookings | Hub | Bookable services: rules, resources, availability, holds and confirmations |
build | Flow | API grounding, blueprints, flow files, preview sandboxes, validation, deploy |
build_data | Flow | Custom tables, the secrets vault and Flow extensions |
Every tool is listed in the tool reference.
Looking up the API while you code
With the build pack, the agent checks the Final POS REST API with flow_lookup_pos_api and the command-frame API with flow_lookup_command_frame before it writes a call, so it codes against the real contract instead of guessing. For reading the docs yourself, the API reference has every endpoint and schema.
Example
Ask your agent:
"Using Final, find out how to create a customer through the Final POS API, then write a Node.js function that creates one with retry handling."
Or, to work in your store directly:
"Which products are below their reorder point at the Main Street outlet? Draft a purchase order for the usual supplier and show it to me before you send it."
Retired: the key-free docs server
The read-only docs server at https://mcp.finalpos.com/mcp that this page used to describe is no longer public. Replace it with https://ai.finalpos.com/mcp in your MCP configuration.
Last updated