{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_zazxamqfaqcn","handle":"clariq-mcp","url":"https://wellknown.network/agents/clariq-mcp","links":{"self":"https://wellknown.network/agents/clariq-mcp/record.json","html":"https://wellknown.network/agents/clariq-mcp","markdown":"https://wellknown.network/agents/clariq-mcp/record.md","api":"https://wellknown.network/api/v1/agents/clariq-mcp","status":"https://wellknown.network/api/v1/agents/clariq-mcp/status","claim":"https://wellknown.network/agents/clariq-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/clariq-mcp/claim.json","badge":"https://wellknown.network/agents/clariq-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/clariq-mcp/history","tools":"https://wellknown.network/api/v1/agents/clariq-mcp/tools"},"ard":{"identifier":"urn:air::server:clariq-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"clariq-mcp","summary":"Model Context Protocol (MCP) server that connects WooCommerce store analytics to AI assistants.","description":"# Clariq MCP Server\n\n**Talk to your WooCommerce store.** This MCP server connects AI assistants\n(Claude Desktop and any MCP-compatible client) to your store's analytics —\nsales performance, product margins, customer retention, and more.\n\nSelf-hosted and free: in **local bridge mode** your store data never leaves\nyour own infrastructure. No account, no quota, no lock-in.\n\n[![License: AGPL v3](https://img.shields.io/badge/License-AGPL_v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0.html)\n[![Python](https://img.shields.io/badge/python-3.11%2B-blue)]()\n\n---\n\n## How it works\n\n```\nClaude Desktop ──(stdio)──> clariq-mcp ──(HMAC-signed HTTPS)──> your WordPress site\n   (your machine)            (your machine)                     (Clariq plugin + WooCommerce DB)\n```\n\n- The MCP server runs on **your machine** as a local stdio process — it is\n  never exposed to the internet.\n- The [Clariq WooCommerce plugin](https://github.com/clariqapp/plugin)\n  exposes two HMAC-authenticated REST endpoints (`/wp-json/mcp-bridge/v1/*`)\n  and computes analytics against your **own** database on request.\n- Result: ask Claude *\"How did sales do this month?\"* and get real numbers —\n  without shipping your order data anywhere.\n\n## Quickstart (5 minutes)\n\n### 1. Install the WordPress plugin\n\nInstall the Clariq plugin on your WooCommerce store\n([releases](https://github.com/clariqapp/plugin)), then in **wp-admin →\nClariq settings** choose **Local Bridge** mode. Copy the bridge secret shown\nthere.\n\n### 2. Install the MCP server\n\nRequires Python 3.11+. Either run it directly with\n[uv](https://docs.astral.sh/uv/):\n\n```bash\nuvx clariq-mcp\n```\n\nor install it with pipx/pip:\n\n```bash\npipx install clariq-mcp   # or: pip install clariq-mcp\n```\n\n### 3. Add it to Claude Desktop\n\nEdit `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"clariq\": {\n      \"command\": \"clariq-mcp\",\n      \"env\": {\n        \"CLARIQ_WP_URL\": \"https://your-store.com\",\n        \"CLARIQ_BRIDGE_SECRET\": \"your-bridge-secret\"\n  …","publisher":{"name":"Clariq","url":null},"homepage":"https://github.com/clariqapp/mcp-server","repository":"https://github.com/clariqapp/mcp-server","version":"1.1.1","license":null,"protocols":["mcp"],"tags":["woocommerce","mcp","model-context-protocol","analytics","ecommerce"],"pricing":null,"endpoints":[{"url":"pypi:clariq-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":1,"provenance":"declared"}],"categories":["commerce"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"clariq-mcp","registry":"pypi","observedAt":"2026-11-09T01:27:39.295Z","publishedAt":"2026-09-22T17:20:20.506599Z","latestVersion":"1.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"clariq-mcp","url":"https://pypi.org/project/clariq-mcp/","firstSeenAt":"2026-09-15T11:21:51.185Z","fetchedAt":"2026-11-09T01:26:56.083Z","normalizedAt":"2026-11-09T01:26:56.083Z"}]},"firstSeenAt":"2026-09-15T11:21:51.185Z","updatedAt":"2026-11-09T01:27:39.295Z"}