{
  "markdown": "# Chirak MCP Server\n\n[![Smithery](https://img.shields.io/badge/Smithery-ufhouck%2Fchirak-blue)](https://smithery.ai/servers/ufhouck/chirak)\n[![npm version](https://img.shields.io/npm/v/chirak-mcp.svg)](https://www.npmjs.com/package/chirak-mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.ufhouck%2Fchirak--mcp-purple)](https://registry.modelcontextprotocol.io)\n[![Glama](https://img.shields.io/badge/Glama-Chirak-emerald)](https://glama.ai/mcp/servers)\n\nA Model Context Protocol (MCP) server that connects AI clients (Claude Desktop, Cursor, Windsurf) to the Chirak Sales, Inventory, and Order Management API.\n\n## Overview\n\nThe 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.\n\n## Prerequisites\n\n- Node.js 18.0.0 or higher\n- A Chirak API key (generated from the Chirak iOS/iPadOS application under Settings > Integrations & AI)\n\n## Installation and Configuration\n\n### Smithery (Automatic Installation)\n\nTo install Chirak for Claude Desktop automatically using Smithery:\n\n```bash\nnpx -y smithery mcp add ufhouck/chirak\n```\n\n### Claude Desktop (Manual Configuration)\n\nAdd the following configuration to your `claude_desktop_config.json`:\n\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"chirak\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"chirak-mcp\"],\n      \"env\": {\n        \"CHIRAK_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor and Windsurf\n\nConfigure the MCP server within your editor's MCP settings:\n\n- **Command:** `npx`\n- **Arguments:** `-y chirak-mcp`\n- **Environment Variables:**\n  - `CHIRAK_API_KEY`: `your_api_key_here`\n\n### Smithery\n\nTo install via Smithery CLI:\n\n```bash\nnpx -y smithery mcp add ufhouck/chirak\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `CHIRAK_API_KEY` | Yes | Authentication key for Chirak Cloud API (`chk_live_...`). |\n| `CHIRAK_API_BASE_URL` | No | Target API endpoint (default: `https://chirak.app/api/v1`). |\n\n## Tools\n\n### Inventory and Products\n\n| Tool | Description |\n|---|---|\n| `get_products` | List and search inventory items with optional filters by category, stock level, or query string. |\n| `add_product` | Create a new product entry with SKU, name, prices, barcode, and initial stock. |\n| `update_stock` | Adjust inventory counts with specified movement type (inbound, outbound, audit, loss). |\n| `update_product` | Modify existing product attributes such as title, price, or category. |\n| `delete_product` | Remove an inventory item record. |\n\n### Sales and Orders\n\n| Tool | Description |\n|---|---|\n| `get_sales` | Retrieve recent orders and sales records filtered by date or status. |\n| `record_sale` | Create a sales transaction with line items, applied payment methods, and customer association. |\n| `cancel_sale` | Void a sales transaction and automatically return items to inventory. |\n| `get_daily_summary` | Retrieve daily aggregated metrics including total revenue, profit, transaction count, and top-selling products. |\n\n### Customer Management\n\n| Tool | Description |\n|---|---|\n| `get_customers` | Query customer records, outstanding balances, and purchase summaries. |\n| `add_customer` | Create a new customer profile. |\n| `update_customer` | Update contact information and customer notes. |\n| `delete_customer` | Remove a customer record. |\n\n## Development\n\nClone the repository and install dependencies:\n\n```bash\ngit clone https://github.com/ufhouck/chirak-mcp.git\ncd chirak-mcp\nnpm install\nnpm run build\n```\n\nTo run locally using STDIO:\n\n```bash\nexport CHIRAK_API_KEY=\"your_api_key_here\"\nnode dist/index.js\n```\n\n## Security\n\n- All API communications are conducted over TLS (HTTPS).\n- API credentials are authenticated server-side using SHA-256 hash matching.\n- Requests operate strictly within isolated tenant database partitions.\n\n## Privacy Policy\n \nChirak values developer and user privacy. When interacting with this MCP server:\n- All data transmission between AI clients and Chirak Cloud API is encrypted in transit using TLS.\n- Store database partitions are strictly multi-tenant isolated by tenant ID.\n- API keys are verified server-side using SHA-256 hashes and are never stored in plain text.\n- Full Privacy Policy documentation: [https://chirak.app/privacy](https://chirak.app/privacy)\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n\n",
  "bytes": 4626,
  "sha": "ddf9761995094cc169f2e44069024e23611b0fecb9e5e42fee270bbf20e84247",
  "repo_slug": "ufhouck/chirak-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ufhouck_chirak_mcp_1081aa3f/readme"
}