How to Connect ready2order to Gemini via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → ready2order, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

ready2order + Gemini

Connect the ready2order POS (Registrierkasse) to your AI: products, prices and stock, product groups, bills and daily sales, open orders, customers, payment methods and VAT rates, with confirmed writes for products, stock and customers.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

READY2ORDER_ACCOUNT_TOKEN

Step 1 — Get credentials

ready2order issues an Account Token per register account through a short approval flow. It takes about 10 minutes, once per account, and needs the account owner's login and a free developer registration.

1. Register as a developer at https://api.ready2order.com. ready2order e-mails you a Developer Token.
2. Request access with it:

   curl -X POST https://api.ready2order.com/v1/developerToken/grantAccessToken \
     -H "Authorization: Bearer <DEVELOPER_TOKEN>" -H "Content-Type: application/json" -d "{}"
   

   The answer holds grantAccessToken and grantAccessUri.
3. Open grantAccessUri within 10 minutes, sign in with the ready2order account owner and click Approve.
4. Read the Account Token:

   curl https://api.ready2order.com/v1/developerToken/grantAccessToken/<grantAccessToken> \
     -H "Authorization: Bearer <DEVELOPER_TOKEN>"
   

5. Paste accountToken from the answer into READY2ORDER_ACCOUNT_TOKEN and install the connector. The token is sent only to ready2order and stays valid until you revoke it in the ready2order admin under Settings → API access.

The Developer Token alone is refused with 403: the connector needs the Account Token.

What it covers: products with price, VAT, item number, barcode and stock, the stock levels with reorder level and safety stock, product groups, bills (Belege) with their lines, payments and VAT breakdown, a PDF link per bill, open orders per table, customers and customer groups, payment methods, VAT rates, the register's users, and whether a daily report (Tagesabschluss) is open.

Confirm first: writes change the live register at once, and a new product appears in the POS straight away. The AI names the product or customer and the new values and waits for your yes. It can create and edit products, book stock (an absolute count after an inventory, or a quantity added or removed, such as goods received or breakage), create product groups, and create and edit customers. ready2order_delete_product is switched off at install; to take a product out of sale, the AI sets it inactive instead.

Sales figures: ready2order_list_bills takes a date range. By default the dates follow the daily report a bill belongs to (the business day), or the bill's own timestamp if you ask. With the sold lines included, it gives sales per product. Bills are fiscal records: the connector cannot change or cancel them.

Rate limit: 60 requests a minute per Account Token; after a 429, wait a minute.

Common errors: 401 Sorry, but your token is invalid.: the token is wrong or was revoked; repeat the approval flow. 403: a Developer Token was pasted instead of the Account Token. 429: more than 60 requests in a minute. 400 or 422: a field is invalid and the message names it, for example a product without a VAT rate.

The connector does not create or cancel bills (Storno), print, or handle coupons, discounts, tables, payment terminals, webhooks or accounting exports.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart gemini.
3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell): anythingmcp should show as connected.
4. Start prompting: Gemini CLI can now call the ready2order tools.

Available tools

Example prompts

• "What were yesterday's total sales, and which 10 products sold best?"
• "Which products in the Drinks group are below their reorder level?"
• "We received 24 bottles of item number 1002: add them to the stock."
• "Raise the price of the Cappuccino to 4.20 and show me the change before you save it."
• "Get me the PDF of the last bill for Müller GmbH."

FAQ

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT