{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_dmctvpgmrj8e","handle":"hktvmall-mcp","url":"https://wellknown.network/agents/hktvmall-mcp","links":{"self":"https://wellknown.network/agents/hktvmall-mcp/record.json","html":"https://wellknown.network/agents/hktvmall-mcp","markdown":"https://wellknown.network/agents/hktvmall-mcp/record.md","api":"https://wellknown.network/api/v1/agents/hktvmall-mcp","status":"https://wellknown.network/api/v1/agents/hktvmall-mcp/status","claim":"https://wellknown.network/agents/hktvmall-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/hktvmall-mcp/claim.json","badge":"https://wellknown.network/agents/hktvmall-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/hktvmall-mcp/history","tools":"https://wellknown.network/api/v1/agents/hktvmall-mcp/tools"},"ard":{"identifier":"urn:air::server:hktvmall-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"hktvmall-mcp","summary":"MCP server for HKTVmall (Hong Kong): search, product cards, order history and basket edits read back from HKTVmall; never pays","description":"# hktvmall-mcp\n\nRead the [permissions model](docs/PERMISSIONS.md).\n\nAn [MCP](https://modelcontextprotocol.io) server for [HKTVmall](https://www.hktvmall.com), Hong Kong's online mall\nand supermarket. It lets an AI assistant (Claude, ChatGPT, Cursor, ...) search HKTVmall for a whole shopping list,\ncompare prices and unit prices, show product cards with photos, read your order history and set quantities in your\nreal basket. **You pay yourself, on HKTVmall:** the server cannot place, pay for or change an order.\n\n> Unofficial. Not affiliated with or endorsed by HKTVmall or Hong Kong Television Network Limited. HKTVmall has no\n> public API; this server uses the same endpoints HKTVmall's own website uses, gently and only when you ask. Use it\n> with your own account for your own shopping; HKTVmall's terms and conditions apply to you.\n\n**Requirements**\n\n- A connection from **Hong Kong**: HKTVmall answers connections from elsewhere with errors.\n- An HKTVmall account for the basket and order history (search works without one).\n- [uv](https://docs.astral.sh/uv/) (it fetches Python 3.12 if needed), or Docker for a server.\n- Google Chrome for signing in (or Chromium, see [Signing in](#signing-in)).\n\n## Quick start\n\n1. **Sign in once.** A browser window opens on HKTVmall's own login page; log in as usual (HKTVmall's own checks\n   included). It closes once you are signed in, and the session is saved for the server.\n\n   ```sh\n   uvx --from \"hktvmall-mcp[login]\" hktvmall-mcp login\n   ```\n\n2. **Add the server to your client.** It runs over stdio, started by the client:\n\n   - Claude Code: `claude mcp add hktvmall -- uvx hktvmall-mcp`\n   - Claude Desktop, Cursor and most other clients: add to the client's MCP configuration\n\n     ```json\n     {\n       \"mcpServers\": {\n         \"hktvmall\": {\n           \"command\": \"uvx\",\n           \"args\": [\"hktvmall-mcp\"]\n         }\n       }\n     }\n     ```\n\n3. **Ask.** \"Put milk, a dozen eggs and some bananas in my HKTVmall basket\", \"What did I order la…","publisher":{"name":"benjamin-di","url":null},"homepage":"https://github.com/benjamin-di/hktvmall-mcp-server","repository":"https://github.com/benjamin-di/hktvmall-mcp-server","version":"0.15.6","license":null,"protocols":["mcp"],"tags":["groceries","hktvmall","hong-kong","mcp","model-context-protocol","shopping"],"pricing":null,"endpoints":[{"url":"pypi:hktvmall-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":"infra.browser-automation","name":"Browser Automation","confidence":0.791,"provenance":"derived"}],"categories":["infra"],"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":"hktvmall-mcp","registry":"pypi","observedAt":"2026-11-05T21:26:43.660Z","publishedAt":"2026-11-01T12:04:29.992911Z","latestVersion":"0.15.6"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"hktvmall-mcp","url":"https://pypi.org/project/hktvmall-mcp/","firstSeenAt":"2026-10-24T17:27:35.619Z","fetchedAt":"2026-11-05T21:25:45.643Z","normalizedAt":"2026-11-05T21:25:45.643Z"}]},"firstSeenAt":"2026-10-24T17:27:35.619Z","updatedAt":"2026-11-05T21:26:43.660Z"}