{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/final-icon.png\" alt=\"Final\" width=\"128\" />\n</p>\n\n<h1 align=\"center\">Final POS MCP</h1>\n\n<p align=\"center\">\n  Build custom <strong>point of sale, kiosk, self-checkout, KDS &amp; in-person payment apps</strong> with AI agents —<br />\n  from Gemini CLI, Claude Code, Cursor, ChatGPT, or any MCP client.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://finalpos.com\">finalpos.com</a> ·\n  <a href=\"https://build.finalpos.com\">Final Builder</a> ·\n  <a href=\"https://docs.finalpos.com\">API Docs</a>\n</p>\n\n---\n\n[Final](https://finalpos.com) lets anyone create their own POS — every pixel,\nevery permission, every interaction — and run it on any hardware: desktop,\ntablet, mobile, kiosk, payment terminal, line buster, or menu board, with\nintegrated card payments in 24+ countries.\n\nThis repo is the official home for connecting **your own AI agent** to Final.\nIt ships:\n\n- A **Gemini CLI extension** (this repo installs directly).\n- The hosted **Final Flows MCP server** — 20 tools for grounded API lookups,\n  vetted screen blueprints, flow file writes, live sandbox previews,\n  validation gates, and deploys.\n- The **Final docs MCP server** — search the Final POS REST API.\n- Setup snippets for **Claude Code, Cursor, ChatGPT, and any MCP client**.\n\nEverything your agent builds appears live in the [Final builder](https://build.finalpos.com):\nthe app shows up in your home grid, the agent's session appears as a chat, and\nevery file write is a restorable checkpoint.\n\n## Get an API key\n\nAll clients authenticate with a Final **organization API key** (`sk_...`):\n\n1. Sign in at [build.finalpos.com](https://build.finalpos.com).\n2. Open a flow, then in the chat rail click the **cable icon** → **\"Connect\n   your AI tool\"**.\n3. Mint a key — it is shown **once**, so copy it right away.\n\n## Install\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/Final-Commerce/final-pos-mcp\n```\n\nYou'll be prompted for your `FINAL_API_KEY` during install (stored in your\nsystem keychain). Change it later with:\n\n```bash\ngemini extensions config final-pos\n```\n\nThen start building:\n\n```\n/final-pos:new a coffee-shop kiosk with a product grid, cart, and card payments\n/final-pos:preview   # live sandbox preview URL\n/final-pos:validate  # run the full gate suite\n/final-pos:deploy    # ship it\n```\n\n### Claude Code\n\n```bash\nclaude mcp add final-flows --transport http https://build.finalpos.com/api/mcp \\\n  --header \"Authorization: Bearer sk_YOUR_KEY\"\n```\n\n### Cursor\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=final-flows&config=eyJ1cmwiOiJodHRwczovL2J1aWxkLmZpbmFscG9zLmNvbS9hcGkvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyIFlPVVJfRklOQUxfQVBJX0tFWSJ9fQ==)\n\nOr add to `~/.cursor/mcp.json` manually:\n\n```json\n{\n  \"mcpServers\": {\n    \"final-flows\": {\n      \"url\": \"https://build.finalpos.com/api/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer sk_YOUR_KEY\" }\n    }\n  }\n}\n```\n\n### ChatGPT and any other MCP client\n\nThe server speaks standard **Streamable HTTP**:\n\n- **Endpoint:** `https://build.finalpos.com/api/mcp`\n- **Auth header:** `Authorization: Bearer sk_YOUR_KEY` (or `x-api-key: sk_YOUR_KEY`)\n\nIn ChatGPT, add it as a connector under **Settings → Connectors** (developer\nmode). Works the same in VS Code, Windsurf, Zed, and anything else that speaks\nMCP.\n\n## What your agent can do\n\n| Category | Tools |\n| --- | --- |\n| **Grounding** | `lookup_command_frame`, `lookup_pos_api`, `lookup_engine_component`, `list_blueprints`, `get_blueprint`, `get_scaffold` |\n| **Flow lifecycle** | `list_flows`, `create_flow`, `connect_chat`, `log_message`, `read_flow_files`, `write_flow_files`, `delete_flow_files` |\n| **Preview & ship** | `start_preview`, `sync_preview`, `get_preview_status`, `stop_preview`, `validate_flow`, `open_in_builder`, `deploy_flow` |\n\nA typical build: `get_scaffold` → `create_flow` → ground every UI call in\n`lookup_command_frame` → adapt a vetted blueprint → `write_flow_files` →\n`validate_flow` → `start_preview` → hand you a live URL.\n\nAll tool calls are scoped to your own organization's flows. Rate limits per\nkey: 30 preview boots/hour, 12 builds+deploys/hour, 300 file writes/hour.\n\n## Security\n\n- Your API key is org-scoped and revocable; the secret is never stored by\n  this extension repo — Gemini CLI keeps it in your system keychain.\n- The MCP servers are hosted by Final; no code from this repo runs locally\n  except prompt/context files.\n- Agents cannot touch engine-owned files, and every deploy passes guardrail,\n  typecheck, and secret scans.\n\n## License\n\n[Apache-2.0](LICENSE) © Final Commerce\n",
  "bytes": 4646,
  "sha": "79f48e1b2881d790f3b926ca6feaa24de6cac5e0ba4eb7135b64ccde44b9fcf5",
  "repo_slug": "final-commerce/final-pos-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_final_commerce_final_pos_mcp_4b96e77d/readme"
}