{"_id":"@bintangtimurlangit/toco-mcp","name":"@bintangtimurlangit/toco-mcp","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@bintangtimurlangit/toco-mcp","version":"1.0.0","description":"A zero-config MCP server for discovering Toco (toco.id), Indonesia's community marketplace — product search with rich filtering, product detail, variants, reviews, store info, category browsing, plus classified vehicle and property search. No login requir","author":{"name":"bintangtimurlangit"},"license":"MIT","type":"module","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/bintangtimurlangit/toco-mcp.git"},"bugs":{"url":"https://github.com/bintangtimurlangit/toco-mcp/issues"},"homepage":"https://github.com/bintangtimurlangit/toco-mcp#readme","bin":{"toco-mcp":"build/index.js"},"scripts":{"clean":"node -e \"require('fs').rmSync('build',{recursive:true,force:true})\"","prebuild":"npm run clean","build":"tsc","dev":"tsx watch src/index.ts","start":"node build/index.js","typecheck":"tsc --noEmit","lint":"eslint .","lint:fix":"eslint . --fix","format":"prettier --write .","format:check":"prettier --check .","test":"npm run test:unit && tsx test/smoke.ts","test:unit":"tsx test/format.test.ts && tsx test/cache.test.ts && tsx test/query.test.ts","test:smoke":"tsx test/smoke.ts","prepare":"husky","prepublishOnly":"npm run build"},"lint-staged":{"*.{ts,js,json,md,yml,yaml}":"prettier --write","*.ts":"eslint --fix"},"keywords":["mcp","model-context-protocol","toco","tocobagus","indonesia","ecommerce","marketplace","classifieds","product-search","discovery"],"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","dotenv":"^17.4.2","zod":"^3.25.76"},"devDependencies":{"@commitlint/cli":"^21.2.1","@commitlint/config-conventional":"^21.2.0","@eslint/js":"^10.0.1","@types/node":"^24.0.0","eslint":"^10.7.0","eslint-config-prettier":"^10.1.8","husky":"^9.1.7","lint-staged":"^17.1.0","prettier":"^3.4.2","tsx":"^4.23.1","typescript":"^5.9.0","typescript-eslint":"^8.65.0"},"engines":{"node":">=18.0.0"},"gitHead":"db0dd7ae60022e3207c409adc5eec192baa64056","_id":"@bintangtimurlangit/toco-mcp@1.0.0","_nodeVersion":"26.7.0","_npmVersion":"11.19.0","dist":{"integrity":"sha512-dEUusPUez+uvbiumNaUOOv/m+oclHk6q1SMmmrpFLVJQe+OJMmSZjNKLaJA3N5ALMBZESpFvMFDcY1K88YvyRw==","shasum":"73a2ea7024cae67841cb45e5b2554e8763ccf4da","tarball":"https://registry.npmjs.org/@bintangtimurlangit/toco-mcp/-/toco-mcp-1.0.0.tgz","fileCount":73,"unpackedSize":192198,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIF1td7Fwhso/zObGtwDAdoNDdPzI7lL/h7HBt/9ydzOaAiEAtB6lgqiSWlhyjsHfRpU5lxmlfwj8nZfyuOKnhslio9Y="}]},"_npmUser":{"name":"bintangtimurlangit","email":"btimurlangit@gmail.com"},"directories":{},"maintainers":[{"name":"bintangtimurlangit","email":"btimurlangit@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/toco-mcp_1.0.0_1788809475320_0.7892998685533259"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-07T19:31:15.161Z","1.0.0":"2026-09-07T19:31:15.450Z","modified":"2026-09-07T19:31:15.652Z"},"maintainers":[{"name":"bintangtimurlangit","email":"btimurlangit@gmail.com"}],"description":"A zero-config MCP server for discovering Toco (toco.id), Indonesia's community marketplace — product search with rich filtering, product detail, variants, reviews, store info, category browsing, plus classified vehicle and property search. No login requir","homepage":"https://github.com/bintangtimurlangit/toco-mcp#readme","keywords":["mcp","model-context-protocol","toco","tocobagus","indonesia","ecommerce","marketplace","classifieds","product-search","discovery"],"repository":{"type":"git","url":"git+https://github.com/bintangtimurlangit/toco-mcp.git"},"author":{"name":"bintangtimurlangit"},"bugs":{"url":"https://github.com/bintangtimurlangit/toco-mcp/issues"},"license":"MIT","readme":"# Toco MCP\n\n[![npm version](https://img.shields.io/npm/v/@bintangtimurlangit/toco-mcp.svg)](https://www.npmjs.com/package/@bintangtimurlangit/toco-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)\n\nA zero-config [Model Context Protocol](https://modelcontextprotocol.io) server for\ndiscovering **[Toco](https://toco.id)** — Indonesia's community marketplace, founded by\nthe creator of Tokobagus and built on 0% sales commission.\n\n**No login, no API key, no browser automation.** Toco serves its catalogue over a public\nJSON API, so this server is a plain HTTP client. It is strictly **read-only**: it searches\nand reads, and never carts, buys, messages, or writes anything.\n\n## What it does\n\n- 🔍 **Search products** — free-text plus price, condition, city, category, and official-store filters\n- 💡 **Autocomplete** — see how sellers actually spell a product before searching\n- 📦 **Product detail** — description, effective price, stock, shipping dimensions, category path, seller\n- 🎨 **Variants** — per-SKU price and stock across variant axes like Color and Size\n- 🎟 **Promos** — vouchers and free-shipping subsidies a listing qualifies for\n- 📝 **Reviews** — ratings and written reviews with the overall summary\n- 🏬 **Stores** — seller profiles, their catalogue, and store search\n- 🗂 **Categories** — the full department → category → type taxonomy\n- 🚗 **Vehicle ads** — classified cars and motorbikes, filtered by year, mileage, transmission\n- 🏠 **Property ads** — houses and land for sale or rent, filtered by bedrooms and area\n\n## Install\n\n```bash\nnpm install -g @bintangtimurlangit/toco-mcp\n```\n\n## Configure\n\nAdd to your MCP client config (for Claude Desktop, `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"toco\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bintangtimurlangit/toco-mcp\"]\n    }\n  }\n}\n```\n\nThat's the whole setup — there is nothing to authenticate. See\n[docs/CONFIGURATION.md](./docs/CONFIGURATION.md) for local-build and tuning options.\n\n## Tools\n\n| Tool                     | Description                                                  |\n| ------------------------ | ------------------------------------------------------------ |\n| `search_products`        | Search buyable marketplace products with filters and sorting |\n| `get_search_suggestions` | Autocomplete suggestions for a partial search term           |\n| `get_product_detail`     | Full detail for one listing                                  |\n| `get_product_variants`   | Every variant SKU with its own price and stock               |\n| `get_product_promos`     | Vouchers and promotions a listing is eligible for            |\n| `get_product_reviews`    | Reviews and rating summary                                   |\n| `get_store_info`         | A seller's profile                                           |\n| `get_store_products`     | What a specific store sells                                  |\n| `search_stores`          | Find sellers by name, city, or official status               |\n| `get_category_tree`      | Browse the taxonomy and get category UUIDs                   |\n| `search_vehicles`        | Classified car and motorbike ads                             |\n| `search_properties`      | Classified property ads                                      |\n\nProduct and store arguments accept either a slug (`sepatu-pria-30`) or a pasted URL\n(`https://toco.id/listing/sepatu-pria-30`).\n\n## Marketplace vs. classifieds\n\nToco is two catalogues behind one search index, split by an `add_to_cart` flag:\n\n- **Marketplace** listings are buyable — they have stock, variants, and a cart. Use `search_products`.\n- **Classified** listings are contact-the-seller ads — vehicles, property, services. Use `search_vehicles` / `search_properties`.\n\nSearching for `\"avanza\"` with the wrong one returns car _parts_ instead of cars, so the\ntools are split along that line rather than exposing the flag as a filter.\n\n## Example prompts\n\n> Find running shoes on Toco under Rp300.000, sorted by most sold.\n\n> What variants does this Toco listing have, and which sizes are out of stock?\n\n> Show me second-hand Toyota Avanzas from 2018 or newer with under 100,000 km.\n\n> Find 3-bedroom houses for sale in Bandung with at least 100 m² of building area.\n\n> Which official Toco Mall stores sell coffee, and what are they rated?\n\n## Documentation\n\n- [Configuration](./docs/CONFIGURATION.md)\n- [Development](./docs/DEVELOPMENT.md)\n- [Releases](./docs/RELEASES.md)\n- [Toco API reference](./reference/API.md) — the reconnaissance notes this server is built on\n- [Contributing](./CONTRIBUTING.md) · [Security](./SECURITY.md) · [Changelog](./CHANGELOG.md)\n\n## Disclaimer\n\nUnofficial and not affiliated with, endorsed by, or sponsored by Toco. It reads the same\npublic endpoints a visitor's browser does, at a browser's pace. Respect Toco's\n[terms of service](https://toco.id/privacy). Because it depends on undocumented endpoints,\nToco can change them at any time — `npm test` is the tripwire that catches it.\n\n## License\n\nMIT © [bintangtimurlangit](https://github.com/bintangtimurlangit)\n","readmeFilename":"README.md","_rev":"1-5b8989a384f3eca52324ea3f3352c9e6"}