Chirak Mcp

io.github.ufhouckPublished by GitHub account ufhouckv1.1.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

A local MCP server that connects AI assistants to the Chirak sales, inventory and order API for lookups, transactions and business reporting.

What you can do
List, search, create, update and delete products, and adjust stock levels with movement types such as inbound, outbound, audit or loss. Retrieve sales and orders, record or cancel sales transactions, and pull daily summaries of revenue, profit and top sellers. Query, add, update and delete customer records, including balances and purchase summaries. List, fetch, create and delete invoices, receipts, return invoices and quotes, and render documents as printable thermal receipt text.
When to use it
Useful when a Chirak store owner or staff member wants to ask an assistant about stock, sales or customers, or have it record sales, issue invoices and adjust inventory from a chat client such as Claude Desktop, Cursor or Windsurf.
Requirements
Runs locally over stdio via the npm package chirak-mcp, requiring Node.js 18.0.0 or higher. A Chirak API key is required in the CHIRAK_API_KEY environment variable, generated in the Chirak iOS/iPadOS app under Integrations & AI. The optional CHIRAK_API_BASE_URL variable overrides the default Chirak Cloud API endpoint. Network access to the Chirak API is needed.
Before you install
The server holds a live Chirak API key (CHIRAK_API_KEY) that grants access to store data; keep it out of shared configuration files. Many tools write or delete data, including recording and cancelling sales, adjusting stock, and creating or permanently deleting products, customers and invoices. Business and customer data is sent to the Chirak Cloud API over TLS.

Installation

In SourceWeft

  1. Open Chirak Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

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:

bash
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
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:

bash
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:

bash
git clone https://github.com/ufhouck/chirak-mcp.gitcd chirak-mcpnpm installnpm run build

To run locally using STDIO:

bash
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.

Source: README.md at commit 4b7366b

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts