[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_113":114},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":-5,"_63":-5,"_64":11,"_65":49,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":-5,"_77":-5,"_78":-5,"_79":49,"_80":-5,"_81":59,"_82":83,"_84":85,"_86":87,"_88":89,"_90":91},"apiUrl","https://odel.app/api","creator","final-commerce","moduleId","final-pos-mcp","@final-commerce/final-pos-mcp","displayName","Final POS","tagline","Build custom POS, kiosk, self-checkout & in-person payment apps with AI agents on Final POS.","iconKey","https://avatars.githubusercontent.com/u/246548698?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://build.finalpos.com/api/mcp\",\"transport\":\"streamable-http\",\"authType\":\"bearer\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1783332264000,"updatedAt",1788765960000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=com.finalpos.build%2Ffinal-flows","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",0,"upstreamUpdatedAt",1785198031000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/Final-Commerce/final-pos-mcp","githubRepoFullName","Final-Commerce/final-pos-mcp","releaseId","ext-final-commerce-final-pos-mcp","version","1.0.1","descriptionMarkdown","

\n $\"Final\"$ \n

\n\n

Final POS MCP

\n\n

\n Build custom point of sale, kiosk, self-checkout, KDS & in-person payment apps with AI agents —
\n from Gemini CLI, Claude Code, Cursor, ChatGPT, or any MCP client.\n

\n\n

\n finalpos.com ·\n Final Builder ·\n API Docs\n

\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](https://github.com/Final-Commerce/final-pos-mcp/blob/main/LICENSE) © Final Commerce\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays","upstream",{"_100":101,"_102":103,"_104":-5,"_105":106,"_107":108,"_109":110},"requiredSecrets",[],"tags",[94,95,96,97,98,99],"assets",[],"stats",{"_92":59,"_93":59},"ratingAvg","reviewCount","ai-agents","gemini-cli","gemini-cli-extension","kiosk","payments","point-of-sale","topics",[94,95,96,97,111,112,98,99],"license","Apache-2.0","language","registryName","com.finalpos.build/final-flows","homepage","https://finalpos.com/mcp","packages",[],"mcp","mcp-server","ENV",{"_115":116,"_117":118,"_119":120},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]