English Français العربية

io.github.ufhouck/chirak-mcp

Official registry E-commerce

Model Context Protocol (MCP) Server for Chirak Sales & Inventory Assistant

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package chirak-mcp
Claude Code 
claude mcp add chirak-mcp -e 'CHIRAK_API_KEY=<your chirak_api_key>' -e 'CHIRAK_API_BASE_URL=<CHIRAK_API_BASE_URL>' -- npx -y chirak-mcp@1.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "chirak-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "chirak-mcp@1.1.2"
            ],
            "env": {
                "CHIRAK_API_KEY": "<your chirak_api_key>",
                "CHIRAK_API_BASE_URL": "<CHIRAK_API_BASE_URL>"
            }
        }
    }
}

Environment variables

  • CHIRAK_API_KEY required secret Your Chirak API Key starting with chk_live_ (generated from Chirak App -> More -> Integrations & AI)
  • CHIRAK_API_BASE_URL Chirak Cloud API Endpoint (optional, defaults to https://chirak.app/api/v1)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Chirak MCP Server
  2. Overview
  3. Prerequisites
  4. Installation and Configuration
  5. Environment Variables
  6. Tools
  7. Development
  8. Security
  9. Privacy Policy
  10. License

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.

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

VariableRequiredDescription
CHIRAK_API_KEYYesAuthentication key for Chirak Cloud API (chk_live_...).
CHIRAK_API_BASE_URLNoTarget API endpoint (default: https://chirak.app/api/v1).

Tools

Inventory and Products
ToolDescription
get_productsList and search inventory items with optional filters by category, stock level, or query string.
add_productCreate a new product entry with SKU, name, prices, barcode, and initial stock.
update_stockAdjust inventory counts with specified movement type (inbound, outbound, audit, loss).
update_productModify existing product attributes such as title, price, or category.
delete_productRemove an inventory item record.
Sales and Orders
ToolDescription
get_salesRetrieve recent orders and sales records filtered by date or status.
record_saleCreate a sales transaction with line items, applied payment methods, and customer association.
cancel_saleVoid a sales transaction and automatically return items to inventory.
get_daily_summaryRetrieve daily aggregated metrics including total revenue, profit, transaction count, and top-selling products.
Customer Management
ToolDescription
get_customersQuery customer records, outstanding balances, and purchase summaries.
add_customerCreate a new customer profile.
update_customerUpdate contact information and customer notes.
delete_customerRemove a customer record.
Documents & Invoices (Billing)
ToolDescription
list_documentsRetrieve invoices, receipts, return invoices, and quotes with type/status filters.
get_documentFetch full itemized document details, customer details, and tax/VAT calculations.
create_documentCreate and issue formal invoices, sales receipts, or quotes with line items.
delete_documentPermanently remove an invoice or receipt record.
export_document_textRender 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.

Frequently asked questions

What is io.github.ufhouck/chirak-mcp?

Model Context Protocol (MCP) Server for Chirak Sales & Inventory Assistant

How do I install io.github.ufhouck/chirak-mcp?

It runs on your machine. In Claude Code: claude mcp add chirak-mcp -e 'CHIRAK_API_KEY=<your chirak_api_key>' -e 'CHIRAK_API_BASE_URL=<CHIRAK_API_BASE_URL>' -- npx -y chirak-mcp@1.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ufhouck/chirak-mcp need an API key?

Yes. It expects CHIRAK_API_KEY, which you set in its configuration.

Is io.github.ufhouck/chirak-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.ufhouck/chirak-mcp?

It is published by ufhouck. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.