Connect your tools and AI agents
Everything in myposlab is available through a documented API. Owners on the Pro plan can create API keys and connect AI agents through MCP.
REST API
- Interactive docs: https://posbackend.ideus.lk/api/docs
- OpenAPI 3 spec: https://posbackend.ideus.lk/openapi.json
- Public pricing (no auth): https://posbackend.ideus.lk/api/v1/public/plans
Authentication
Send Authorization: Bearer <token>. User tokens come from POST /api/v1/auth/login and need an X-Business-Id header. Business API keys start with mpl_, are created by the shop owner under API & agents in the app, and are already scoped to one business. A key can never manage billing, the team or other keys.
MCP server for AI agents
Point any MCP-capable agent (Claude, ChatGPT connectors, Cursor and others) at https://posbackend.ideus.lk/mcp with your API key as a Bearer token. The MCP tools are read-only:
get_business_overview: shops, today’s sales, money owed, low stockget_sales_summary: revenue, gross profit, bills, by day, hour, payment method and cashierget_product_sales: best sellers, most profitable and slow moversget_stock: stock on hand, low stock and stock valueget_reorder_suggestions: what to buy, grouped by supplierget_expiring_stock: batches that will expire before they sellget_customer_creditandfind_customer: the credit book, loyalty points and visitsget_suppliers_and_cheques: supplier balances and cheques coming due
Claude Code: claude mcp add --transport http myposlab https://posbackend.ideus.lk/mcp --header "Authorization: Bearer mpl_…"
For crawlers and assistants
A plain-text summary of this site for language models is at /llms.txt.