MCP server de Final POS
Commit 18 oct 2026Crea aplicaciones de POS personalizadas y gestiona operaciones minoristas, incluyendo inventario, pedidos e informes de ventas, a través de un agente de IA.
También conocido como Final-Commerce/final-pos-mcp, final
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 2.0.1
- Último commit
- 18 oct 2026
- Licencia
- Apache-2.0
¿Qué es Final POS MCP?
Final POS es un MCP server. Crea aplicaciones de POS personalizadas y gestiona operaciones minoristas, incluyendo inventario, pedidos e informes de ventas, a través de un agente de IA.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Final POS
Final MCP server proporciona una conexión remota a la plataforma de comercio Final, lo que permite a los agentes de IA gestionar operaciones minoristas y desarrollar aplicaciones de punto de venta personalizadas. Los usuarios pueden conectar clientes como Claude, ChatGPT, Gemini, Cursor o VS Code utilizando un único endpoint HTTP. El servidor opera a través de dos productos principales: Flow, que se utiliza para construir flujos de checkout, quioscos de autoservicio y terminales de pago; y Hub, que funciona como el back office para gestionar catálogos, inventario, pedidos e informes de ventas.
La configuración se realiza mediante OAuth 2.1 a través de una página de inicio de sesión donde seleccionas tu empresa y los packs de permisos específicos, o mediante el uso de una connection key para clientes sin soporte de OAuth. El agente actúa en nombre del usuario conectado, respetando los roles y permisos existentes. Aunque el servidor facilita la creación y gestión de los datos de la tienda, no gestiona directamente el procesamiento de pagos ni los reembolsos a través del modelo. Los desarrolladores pueden controlar el alcance del agente activando o desactivando packs específicos como catalog, inventory o build.
Qué puedes hacer con él
- 1Desarrollar aplicaciones de checkout personalizadasUn agente de IA puede construir un quiosco para una cafetería con una cuadrícula de productos y pagos con tarjeta, proporcionando un enlace de vista previa en vivo.
- 2Automatizar tareas de gestión de inventarioPuedes pedirle a un agente que identifique artículos con poco stock en un punto de venta específico y que redacte órdenes de compra para los proveedores.
- 3Analizar el rendimiento de ventas minoristasUn desarrollador puede solicitar una comparación de los datos de ventas entre diferentes categorías de semanas anteriores.
- 4Gestionar datos de clientes y serviciosEl agente puede identificar a los mejores clientes y su historial de compras, o configurar servicios reservables para el personal.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Final POS MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Final POS MCP en Claude Code
$ claude mcp add --transport http final https://ai.finalpos.com/mcpInstalar Final POS MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"final": {
"url": "https://ai.finalpos.com/mcp"
}
}
}Instalar Final POS MCP en VS Code
.vscode/mcp.json
{
"servers": {
"final": {
"type": "http",
"url": "https://ai.finalpos.com/mcp"
}
}
}Instalar Final POS MCP en VS Code CLI
$ code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'Instalar Final POS MCP en Codex
$ codex mcp add final --url https://ai.finalpos.com/mcpInstalar Final POS MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.final] url = "https://ai.finalpos.com/mcp"
Instalar Final POS MCP en Gemini CLI
$ gemini mcp add -s user --transport http final https://ai.finalpos.com/mcpInstalar Final POS MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"final": {
"url": "https://ai.finalpos.com/mcp",
"type": "http"
}
}
}Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblefinal-commerce/final-pos-mcp is public and reachablegithub.com/final-commerce/final-pos-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-18github.com/final-commerce/final-pos-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 516 msAprobado
README
Ver en GitHubThe Final MCP server is the official Model Context Protocol server for
Final, the commerce platform for custom point of sale.
One remote endpoint, https://ai.finalpos.com/mcp, gives an AI agent access to
every Final product the merchant allows:
- Flow, the custom POS app builder: describe a checkout and the agent builds it from vetted screen blueprints, grounded in Final's version-locked POS APIs, then validates it, returns a live preview link and deploys it to payment terminals, tablets and kiosks. Counter POS, self-checkout, restaurant ordering, kitchen displays and in-person payment apps.
- Hub, the back office behind those apps: products and catalog, stock and purchase orders, orders, customers, sales reports, team and roles, outlets, taxes, bookings.
You sign in with your Final account (OAuth 2.1) and choose the company and what the agent may do. There is nothing to install or run locally.
| Endpoint | https://ai.finalpos.com/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 2.1 with PKCE (sign in with Final), or a fai_ connection key as Authorization: Bearer |
| Registry name | com.finalpos/final |
| Acts as | The person who connected it, on one company, within the packs they allowed |
| Cost | Free to connect; what the agent does follows your Final plan, as if you did it in Final |
Connect
Most clients only need the URL. They open a Final sign-in page where you pick the company and the packs, then they're connected.
Claude (claude.ai, Claude Desktop)
Settings → Connectors → Add custom connector, 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/mcp
Run /mcp in Claude Code and choose Authenticate. Or install the plugin,
which adds the server together with the Final playbook skill. Inside Claude
Code:
/plugin marketplace add Final-Commerce/final-pos-mcp
/plugin install final@final
Gemini CLI
gemini extensions install https://github.com/Final-Commerce/final-pos-mcp
The extension adds the server, the Final playbook and commands:
/final-pos:stock, /final-pos:sales, /final-pos:new, /final-pos:preview,
/final-pos:validate and /final-pos:deploy. Sign in once with
/mcp auth final inside Gemini CLI. To add only the server:
gemini mcp add --transport http final https://ai.finalpos.com/mcp
Cursor
Or in ~/.cursor/mcp.json:
{
"mcpServers": {
"final": { "url": "https://ai.finalpos.com/mcp" }
}
}
VS Code (GitHub Copilot)
Install in VS Code, or:
code --add-mcp '{"name":"final","type":"http","url":"https://ai.finalpos.com/mcp"}'
Codex, scripts and clients without OAuth
Create a connection key at ai.finalpos.com/connections.
It is shown once, and the page prints the exact snippet for each client. For
Codex, add this to ~/.codex/config.toml:
[mcp_servers.final]
url = "https://ai.finalpos.com/mcp"
http_headers = { "Authorization" = "Bearer fai_YOUR_KEY" }
Any other client: POST https://ai.finalpos.com/mcp with
Authorization: Bearer fai_YOUR_KEY.
Keys that start with
sk_(Flow) orfpm_(Hub) belong to those products' own servers and are not accepted here. Create afai_key instead, or use OAuth.
Check that it works
Ask your agent: "Use Final to tell me which company you're connected to and
which packs you can use." It calls get_connection and list_packs.
What your agent can do
Tools are grouped in packs. When you connect you choose which packs the
agent may use, and those are also the OAuth scopes. To keep the model's context
small, a connection lists only a few packs at a time. The core tools reach the
rest: find_tools searches every allowed pack, and call_tool calls any
allowed tool by name.
| Pack | Product | What it covers | Listed by default |
|---|---|---|---|
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, stock CSV import/export | |
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, record export | |
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 | Build and deploy Final POS apps: API grounding, blueprints, flow files, preview sandboxes, validation, deploy | ✓ |
build_data |
Flow | Custom tables (the app database), the secrets vault and Flow extensions |
Tool names carry their product: hub_get_products, hub_find_low_stock,
flow_create_flow, flow_deploy_flow. TOOLS.md lists every
tool, with its pack, whether it changes data, and its arguments.
Core tools (always listed): get_connection, list_packs, find_tools,
call_tool, enable_packs, disable_packs, switch_company.
Things to ask
Building custom POS apps (Flow)
- "Build a coffee-shop kiosk with a product grid, modifiers, a cart and card payments, then give me a preview link."
- "Add a tip screen to my counter app and validate it."
- "Create a self-checkout flow for a small grocery store with barcode scanning and a receipt screen."
- "Ship the latest version of my self-checkout flow."
An app build usually runs flow_get_scaffold → flow_create_flow →
flow_lookup_command_frame (grounding) → flow_get_blueprint →
flow_write_flow_files → flow_validate_flow → flow_start_preview, and
returns a live preview URL. Everything the agent builds also appears in the
Final builder, where every file write is a restorable checkpoint.
Running the store (Hub)
- "Which products are below their reorder point at the Main Street outlet? Draft a purchase order for the usual supplier."
- "Compare last week's sales by category with the week before."
- "Add these 40 products from the attached spreadsheet, with photos."
- "Who were my top ten customers this month, and what did they buy?"
- "Set up a 45-minute massage as a bookable service with two therapists."
Safety and permissions
- Your role still applies. Every Hub call runs as the person who connected, and Hub checks their live role on each call. Owner-only actions stay owner-only.
- Packs are the permission. The agent can only call tools in the packs you allowed. You can change packs or disconnect at any time at ai.finalpos.com/connections, and disconnecting revokes every token at once.
- Writes are labelled. Read tools carry
readOnlyHint, and deploys and deletes carrydestructiveHint, so clients can ask before acting. The server tells agents to confirm deploys, deletes and bulk changes with you. - Money stays on the till. Taking payments, refunding and voiding orders are not available over MCP.
- Secrets never pass through the model.
flow_request_secretasks you to enter an API key in the builder. - Everything is logged. The Connections page shows each connected client and every call it made, live.
- Flow limits: Flow allows 30 preview boots, 12 builds and deploys, and 300 file writes per hour.
Privacy and support
- What Final keeps. The connection (who made it, the company and the packs), the token it uses to reach Hub and Flow (encrypted), and a log of each tool call: the tool, the outcome, how long it took, and redacted previews of the arguments and result. You see that log on the Connections page.
- What Final doesn't see. Your conversation. MCP clients send tool calls, not the chat around them.
- Disconnecting deletes the stored token and revokes every token issued to that connection.
- Privacy policy · Terms
- Support: support@finalpos.com. For problems with this guide or the plugin, open an issue.
Flow's direct endpoint
Setups made before the gateway may still use https://flow.finalpos.com/api/mcp
with a Flow sk_ key (registry name com.finalpos.build/final-flows). It keeps
working, but new setups should use https://ai.finalpos.com/mcp, which includes
Flow.
FAQ
What is the Final MCP server?
It is the official MCP server for Final POS. One remote URL,
https://ai.finalpos.com/mcp, lets an AI assistant read and manage a
merchant's Final back office (Hub) and build point-of-sale apps (Flow).
Can ChatGPT or Claude manage my Final POS inventory?
Yes. Allow the inventory pack when you connect. The agent can check stock
levels, find low stock, suggest reorders, raise purchase orders and record
received goods.
Can an AI agent build a POS app on Final?
Yes. With the build pack the agent creates a flow, writes the app against
Final's version-locked APIs and vetted screen blueprints, validates it, and
returns a live preview URL. You launch it from the Final builder.
Do I need an API key?
No, if your client supports OAuth (Claude, ChatGPT, Claude Code, Cursor,
Gemini CLI, VS Code): just sign in with Final. Codex and scripts use a fai_
key from ai.finalpos.com/connections.
Which company does it act on?
The one you pick when you connect. If your account has several, the agent can
call switch_company.
Can the agent take payments or issue refunds?
No. Payments, refunds and voids happen on the till. Orders are read-only over MCP.
Why does my agent only see a few tools?
Clients put every listed tool into the model's context, and quality drops with
long lists. The agent finds the rest with find_tools, calls them with
call_tool, or lists a whole pack with enable_packs.
Is there a cost?
Connecting is free. What the agent does is billed like the same work done in Final yourself, under your Final plan.
Where are the Final POS API docs?
At finalpos.com/docs. An agent building an app
doesn't need them separately: the build pack grounds every call against
Final's version-locked APIs (flow_lookup_pos_api,
flow_lookup_command_frame).
About this repository
This repo holds the public setup guide, the MCP Registry entries
(server.json, legacy/), the Gemini CLI extension
(gemini-extension.json, GEMINI.md, commands/), the Claude Code and
Cursor plugin marketplaces (.claude-plugin/, .cursor-plugin/, and
plugins/final/, which both share) and the generated
tool reference with its machine-readable twin catalog.json,
which the server card at https://ai.finalpos.com/.well-known/mcp/server-card.json
also reads. GEMINI.md and the Claude skill are the same
playbook, and CI checks that they match. The server itself is hosted by Final;
no code from this repo runs on your machine.
License
Apache-2.0 © Final Commerce
Preguntas sobre Final POS MCP
¿Cómo agrego Final POS MCP a Claude Code?
Ejecuta claude mcp add --transport http final https://ai.finalpos.com/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Final POS MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué es el Final MCP server?
Es el MCP server oficial de Final POS que permite a un asistente de IA gestionar el back office (Hub) de un comercio y crear aplicaciones de punto de venta (Flow).
¿Pueden ChatGPT o Claude gestionar mi inventario de Final POS?
Sí, al permitir el pack de inventario durante la conexión, el agente puede consultar niveles de stock, detectar productos con poco inventario y gestionar órdenes de compra.
¿Puede un agente de IA crear una aplicación de POS en Final?
Sí, utilizando el pack de build, el agente puede crear un flow, escribir la aplicación basándose en blueprints validados, validarla y proporcionar una URL de vista previa en vivo.
¿Necesito una API key?
No si tu cliente soporta OAuth; simplemente puedes iniciar sesión con Final. Para clientes como Codex o scripts, se utiliza una fai_ connection key.