Skip to main content
Glama

Chirak MCP Server

Smithery npm version MCP Registry Glama

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/chirak

Claude Desktop (Manual Configuration)

Add the following configuration to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %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: npx

  • Arguments: -y chirak-mcp

  • Environment Variables:

    • CHIRAK_API_KEY: your_api_key_here

Smithery

To install via Smithery CLI:

npx -y smithery mcp add ufhouck/chirak

Environment Variables

Variable

Required

Description

CHIRAK_API_KEY

Yes

Authentication key for Chirak Cloud API (chk_live_...).

CHIRAK_API_BASE_URL

No

Target API endpoint (default: https://chirak.app/api/v1).

Tools

Inventory and Products

Tool

Description

get_products

List and search inventory items with optional filters by category, stock level, or query string.

add_product

Create a new product entry with SKU, name, prices, barcode, and initial stock.

update_stock

Adjust inventory counts with specified movement type (inbound, outbound, audit, loss).

update_product

Modify existing product attributes such as title, price, or category.

delete_product

Remove an inventory item record.

Sales and Orders

Tool

Description

get_sales

Retrieve recent orders and sales records filtered by date or status.

record_sale

Create a sales transaction with line items, applied payment methods, and customer association.

cancel_sale

Void a sales transaction and automatically return items to inventory.

get_daily_summary

Retrieve daily aggregated metrics including total revenue, profit, transaction count, and top-selling products.

Customer Management

Tool

Description

get_customers

Query customer records, outstanding balances, and purchase summaries.

add_customer

Create a new customer profile.

update_customer

Update contact information and customer notes.

delete_customer

Remove a customer record.

Documents & Invoices (Billing)

Tool

Description

list_documents

Retrieve invoices, receipts, return invoices, and quotes with type/status filters.

get_document

Fetch full itemized document details, customer details, and tax/VAT calculations.

create_document

Create and issue formal invoices, sales receipts, or quotes with line items.

delete_document

Permanently remove an invoice or receipt record.

export_document_text

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 build

To run locally using STDIO:

export CHIRAK_API_KEY="your_api_key_here"
node dist/index.js

Security

  • 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 tools
add_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_saleA
Idempotent

Cancel a sale order and automatically restore the ordered item quantities back into the physical store inventory.

Inputs: id (required). Returns: data, success

delete_customerA
Destructive

Delete a customer from the Chirak store directory.

Inputs: id (required). Returns: data, success

delete_productA
Destructive

Permanently delete or remove a product from the Chirak inventory catalog.

Inputs: id (required). Returns: data, success

get_chirak_helpA
Read-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_inventoryB
Read-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_reportA
Read-only

Retrieve a summary report of revenue, total sales orders, units sold, and low-stock alerts.

Inputs: period. Returns: data, success

helpA
Read-only

Quick operational guide and cheat-sheet for Chirak store capabilities, active metrics, and recommended prompts.

Inputs: topic. Returns: data, success

list_customersA
Read-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_productA
Read-only

Search for products in Chirak by name, SKU code, or barcode.

Inputs: query (required). Returns: data, success

update_customerB
Idempotent

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_productA
Idempotent

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

    A3.6/5.0

    Scored across 15 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI assistants to manage consignment and retail business operations through the ConsignCloud API, including inventory management, sales tracking, vendor accounts, and analytics.
      26
      1
      GPL 3.0
    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      13
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with SalesDrive CRM, allowing order management, product queries, and more through natural language.
      1
      Apache 2.0