Give Claude & ChatGPT Direct Access to Your Shop
Query live stock counts, inspect daily gross margins, record Udharo collections, and update repair tickets directly from your favorite AI chatbot using granular scoped permissions.
Cloud & Local AI Support
Dual-transport architecture supports both modern Streamable HTTP / SSE for Claude Web & ChatGPT, and stdio for Claude Desktop and Cursor.
Granular Permission Scopes
Decide exactly what each AI assistant can do. Restrict a chatbot to read-only stock lookup, or grant permission to record incoming supplier shipments.
Tenant Isolation & Hashing
API keys (merp_live_...) are hashed with SHA-256 and strictly isolated to your shop ID. Cross-tenant leakage is impossible.
Connect in Under 2 Minutes
Choose your AI platform below for step-by-step instructions and ready-to-use configuration blocks.
Claude Web (claude.ai)
Connect Claude on the web directly to your Mobile खाता counter using Remote MCP over HTTPS or Cloudflare Tunnel.
Setup Instructions
- Generate a scoped API key in Mobile खाता under Settings → API & AI Integrations.
- If running locally, expose port 3000 using Cloudflare Tunnel: cloudflared tunnel --url http://localhost:3000
- In claude.ai, go to Settings → Connectors → Add custom connector (+).
- Name it 'Mobile खाता' and paste the Remote MCP URL with ?apiKey=merp_live_...
- Select 'No sign-in' (since authentication is securely provided via the API key) and click Add.
https://api-mobilekhata.nepalbivek.com.np/api/v1/mcp/sse?apiKey=merp_live_YOUR_SECRET_KEY_HERE8 Built-in Shop Operations Tools
Every tool is mapped directly to Mobile खाता business logic with full audit tracking.
get_shop_summaryFetches total collected revenue, COGS, gross margins, payment breakdown (Cash, eSewa, Khalti), and cleared debts for today, yesterday, this week, or this month.
search_inventoryFuzzy search products in your shop inventory with real-time stock levels, cost price, and optional low-stock threshold filtering.
record_stock_movementSafely receives incoming supplier stock, records damaged units, or adjusts counts via an immutable audit movement log without direct stock overwriting.
update_item_pricingUpdates default selling price or cost price in Nepali Rupees (Rs.) without altering past transaction or invoice snapshots.
list_outstanding_creditsLists all customers with unpaid credit balances, contact phone numbers, due dates, and automatic overdue urgency flags.
record_credit_paymentRecords full or partial repayments on a customer's Udharo balance, automatically updates debt remainder, and marks the account resolved when cleared.
list_active_repairsLists ongoing device repair jobs filtered by lifecycle status (waiting, diagnosing, repairing, ready, delivered).
update_repair_statusAdvances a repair ticket to a new status with technician notes, appending an audit event to the customer tracking timeline.
Granular Scopes Reference
Configure your API key with the least privilege needed for your workflow.
| Scope | Category | Description |
|---|---|---|
| analytics:read | Analytics Read | Access daily sales, gross margins, and revenue breakdown |
| inventory:read | Inventory Read | Fuzzy search products and inspect current stock counts |
| inventory:write | Inventory Write | Receive stock shipments, log damages, and adjust prices |
| credit:read | Credit Read | View unpaid customer debts and overdue due dates |
| credit:write | Credit Write | Record debt repayments and settlements |
| repairs:read | Repairs Read | Track device tickets and repair queue status |
| repairs:write | Repairs Write | Advance repair lifecycle and log technical progress |
Ready to automate your shop operations?
Generate your first scoped API key in Mobile खाता settings and connect your AI copilot today.