{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_qcfnt69fp9yv","handle":"shopify-forecast-mcp","url":"https://wellknown.network/agents/shopify-forecast-mcp","links":{"self":"https://wellknown.network/agents/shopify-forecast-mcp/record.json","html":"https://wellknown.network/agents/shopify-forecast-mcp","markdown":"https://wellknown.network/agents/shopify-forecast-mcp/record.md","api":"https://wellknown.network/api/v1/agents/shopify-forecast-mcp","status":"https://wellknown.network/api/v1/agents/shopify-forecast-mcp/status","claim":"https://wellknown.network/agents/shopify-forecast-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/shopify-forecast-mcp/claim.json","badge":"https://wellknown.network/agents/shopify-forecast-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:shopify-forecast-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"shopify-forecast-mcp","summary":"MCP server connecting Google TimesFM 2.5 to Shopify Admin GraphQL for forecasting, demand planning, and anomaly detection.","description":"# shopify-forecast-mcp\n\n> ⚠️ **v0.1.0 Alpha** — Early release. API surface may change before v0.2. Feedback welcome: [open an issue](https://github.com/mcostigliola321/shopify-forecast-mcp/issues).\n\nMerchant-native MCP server that connects Google's TimesFM 2.5 time-series foundation model to your Shopify store — so your AI assistant can answer \"what does next month look like?\" with a real forecast grounded in your order history.\n\nNo dashboards, no exports, no per-store training. Works with Claude Desktop, Claude Code, Cursor, and any MCP-compatible AI client.\n\n***\n\n## Why\n\nShopify has four official MCP servers, all buyer-facing or developer-facing. None serve merchant operations: forecasting, demand planning, promo analysis, anomaly detection.\n\nExisting third-party tools either use weak models (moving averages, Prophet) or lock insights inside closed SaaS dashboards. This one:\n\n- Runs **TimesFM 2.5** (Google's 200M-param foundation model) — state of the art on the GIFT-Eval retail benchmark\n- Pulls directly from **Shopify Admin GraphQL** with bulk operations, refund-aware normalization, multi-currency, and cost-based rate limiting\n- Returns **markdown tables with confidence bands** that render natively in your MCP client\n- Ships as a single `uvx` command — zero manual Python setup\n- Is **MIT licensed, free forever**\n\n***\n\n## Quick start\n\nThree steps to a working forecast in under 5 minutes:\n\n### 1. Install `uv` (once)\n\n```bash\n# macOS / Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Windows (PowerShell)\nirm https://astral.sh/uv/install.ps1 | iex\n```\n\n### 2. Get a Shopify Admin API access token\n\nFollow [docs/SETUP.md](docs/SETUP.md) to create a custom app, enable the required scopes (`read_orders`, `read_all_orders`, `read_products`, `read_inventory`), and generate an access token.\n\n### 3. Add to Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows) and add:…","publisher":null,"homepage":"https://github.com/mcostigliola321/shopify-forecast-mcp","repository":"https://github.com/mcostigliola321/shopify-forecast-mcp","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["ecommerce","forecasting","mcp","shopify","timeseries","timesfm"],"pricing":null,"endpoints":[{"url":"pypi:shopify-forecast-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"}},"derived":{"capabilities":[{"slug":"data.weather","name":"Weather","confidence":1,"provenance":"derived"},{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":1,"provenance":"declared"},{"slug":"data.apis","name":"API Access","confidence":0.836,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.779,"provenance":"derived"}],"categories":["commerce","data","dev"],"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":"shopify-forecast-mcp","registry":"pypi","observedAt":"2026-09-10T12:23:26.421Z","publishedAt":"2026-04-19T21:02:50.432576Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"shopify-forecast-mcp","url":"https://pypi.org/project/shopify-forecast-mcp/","firstSeenAt":"2026-09-10T12:21:59.013Z","fetchedAt":"2026-09-10T12:21:59.013Z","normalizedAt":"2026-09-10T12:21:59.013Z"}]},"firstSeenAt":"2026-09-10T12:21:59.013Z","updatedAt":"2026-09-10T12:23:26.421Z"}