Offer PosMasr Cloud: the first year 20% off with the code · the licence at launch prices until 14 November See the offer →
← Blog

1-Click AI & MCP: Talk to your PosMasr shop from Claude, ChatGPT and Gemini

Shop owners in Egypt do not have time to dig through ten spreadsheets at midnight. With PosMasr's 1-Click MCP integration, you can download a ready .mcpb bundle for Claude Desktop, paste a single connector URL into ChatGPT or claude.ai, run one command in Gemini CLI, or drop SKILL.md into your assistant — and ask in Egyptian Arabic or English about today's sales, cashier voids, expiring stock and net margins.

A shop owner asking Claude, ChatGPT and Gemini about his PosMasr shop sales and stock

Why 1-Click AI changes daily shop work

Before today, connecting an AI assistant to a point-of-sale system meant editing JSON files, installing developer packages or exporting CSV files by hand. We replaced all of that with 1-Click MCP. The moment you create an AI key (aik_...) in Settings → AI access, PosMasr generates ready-to-click bundles and commands for every major AI tool.

Connecting AI to the shop

The 4 ready links & bundles you can use today

AI Assistant / Standard1-Click Path or FileHow it works
Claude Desktop (.mcpb)https://api.posmasr.com/mcp/bundle.mcpbDownload the .mcpb bundle (or your key-preconfigured bundle from Settings → AI access) and open it in Claude Desktop — zero config files.
ChatGPT & claude.ai Web/Phonehttps://api.posmasr.com/mcp/aik_...Paste your single connector URL into Settings → Connectors. Works immediately on web and mobile.
AI Skill Guide (SKILL.md)https://api.posmasr.com/mcp/skill.mdDrop skill.md into Claude Projects, ChatGPT Custom GPTs, or Gemini Gems so the AI knows all 19 read-only tools and retail formulas.
Auto-Discovery (mcp.json)https://api.posmasr.com/.well-known/mcp.jsonStandard MCP discovery manifest for Cursor, Gemini CLI, Windsurf and modern MCP clients.

What to ask in Egyptian Arabic or English

You do not need to memorize report names. Ask the way you talk to your shop manager or accountant:

  • Today's sales & branches: “How much did we sell today across branches, and how does it compare with last Tuesday?”
  • Cashier voids & drawer audit: “Show me today's receipts with discounts or voids and which cashier rang them up.”
  • Expiring & low stock: “What expires in the next 14 days, and which top-selling items are about to run out before Friday?”
  • Real profit & margin: “Which 10 products brought the highest net profit this month, and which ones have a squeezed margin?”

How SKILL.md teaches your AI every PosMasr tool

When you give an AI assistant the file at https://api.posmasr.com/mcp/skill.md, it learns the exact names and parameters of all 19 read-only tools (shop_summary, sales_report, compare_periods, top_products, profit, low_stock, stock_level, expiring, receipt, receipts_today, and more). Instead of guessing, it calls the right tool on the first try and explains the numbers clearly.

100% Read-Only by Design: It can look, never touch

Every MCP connection in PosMasr is strictly read-only. There is not a single write tool on the server — no AI can ring up a sale, refund a receipt, edit a price, open a drawer or delete a product. You control which ticks each key has (Reports, Stock, Products, Receipts; while Customers, Bookings and Team start off), you can lock a key to one branch or an expiry date, and revoking a key stops it in under a second.

AI key card with scoped permissions

Quick answers

Does PosMasr charge extra for 1-Click AI or MCP calls?
No. It is included in the Business and Chain plans (and in the 14-day free trial) with zero extra fee per question.

Where do I get the .mcpb bundle and SKILL.md?
Directly from Settings → AI access after creating your key, or from the public endpoints https://api.posmasr.com/mcp/bundle.mcpb and https://api.posmasr.com/mcp/skill.md.

Can I ask in Egyptian Arabic?
Yes — ask naturally in Egyptian Arabic or English and Claude, ChatGPT or Gemini will fetch the live figures from PosMasr and reply in the same language.

Connect Claude, ChatGPT or Gemini to your shop today

Start your 14-day free trial of PosMasr Online, create a read-only AI key in 30 seconds, and ask your first question.

First year 20% off every plan — with the code

Start the free trial — 30 days See the Connect your AI page

Help centre

Search by feature, screen or task. Open a guide and share its link with your team.

Help centre

Try PosMasr free for 14 days

Download, pick your products from the ready catalogue, plug in the printer and start selling today — no internet needed. Want the shop on any device instead? PosMasr Cloud runs online.