chirak-mcp
This server connects AI assistants to the Chirak sales, inventory, and order management API, enabling real-time management of products, sales, customers, and reports.
Inventory & Products: List, search, add, update, adjust stock, and delete products with fields like SKU, barcode, pricing, and stock thresholds.
Sales & Orders: Record sales with line items, cancel sales (auto-restock), and get sales reports by period (today, week, month).
Customers: List, add, update, and delete customer profiles with contact info, social handles, and notes.
Help & Guidance: Access built-in help and operational cheat-sheets for using the server effectively.
Stock Control: Adjust stock quantities with reasons (purchase, damage, return, etc.) and view low-stock alerts.
Reporting: Retrieve daily summaries, revenue, units sold, and low-stock indicators.
Integration: Works with Claude Desktop, Cursor, Windsurf via MCP over STDIO, using a Chirak API key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@chirak-mcp Show me today's sales summary and top products."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Chirak MCP Server
A Model Context Protocol (MCP) server that connects AI clients (Claude Desktop, Cursor, Windsurf) to the Chirak Sales, Inventory, and Order Management API.
Overview
The Chirak MCP server enables Large Language Model (LLM) interfaces to perform real-time inventory lookups, record sales transactions, manage product records, and query business analytics via standard Model Context Protocol tooling over STDIO.
Related MCP server: Shopify MCP Server
Prerequisites
Node.js 18.0.0 or higher
A Chirak API key (generated from the Chirak iOS/iPadOS application under Settings > Integrations & AI)
Installation and Configuration
Smithery (Automatic Installation)
To install Chirak for Claude Desktop automatically using Smithery:
npx -y smithery mcp add ufhouck/chirakClaude Desktop (Manual Configuration)
Add the following configuration to your claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"chirak": {
"command": "npx",
"args": ["-y", "chirak-mcp"],
"env": {
"CHIRAK_API_KEY": "your_api_key_here"
}
}
}
}Cursor and Windsurf
Configure the MCP server within your editor's MCP settings:
Command:
npxArguments:
-y chirak-mcpEnvironment Variables:
CHIRAK_API_KEY:your_api_key_here
Smithery
To install via Smithery CLI:
npx -y smithery mcp add ufhouck/chirakEnvironment Variables
Variable | Required | Description |
| Yes | Authentication key for Chirak Cloud API ( |
| No | Target API endpoint (default: |
Tools
Inventory and Products
Tool | Description |
| List and search inventory items with optional filters by category, stock level, or query string. |
| Create a new product entry with SKU, name, prices, barcode, and initial stock. |
| Adjust inventory counts with specified movement type (inbound, outbound, audit, loss). |
| Modify existing product attributes such as title, price, or category. |
| Remove an inventory item record. |
Sales and Orders
Tool | Description |
| Retrieve recent orders and sales records filtered by date or status. |
| Create a sales transaction with line items, applied payment methods, and customer association. |
| Void a sales transaction and automatically return items to inventory. |
| Retrieve daily aggregated metrics including total revenue, profit, transaction count, and top-selling products. |
Customer Management
Tool | Description |
| Query customer records, outstanding balances, and purchase summaries. |
| Create a new customer profile. |
| Update contact information and customer notes. |
| Remove a customer record. |
Documents & Invoices (Billing)
Tool | Description |
| Retrieve invoices, receipts, return invoices, and quotes with type/status filters. |
| Fetch full itemized document details, customer details, and tax/VAT calculations. |
| Create and issue formal invoices, sales receipts, or quotes with line items. |
| Permanently remove an invoice or receipt record. |
| Render formatted ASCII thermal receipt / ticket layout suitable for printing or chat display. |
Development
Clone the repository and install dependencies:
git clone https://github.com/ufhouck/chirak-mcp.git
cd chirak-mcp
npm install
npm run buildTo run locally using STDIO:
export CHIRAK_API_KEY="your_api_key_here"
node dist/index.jsSecurity
All API communications are conducted over TLS (HTTPS).
API credentials are authenticated server-side using SHA-256 hash matching.
Requests operate strictly within isolated tenant database partitions.
Privacy Policy
Chirak values developer and user privacy. When interacting with this MCP server:
All data transmission between AI clients and Chirak Cloud API is encrypted in transit using TLS.
Store database partitions are strictly multi-tenant isolated by tenant ID.
API keys are verified server-side using SHA-256 hashes and are never stored in plain text.
Full Privacy Policy documentation: https://chirak.app/privacy
License
MIT License. See LICENSE for details.
Available Tools
15 toolsadd_customerA
Add a new customer to the Chirak store contacts directory.
Inputs: name (required), email, notes, phone, +3 more. Returns: data, success
add_productA
Add a new product to Chirak inventory. Use this when the user asks to add items, parse wholesale invoices, or register products.
Inputs: name (required), sellingPrice (required), sku, unit, +6 more. Returns: data, success
adjust_stockA
Adjust physical stock quantity for a product (+/- change) with an audit reason (e.g. 'purchase', 'damage', 'adjustment', 'return'). Automatically records a stock movement.
Inputs: id (required), quantityChange (required), note, reason. Returns: data, success
cancel_saleAIdempotent
Cancel a sale order and automatically restore the ordered item quantities back into the physical store inventory.
Inputs: id (required). Returns: data, success
delete_customerADestructive
Delete a customer from the Chirak store directory.
Inputs: id (required). Returns: data, success
delete_productADestructive
Permanently delete or remove a product from the Chirak inventory catalog.
Inputs: id (required). Returns: data, success
get_chirak_helpARead-only
Returns a complete operational guide to Chirak store capabilities, operational cheat-sheet, active store context, and example AI prompt patterns. Call this whenever the user or agent needs help, guidance, or wants to explore store features.
Inputs: topic. Returns: data, success
get_inventoryBRead-only
Fetch current inventory products from Chirak, with options to filter by category or find critical low stock items.
Inputs: limit, category, low_stock_only. Returns: data, success
get_sales_reportARead-only
Retrieve a summary report of revenue, total sales orders, units sold, and low-stock alerts.
Inputs: period. Returns: data, success
helpARead-only
Quick operational guide and cheat-sheet for Chirak store capabilities, active metrics, and recommended prompts.
Inputs: topic. Returns: data, success
list_customersARead-only
Retrieve customer contact directory and their lifetime spending metrics from Chirak.
Inputs: limit, search. Returns: data, success
record_saleA
Record a sale order and automatically deduct the corresponding product stocks in Chirak.
Inputs: items (required), notes, channel, customerName, +2 more. Returns: data, success
search_productARead-only
Search for products in Chirak by name, SKU code, or barcode.
Inputs: query (required). Returns: data, success
update_customerBIdempotent
Update contact details, delivery address, or notes of an existing customer in Chirak.
Inputs: id (required), name, email, notes, +4 more. Returns: data, success
update_productAIdempotent
Update details of an existing product in Chirak, such as selling price, cost, physical stock quantity, name, category, SKU, or barcode.
Inputs: id (required), sku, name, unit, +6 more. Returns: data, success
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Most tools target distinct resource-action pairs, but help and get_chirak_help are near-duplicates, and update_product's ability to set stock quantity overlaps with adjust_stock's purpose. These overlapping boundaries create some selection ambiguity for agents.
The vast majority of tools follow a clear verb_noun pattern like add_product, delete_customer, and get_inventory. The single bare 'help' tool deviates from the otherwise consistent naming style, preventing a perfect score.
15 tools is at the upper edge of the well-scoped range and the coverage maps cleanly to inventory, sales, and customer workflows. The duplicated help tools add unnecessary surface area, making the count slightly less tight than it could be.
The tool set covers full CRUD for products and customers, plus sales recording/cancellation, stock adjustments, and reporting. The core store operations an agent would need are all present with no obvious dead ends.
Maintenance
Related MCP Connectors
Connect AI to store orders, products and inventory with scoped access and human approvals.
Post to social media, run Google Ads, manage Shopify, inventory and phone calls from your AI.
Connect AI assistants to Appimate's Business Agent Tools and Services.
AI shopping gateway for product search, inventory, carts, and merchant-hosted checkout.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to manage consignment and retail business operations through the ConsignCloud API, including inventory management, sales tracking, vendor accounts, and analytics.261GPL 3.0
- AlicenseAqualityDmaintenanceProvides AI assistants with real-time access to Shopify store analytics, sales data, and inventory through ShopifyQL and the Admin GraphQL API. It enables users to query store performance, customer metrics, and marketing insights using natural language.13MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage business operations including invoicing, WooCommerce syncing, expense tracking, POS, inventory, and team management through natural language.12 npm2MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with SalesDrive CRM, allowing order management, product queries, and more through natural language.1Apache 2.0