{"id":"com.finalpos/final","slug":"com-finalpos-final","title":"Final POS – Custom POS Builder","description":"Build custom POS apps with any AI agent: checkout flows, kiosks, payment terminals. Plus store ops.","version":"2.0.1","publisher":{"kind":"domain","id":"finalpos.com","label":"finalpos.com","url":"https://finalpos.com"},"website":"https://finalpos.com/mcp","repository":"https://github.com/Final-Commerce/final-pos-mcp","remotes":[{"type":"streamable-http","url":"https://ai.finalpos.com/mcp","headers":[{"description":"Optional. Clients with OAuth 2.1 sign in with Final and need no header. Otherwise: Bearer fai_... connection key from https://ai.finalpos.com/connections","isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-10-18","updated":"2026-10-18","status":"online","auth":"","latency_ms":955,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"get_connection","title":"About this connection","description":"Who this connection acts as: organisation, user, the company Hub tools act on and the companies you may switch to, the allowed and listed packs, and how to reach tools that are not listed.","read_only":true},{"name":"list_packs","title":"List packs","description":"Every tool pack with its product, description, tool count and whether it is allowed for this connection and listed right now.","read_only":true},{"name":"find_tools","title":"Find tools","description":"Search every allowed pack for tools by what you want to do (\"low stock\", \"create a product\", \"deploy the app\"). Returns matching tool names with their pack, whether they are listed and whether they change data. Run a read-only match with call_tool and a write with call_write_tool, or enable_packs to list its pack.","read_only":true},{"name":"call_tool","title":"Run a read-only tool","description":"Run a read-only tool from any allowed pack by its full name (for example hub_find_low_stock) without it being listed. Only tools that read are accepted; tools that change data run through call_write_tool. Arguments follow that tool's own input schema, which find_tools returns.","read_only":true},{"name":"call_write_tool","title":"Run a tool that changes data","description":"Run a tool that creates, changes, deletes, sends or deploys from any allowed pack by its full name (for example hub_update_product) without it being listed. Only tools find_tools marks as writes are accepted; read-only tools run through call_tool. Arguments follow that tool's own input schema, which find_tools returns.","read_only":false},{"name":"enable_packs","title":"List more packs","description":"Add packs to tools/list for this connection (remembered). Only allowed packs can be listed; the client refreshes its tool list.","read_only":false},{"name":"disable_packs","title":"List fewer packs","description":"Remove packs from tools/list for this connection to keep the list short. Tools stay reachable through call_tool and call_write_tool.","read_only":false},{"name":"ask_finai","title":"Ask Finai","description":"Hand a task in words to Finai, Final's own AI agent, and get its finished answer. It runs as this connection's user on its company, within the allowed packs, and uses Final's tools itself (looking records up, creating products, building or deploying an app). Use it for multi-step merchant jobs you would rather describe than orchestrate; call tools directly when you need the raw data. Pass conversa","read_only":false},{"name":"switch_company","title":"Switch company","description":"Choose the company Hub tools act on, by id or name (get_connection lists them). Remembered on this connection.","read_only":false},{"name":"flow_apply_blueprint_widgets","title":"Apply blueprint widgets into a flow","description":"COPY vetted blueprint widgets into a flow as real files — byte-exact, no transcription. Pass picks of { blueprintId, widgetId } (from list_blueprints / search_blueprints); the widget files land under src/widgets/<blueprint>/ with their command-frame plumbing intact, persisted as a restorable checkpoint + builder-chat note like write_flow_files. Returns a manifest (paths, export names, props, a rea","read_only":false},{"name":"flow_apply_upstream_update","title":"Apply an upstream update to a clone","description":"Apply the update reviewed with get_upstream_update. Pass resolutions: exactly one entry per conflict — { path, contents } with the COMPLETE merged file, or { path, delete: true } when the file should not exist. Missing, unknown or ambiguous entries fail the whole call with nothing written (the plan is recomputed here, so re-review if the flow changed since). What it does, in order: saves the curre","read_only":false},{"name":"flow_connect_chat","title":"Connect to an existing flow","description":"Attach this agent session to an EXISTING flow as a chat in the builder's rail (so the flow's owner sees your work alongside their own chats). Also use log_message to narrate what you're doing.","read_only":false},{"name":"flow_create_custom_table","title":"Create a custom data table","description":"Create a new custom data table (schema: name + typed columns) in your Final organization. USE THIS for any data the app must keep — loyalty stamps, waitlists, bookings, inventory logs, settings: the platform syncs the table to every station running the flow and keeps it working offline at the POS, so it replaces ANY browser-storage or hand-rolled persistence (localStorage/IndexedDB are forbidden a","read_only":false},{"name":"flow_create_flow","title":"Create a new flow","description":"Create a new, empty flow (app build) in your Final organization for YOU to write the app into. It appears in the Miami builder immediately, with this agent session attached as a chat. Optional theme knobs seed the live palette. Optional `device` (\"mobile\", \"kiosk\", \"iphone\", …) sets the preview frame it opens in; see set_flow_device. Returns the flow id and a builder deep link. Call get_scaffold b","read_only":false},{"name":"flow_create_flow_from_blueprint","title":"Start a new build by copying an FBB","description":"Create a NEW flow that starts as a complete, vetted application rather than an empty file tree — the fastest path to a working build when an FBB (a Final Business Blueprint: a whole app) matches what the user wants. For an app the user merely DESCRIBED, use start_build (the website's own start picks the FBB); this verb is for when the user asked YOU to copy one. Find one with search_blueprints({ k","read_only":false},{"name":"flow_delete_flow_files","title":"Delete files from a flow","description":"Remove files from a flow's tree by path. Engine-owned paths are rejected. Recorded as a checkpoint + chat note like writes.","read_only":false},{"name":"flow_deploy_flow","title":"Build and deploy a flow","description":"Direct deploy for CI/agent workflows: builds the app in a server sandbox (npm install + vite build) and publishes the dist to Final web-hosting as a new live version. Two things stop a deploy: a failing build, and a hardcoded credential (a build is distributable to other companies, so a baked-in secret would ship to all of them — use request_secret). Guardrail and type findings do NOT block; run v","read_only":false},{"name":"flow_get_blueprint","title":"Inspect one blueprint's code","description":"INSPECTION ONLY — read a blueprint's overlay code by id (from list_blueprints) to understand how it works. To USE a blueprint, apply it: apply_blueprint_widgets for a widget-set (materializes its widgets byte-exact with the command-frame plumbing intact AND provisions the custom tables its code depends on), create_flow_from_blueprint for an FBB. Do NOT re-type code from this tool into write_flow_f","read_only":true},{"name":"flow_get_preview_status","title":"Check preview health + logs","description":"Authoritative server-side health probe of the flow's preview sandbox, plus a short snapshot of recent dev-server logs (useful to diagnose a red screen or crash).","read_only":true},{"name":"flow_get_scaffold","title":"Get the app scaffold contract","description":"The contract every Final flow app is built against: which files the ENGINE owns (never write them — they are re-asserted verbatim), the baseline package.json (Vite + React 19 + TS + Tailwind + command-frame), the rules your files must follow, and the runtime contracts that compile and preview fine but fail on a real device (money in minor units, the first-load handshake, getX response unwrapping, ","read_only":true},{"name":"flow_get_upstream_status","title":"Check a clone for upstream updates","description":"Has the build this flow was copied from released a newer version? Covers both a \"Make it yours\" clone of a listing and a build started from an FBB. Returns update.status: \"available\" (a newer deployed release exists — review it with get_upstream_update), \"current\" (up to date), \"unknown\" (the original has no comparable release), or \"gone\" (the original was DELETED — for a share clone, also if it w","read_only":true},{"name":"flow_get_upstream_update","title":"Review a pending upstream update","description":"Review what an update from the original build would change — the same review the builder shows its maker, shaped for an agent. Returns the releases since the clone, the clean changes (added/changed/removed paths, with full incoming contents for added+changed), and CONFLICTS: files where this flow's own edits and the update collide, each with complete base/ours/theirs contents. RESOLUTION CONTRACT ","read_only":true},{"name":"flow_install_extension","title":"Install an extension org-wide","description":"Install an extension ORG-WIDE: creates the install link on EVERY company in your Final organization (demo companies included), skipping companies that already have it, so it is safe to retry. Installing is deliberate and org-visible — confirm with your user and call this ONLY when they explicitly asked for the extension. Find the id with list_extensions (organization and public extensions both ins","read_only":false},{"name":"flow_list_blueprints","title":"List the blueprint catalog","description":"List EVERY vetted, type-checked blueprint available to reuse — working functionality (gift cards, loyalty, payment surfaces, product grids, carts, customer views, order tickets, receipts), not just screen layouts. Check the catalog BEFORE creating custom tables or hand-rolling a capability. Returns id, kind, slot, title, summary, surfaces, tags, and selfPersisting per blueprint — selfPersisting: t","read_only":true},{"name":"flow_list_custom_tables","title":"List the org's custom data tables","description":"List your organization's custom data tables with their column schemas. Custom tables are Final's built-in, station-syncing database — data written on one station is automatically synced to every other station running the flow, and keeps working OFFLINE at the point of sale. They are the ONLY sanctioned persistence for generated apps (browser storage is per-device, never syncs, and is wiped on real","read_only":true},{"name":"flow_list_extension_custom_tables","title":"List an extension's custom tables","description":"List the CUSTOM TABLES an extension registers (table name + typed columns), so generated code can read/write its data at runtime via renderClient.getCustomTableData / upsertCustomTableData by table name (ground the calls with lookup_command_frame). Only the org's OWN extensions expose their tables — a public / other-org extension returns an empty list with a note. Pass the extension's id from list","read_only":true},{"name":"flow_list_extension_surfaces","title":"List an extension's surfaces","description":"List the SURFACES an extension exposes — embeddable iframe injection points, each with a surfaceId, a platform (builder/hub/render), a type, and a url. Render an installed surface inside a generated screen with the engine component `<ExtensionSurface surfaceId=\"<surfaceId>\" />` (ground it with lookup_engine_component). A surface may carry `requirementsMd` — full markdown build instructions for re-","read_only":true},{"name":"flow_list_extensions","title":"List available extensions","description":"List the platform EXTENSIONS available to your organization — the org's own plus the public marketplace — so you can suggest, inspect, or install one. Each entry carries an id, label, category, short description, and its source (organization or public); public results need no hub credential, and a note tells you when the org-owned side was unavailable. Pass query with the capability the user asked","read_only":true},{"name":"flow_list_flows","title":"List your flows","description":"List the flows (app builds) in your organization, newest first: id, title, timestamps, and live theme knobs. Final staff sessions also see Final's own flows, marked owner: \"Final\". Use a flow id with the other tools, or create_flow to start fresh. Clones of listed builds carry an upstreamUpdate field when the build they were copied from has released a newer version — review and apply it with get_u","read_only":true},{"name":"flow_list_secret_keys","title":"List stored secret key names","description":"List the key NAMES already stored in your organization's encrypted secrets vault — never the values (no tool returns a secret value). Use this to (a) reuse an existing key instead of requesting a new one, and (b) poll whether a request_secret ask has been fulfilled by the human. Generated code reads a secret at RUNTIME with renderClient.getSecretVal({ key }) — the build ships key names only.","read_only":true},{"name":"flow_log_message","title":"Log a message to the flow's chat","description":"Record a message in this agent's chat inside the builder — the user's request (role 'user') or your own progress/summary (role 'assistant'). Keeps the builder timeline faithful to what happened in this session.","read_only":false},{"name":"flow_lookup_command_frame","title":"Look up command-frame API","description":"Look up the EXACT, version-locked command-frame API a generated Final POS app runs on: renderClient method signatures + params, CF* entity field lists, pub/sub topic event vocabularies, and worked examples. Pass one of method/entity/topic for a precise lookup, entity+field to confirm a field exists, query for fuzzy search, or the plural batch forms. Ground every renderClient call in this before wr","read_only":true},{"name":"flow_lookup_engine_component","title":"Look up engine helper components","description":"Look up the exact props/signature of an engine-owned `./final/*` helper: the `@/final/ui` primitives (Button, IconButton, Card, Tile, Input, Field, Chip, ListRow, Dialog, Sheet, Toolbar, Heading, EmptyState, cn) plus usePrint, StationHomeButton, SwitchUserButton, useStationHome, Barcode, BootSplash. These are re-asserted into every generated app — compose screens from the primitives (see get_scaff","read_only":true},{"name":"flow_lookup_pos_api","title":"Look up Final POS REST API","description":"Look up the Final POS REST API (https://api.finalpos.com) — endpoint method/path, request fields, response shape, and a worked fetch example. This is the ONLINE-ONLY fallback for admin/management operations command-frame cannot express (creating products/variants/categories, customer management, outlets/stations/tax tables, webhooks). Command-frame is ALWAYS first choice for live POS data — it wor","read_only":true},{"name":"flow_open_in_builder","title":"Get the builder hand-off link","description":"The recommended way to finish: a deep link that opens this flow in the Miami builder, where the owner can review the work, restore checkpoints, and deploy through the Launch tool (validation gates, listing media, changelog, version history).","read_only":true},{"name":"flow_read_flow_files","title":"Read a flow's files","description":"Read a flow's generated source tree. Omit `paths` to list all file paths (cheap); pass `paths` to fetch specific files' contents.","read_only":true},{"name":"flow_rename_flow","title":"Rename a flow","description":"Rename a build (flow) authoritatively across the platform in one call: the builder header, list_flows / open_in_builder, and the Deerlake catalog all reflect the new title, and updatedAt is bumped. A deployed build keeps its hosted web app: the hostname and version history are unchanged, and the next deploy_flow publishes the next version. Does NOT edit the app source: rename a hardcoded old name ","read_only":false},{"name":"flow_request_secret","title":"Ask the human to store a secret","description":"Ask the flow's owner to enter a third-party credential (API key, auth token, webhook secret) into Final's encrypted vault. THIS TOOL TAKES NO VALUE and no tool ever returns one — the human types it into a masked input in the Miami builder, and it goes straight into the vault. Why: flow builds are DISTRIBUTABLE to other companies, so a credential must never be baked into the code (validate_flow and","read_only":false},{"name":"flow_search_blueprints","title":"Search the blueprint catalog","description":"SEMANTIC search over the vetted blueprint catalog — matches are ranked by what you MEAN, not by shared words, so describe the capability in plain language ('rewards for repeat customers' finds the loyalty blueprint). RUN THIS FIRST — before creating custom tables or hand-rolling a capability: blueprints ship working FUNCTIONALITY (gift cards, loyalty, payment surfaces, carts), not just screen layo","read_only":true},{"name":"flow_start_preview","title":"Start (or sync) the live preview","description":"Boot the flow's server-side preview sandbox (Vite dev server) — or reconcile a running one to the flow's current files — and return its public HTTPS URL already pinned to this flow's mock dataset: the maker's pick, else its vertical's (sushi, not restaurant). Open the URL in a browser to see the app; call again after write_flow_files to sync. Previews idle-stop on their own; call stop_preview when","read_only":false},{"name":"flow_stop_preview","title":"Stop the preview","description":"Stop the flow's preview sandbox and free its resources. The next start_preview cold-boots in a couple of seconds.","read_only":false},{"name":"flow_sync_preview","title":"Sync the preview to the flow's files","description":"Reconcile a (running or cold) preview sandbox to the flow's current files and run the green-build gate (tsc + vite build). Returns the gate result — the fastest way to know your code actually compiles. The engine forces parts of package.json on every sync: the dev/build/typecheck scripts, and the vendored command-frame + mock packages to their bundled tarballs. Baseline and build dependencies are ","read_only":false},{"name":"flow_update_custom_table","title":"Change a custom table's schema","description":"Evolve an EXISTING custom data table's schema: add columns, change existing ones (rename/retype — destructive for stored rows, use sparingly), or drop columns. The table is identified by its kebab-case name from list_custom_tables. Tables are ORG-WIDE, so a schema change lands for every flow and station already using this one — check who reads it before reshaping. NEVER rename or reshape a table a","read_only":false},{"name":"flow_validate_flow","title":"Validate a flow against the platform contract","description":"Deterministic STATIC checks against the platform contract: (1) guardrails — fabricated renderClient methods, forbidden browser APIs/imports, engine-file writes; (2) a REAL TypeScript check of command-frame usage against the PINNED .d.ts the app installs (the version is stamped in the result) — this proves TYPES, never runtime behaviour and never device parity; (3) a hardcoded-credentials scan; (4)","read_only":true},{"name":"flow_write_flow_files","title":"Write files into a flow","description":"Create or overwrite files in a flow's tree (full contents, not diffs). Engine-owned paths are rejected — see get_scaffold. Every write lands as a restorable checkpoint and is narrated in the builder chat. If a live preview is running, follow up with start_preview to sync it. Validate with validate_flow before deploying. If a call returns an error the files may STILL have landed (and a very large p","read_only":false},{"name":"hub_add_customer_note","title":"Add customer note","description":"Add a note to a customer — an allergy, a preference, what happened with an order. Existing notes are KEPT; this appends. Takes the customer ID from get_customers. Staff read these in the cabinet, so write what the merchant said, not your own summary.","read_only":false},{"name":"hub_add_modifier_choice","title":"Add a choice","description":"Add one choice to an existing modifier, leaving the rest alone. This is the safe way to extend a modifier — unlike update_modifier, it cannot drop anything. Appends to the end unless sortOrder says otherwise. price is the extra charge per unit as a human amount (\"0.70\"); omit it for a choice that costs nothing, which still prints on the receipt.","read_only":false},{"name":"hub_add_product_images","title":"Add product images","description":"Add photos to an existing product — from public URLs, or as base64 bytes when the merchant attached the file itself and there is no URL. URL images are downloaded and stored on the platform, so the product never depends on someone else's site staying up. Existing photos are KEPT — this adds to them. JPEG/PNG/WebP/GIF/HEIC, up to 20MB each. Takes the product ID from get_products, never a name.","read_only":false},{"name":"hub_add_tax_rate_to_group","title":"Add rate to group","description":"Add an EXISTING rate to a tax group, or change that rate’s compounding flag within the group. Both ids come from get_taxes. This shares the rate — it does not copy it. The group starts charging the rate’s existing per-outlet percentages, and a later edit to that rate changes this group too. Use create_tax_rate instead when the rate does not exist yet. The rate is appended last in the charging orde","read_only":false},{"name":"hub_adjust_stock","title":"Adjust stock","description":"Change the count of ONE variant at ONE outlet — the cabinet's \"Adjust Inventory\" action. CONFIRM WITH THE MERCHANT FIRST, repeating the product, the outlet, the reason and the number: this writes immediately, is permanently recorded against the employee in the stock history, and there is no undo from here. Reasons: STOCK_RECEIVED (a delivery arrived) and RESTOCK_RETURN (a return put back on the sh","read_only":false},{"name":"hub_assign_role","title":"Assign role","description":"Move a team member onto a different role — this is how someone gains or loses access. Answers 'give Maria access to the reports', 'make him a cashier again', 'take away her permissions'. PERMISSIONS ARE POWER. Confirm with the merchant first, naming the person and the role out loud (\"give Maria the Manager role — yes?\"), and never act on a role change you inferred rather than were asked for. The c","read_only":false},{"name":"hub_cancel_booking","title":"Cancel a booking","description":"Release a booked window. The order stays as it is — cancelling a booking is not a refund, and money is never moved here; if the customer is owed money, do that on the order. Confirm with the merchant before cancelling a booking somebody already paid for.","read_only":false},{"name":"hub_cancel_purchase_order","title":"Cancel purchase order","description":"Cancel an order the merchant no longer wants. CONFIRM FIRST, naming the supplier and the PO number — there is no undo, and the order disappears from the list rather than showing as cancelled. REFUSED once any stock has been received against it: that stock is real and the record has to stay. Receive the rest instead, or leave it partially received. Cancelling does NOT tell the supplier anything. If","read_only":false},{"name":"hub_confirm_booking","title":"Confirm a held booking","description":"Turn a hold into a real booking once the order behind it is paid, so it stops expiring. Needs the order the booking was sold on — confirming without one is refused, because a confirmed booking nobody can find on a receipt is worse than an expired hold.","read_only":false},{"name":"hub_create_booking_resource","title":"Create a booking resource","description":"Add one bookable thing to the company directory. Call get_booking_resources first — a resource is reused across every service, so a second \"Marco\" would split one barber into two calendars and let him be booked twice at once. The name is what staff will see in the calendar.","read_only":false},{"name":"hub_create_booking_rules","title":"Create a booking rule set","description":"Create a booking policy. Call get_booking_rules FIRST and reuse a matching set instead — these are shared company-wide, not per product. `weeklyHours` are LOCAL wall-clock times at the outlet; if neither the outlet nor the company has a timezone the engine refuses availability with a 400, so fix the outlet rather than guessing an offset. `bufferMinutes` consumes grid time for slot bookings (cleani","read_only":false},{"name":"hub_create_category","title":"Create category","description":"Create a product category. Call get_categories FIRST — a second \"Drinks\" is easy to make and there is no merge. Pass parentId to make it a subcategory; leave it out for a top-level one. The cabinet's own form asks for a description, so ask the merchant for one rather than inventing it. This does NOT move any product into the category — do that with update_product and its categoryIds.","read_only":false},{"name":"hub_create_customer","title":"Create customer","description":"Create a customer. Call get_customers with the email or name FIRST — a duplicate splits one person’s order history in two and there is no merge from here. Email is required, exactly as in the cabinet's own customer form. Ask the merchant for anything you do not know instead of inventing it — an invented phone number or address is worse than a missing one.","read_only":false},{"name":"hub_create_modifier","title":"Create modifier","description":"Create a new question the till can ask, with its choices. THIS ALONE DOES NOTHING AT THE TILL — follow it with link_modifier_to_category, or the modifier sits unused. Choose selectionType carefully, because it CANNOT be changed afterwards: \"single\" = pick exactly one (milk, cooking temperature); \"multiple\" = tick any number of different choices (toppings); \"multiple\" with allowQuantity true = tick","read_only":false},{"name":"hub_create_outlet","title":"Create outlet","description":"Open a new point of sale — the cabinet’s Add Outlet form. Name and the full street address (address, city, state, postCode) are all REQUIRED, exactly as on that form. Do NOT try to set a country: every outlet inherits the company’s country, and it can never be changed per outlet. Ask the merchant for any part of the address you do not know — an invented address ends up on receipts. This is BILLABL","read_only":false},{"name":"hub_create_product","title":"Create product","description":"Create a product in the merchant's catalogue. Call get_products first to make sure it does not already exist. Prices are HUMAN strings like \"19.99\" — this tool converts them into the company's currency itself, so never send cents. Tax: the company's standard tax table is applied by default; pass taxable:false for an untaxed product. Ask the merchant for anything you do not know instead of inventin","read_only":false},{"name":"hub_create_product_option","title":"Create product option","description":"Create a new variation axis with its possible values. Use it only when get_product_options shows nothing suitable. The axis is shared across the whole catalogue, not one product — so confirm the name and values with the merchant first and reuse an existing axis when one fits.","read_only":false},{"name":"hub_create_purchase_order","title":"Create purchase order","description":"Write a new order to a supplier. It is created as a DRAFT — nothing reaches the supplier and no stock moves until send_purchase_order. PREREQUISITES, in this order: get_suppliers for the supplierId, get_outlets for the outlet the goods will be delivered INTO, then get_supplier_items WITH that outletId for the lines — variantId and unitCost come from there, and an item that is not linked to this su","read_only":false},{"name":"hub_create_role","title":"Create role","description":"Create a new role with a chosen set of permissions — for when no existing role fits what the merchant wants someone to do. Check get_roles first; a near-match plus update_role is usually better than a fourth almost-identical role. PERMISSIONS ARE POWER. Confirm with the merchant first, naming the person and the role out loud (\"give Maria the Manager role — yes?\"), and never act on a role change yo","read_only":false},{"name":"hub_create_station","title":"Add virtual till","description":"Add a VIRTUAL till — a browser-based station, the cabinet’s \"Add Virtual Station\". It is created at one outlet and starts AVAILABLE. You CANNOT create a native (device) station from here and must not try: a physical till enrols itself when someone opens the POS app on the device and names it there. THIS IS BILLABLE — a new station counts against the company plan’s station allowance and the call is","read_only":false},{"name":"hub_create_stock_transfer","title":"Send stock transfer","description":"Move stock from one outlet to another — 'send 10 of these from the warehouse to the King Street shop'. CONFIRM WITH THE MERCHANT FIRST, naming both outlets and every quantity: this writes immediately and there is no undo from here. The stock LEAVES the source outlet at once; the destination only gains it when someone confirms arrival with receive_stock_transfer, so until then those units are in tr","read_only":false},{"name":"hub_create_supplier","title":"Create supplier","description":"Add a business the merchant buys from. Only the name is required, and it must be unique among this company’s suppliers. Set contactEmail if the merchant will ever email purchase orders to this supplier — send_purchase_order has nowhere to send without it. A brand-new supplier carries NO items, so it cannot be ordered from yet: link its items with link_supplier_items before creating a purchase orde","read_only":false},{"name":"hub_create_tax_group","title":"Create tax group","description":"Create an empty tax group (a tax profile that products get assigned to, e.g. \"Standard\", \"Food\", \"Zero-rated\"). Call get_taxes FIRST — a second group with the same meaning splits the catalogue and is a common way to end up charging two different taxes for one thing. The group charges nothing until you add rates with create_tax_rate or add_tax_rate_to_group, and no product uses it until someone ass","read_only":false},{"name":"hub_create_tax_rate","title":"Create tax rate","description":"Create a named tax rate (\"State Sales Tax\", \"GST\") with its percentage, and optionally put it straight into a tax group. Check get_taxes first: if a rate with this meaning already exists, add_tax_rate_to_group reuses it, which is almost always what the merchant wants — duplicating a rate means the next change has to be made twice and one of them gets forgotten. Give either percentage (the same at ","read_only":false},{"name":"hub_create_user","title":"Create POS user","description":"Add a POS user — someone who signs in at the till with a PIN. Mirrors the cabinet’s \"New POS user\" form: first and last name, a 4-6 digit PIN, a role, optionally a phone. They get access to every outlet of the company, which update_user can narrow afterwards. BACK-OFFICE (Hub) users are NOT created here: those are invited by email from the cabinet, and that invitation flow is not available through","read_only":false},{"name":"hub_delete_category","title":"Delete category","description":"Delete a category. Takes the category id ONLY — look it up with get_categories and never guess. CONFIRM WITH THE MERCHANT BEFORE CALLING, naming the category: there is no undo from here. Products in the category are NOT deleted — they are kept and simply lose this category, so a product that had no other category ends up uncategorised. A category that still has subcategories is refused: move or de","read_only":false},{"name":"hub_delete_customer","title":"Delete customer","description":"Remove a customer from the merchant's list. Takes the customer ID ONLY — look it up with get_customers and never guess. CONFIRM WITH THE MERCHANT BEFORE CALLING, naming the customer: there is no undo from here. Their past orders are kept. If several customers match, list them and ask which one instead of picking.","read_only":false},{"name":"hub_delete_media_file","title":"Delete media file","description":"Permanently delete one file from the media library. Takes the file ID from get_media_library ONLY — never guess it. CONFIRM WITH THE MERCHANT BEFORE CALLING, naming the file: the image is destroyed and there is NO UNDO. Tell them this too, because the platform does not check it and nothing is cleaned up afterwards: if any product or category uses this image, it KEEPS the dead URL and its picture t","read_only":false},{"name":"hub_delete_modifier","title":"Delete modifier","description":"Remove a modifier from the catalogue AND detach it from every category at once — the till stops asking it everywhere. Check get_modifier first and tell the merchant which categories lose it. To stop asking it in ONE place only, use unlink_modifier_from_category. Past orders keep the options that were already rung up.","read_only":false},{"name":"hub_delete_modifier_choice","title":"Delete a choice","description":"Remove one choice from a modifier. Refused when it would leave a category asking for more choices than remain — the explanation names the category.","read_only":false},{"name":"hub_delete_outlet","title":"Delete outlet","description":"Close a point of sale permanently. Takes the outlet id from get_outlets. CONFIRM WITH THE MERCHANT FIRST, naming the outlet — there is NO undo from here. Tell them what goes with it: the stock recorded AT that outlet is removed and is NOT moved anywhere else (transfer it out first if they want to keep it), and so are the outlet’s tax rate values and its per-outlet product visibility. Past orders, ","read_only":false},{"name":"hub_delete_product","title":"Delete product","description":"Remove a product from the merchant's catalogue. Takes the product ID ONLY — look it up with get_products and never guess. CONFIRM WITH THE MERCHANT BEFORE CALLING, naming the product: this also removes all of its variants and there is no undo. If several products match, list them and ask which one instead of picking.","read_only":false},{"name":"hub_delete_role","title":"Delete role","description":"Delete a role the merchant no longer uses. Takes the roleId from get_roles. CONFIRM FIRST, naming the role — there is no undo. A role that anyone still holds cannot be deleted: the server refuses and tells you how many people are on it. Move them with assign_role first, and check with the merchant which role they should land on — that move changes what those people can do. You cannot delete the ro","read_only":false},{"name":"hub_delete_station","title":"Delete till","description":"Remove a till from Run → Stations. Takes the station id from get_stations. CONFIRM WITH THE MERCHANT FIRST, naming the station — there is NO undo from here, and it takes a working register out of service: the device that used it has to be set up again in the POS app, and it comes back as a NEW station with a new id. A station reporting IN_USE is REFUSED, exactly as the cabinet greys the button out","read_only":false},{"name":"hub_delete_supplier","title":"Delete supplier","description":"Remove a supplier the merchant no longer buys from. CONFIRM WITH THE MERCHANT FIRST, naming the supplier — there is no undo from here. Its item links go with it, so any auto-reorder rule pointing at this supplier stops producing suggestions. REFUSED while the supplier still has an open purchase order (anything not fully received): receive or cancel those first — get_purchase_orders filtered by thi","read_only":false}],"server_info":{"name":"final","title":"Final","version":"2.0.0","description":"One MCP server for every Final product: the Hub back office (catalog, stock, purchase orders, orders, customers, reports, team, bookings) and Flow (build, preview and deploy point-of-sale apps).","websiteUrl":"https://finalpos.com/mcp","icons":[{"src":"https://ai.finalpos.com/icons/icon-512.png","mimeType":"image/png","sizes":["512x512"]}]},"category":"ecommerce","tags":["finance","productivity","agents"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-17","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-finalpos-final/"}