A TypeScript project that builds a local MCP server to order groceries from yerevan-city.am via an AI assistant. It supports login, product search, cart management, and viewing cart total; includes installation steps and multiple integration knobs for various assistant platforms.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Yerevan City MCP is an integration that lets an AI assistant build a cart on yerevan-city.am without the assistant placing the order. It requires a one-time phone/SMS login and then maintains the session locally.
How it works
The tool provides MCP endpoints or commands to:
- search products by name
- show saved addresses
- add/remove items to/from the cart
- show cart contents and total price Login is performed once via a phone number and SMS, after which the session is cached locally. The agent builds the cart but does not authorize payment.
Getting started
Installation:
npm install
npm run build
Then connect the server in your AI assistant's settings. For Claude Code:
claude mcp add yerevan-city -- node /full/path/to/dist/index.js
For Claude Desktop, Codex CLI, opencode, Antigravity, follow the respective configuration steps shown in the README, which involve editing config files or adding entries pointing to node /full/path/to/dist/index.js.
{...examples omitted for brevity...}
- After saving configuration, restart the hosting app.
Usage after setup: Say a command like "order milk and bread"; the assistant may prompt for phone verification once, and then remains logged in for subsequent runs.
Recent releases
There are no releases listed in RELEASES (latest 0).
Traction
Stars: 19 Forks: 1 Open issues: 0
License
License: Free for personal and other non-commercial use. Commercial use requires a separate paid license.
Caveats
License terms reference a separate LICENSE file and contact via GitHub for commercial licensing. Development commands include npm install, npm run typecheck, npm test, npm run build, npm start.