Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@toco-mcp Find second-hand Avanza under Rp150 million"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A zero-config Model Context Protocol server for discovering Toco — Indonesia's community marketplace, founded by the creator of Tokobagus and built on 0% sales commission.
No login, no API key, no browser automation. Toco serves its catalogue over a public JSON API, so this server is a plain HTTP client. It is strictly read-only: it searches and reads, and never carts, buys, messages, or writes anything.
🔍 Search products — free-text plus price, condition, city, category, and official-store filters
💡 Autocomplete — see how sellers actually spell a product before searching
📦 Product detail — description, effective price, stock, shipping dimensions, category path, seller
🎨 Variants — per-SKU price and stock across variant axes like Color and Size
🎟 Promos — vouchers and free-shipping subsidies a listing qualifies for
📝 Reviews — ratings and written reviews with the overall summary
🏬 Stores — seller profiles, their catalogue, and store search
🗂 Categories — the full department → category → type taxonomy
🚗 Vehicle ads — classified cars and motorbikes, filtered by year, mileage, transmission
🏠 Property ads — houses and land for sale or rent, filtered by bedrooms and area
Related MCP server: MCP Test Ario
npm install -g @bintangtimurlangit/toco-mcpAdd to your MCP client config (for Claude Desktop, claude_desktop_config.json):
{
"mcpServers": {
"toco": {
"command": "npx",
"args": ["-y", "@bintangtimurlangit/toco-mcp"]
}
}
}That's the whole setup — there is nothing to authenticate. See docs/CONFIGURATION.md for local-build and tuning options.
Tool | Description |
| Search buyable marketplace products with filters and sorting |
| Autocomplete suggestions for a partial search term |
| Full detail for one listing |
| Every variant SKU with its own price and stock |
| Vouchers and promotions a listing is eligible for |
| Reviews and rating summary |
| A seller's profile |
| What a specific store sells |
| Find sellers by name, city, or official status |
| Browse the taxonomy and get category UUIDs |
| Classified car and motorbike ads |
| Classified property ads |
Product and store arguments accept either a slug (sepatu-pria-30) or a pasted URL
(https://toco.id/listing/sepatu-pria-30).
Toco is two catalogues behind one search index, split by an add_to_cart flag:
Marketplace listings are buyable — they have stock, variants, and a cart. Use search_products.
Classified listings are contact-the-seller ads — vehicles, property, services. Use search_vehicles / search_properties.
Searching for "avanza" with the wrong one returns car parts instead of cars, so the
tools are split along that line rather than exposing the flag as a filter.
Find running shoes on Toco under Rp300.000, sorted by most sold.
What variants does this Toco listing have, and which sizes are out of stock?
Show me second-hand Toyota Avanzas from 2018 or newer with under 100,000 km.
Find 3-bedroom houses for sale in Bandung with at least 100 m² of building area.
Which official Toco Mall stores sell coffee, and what are they rated?
Toco API reference — the reconnaissance notes this server is built on
Unofficial and not affiliated with, endorsed by, or sponsored by Toco. It reads the same
public endpoints a visitor's browser does, at a browser's pace. Respect Toco's
terms of service. Because it depends on undocumented endpoints,
Toco can change them at any time — npm test is the tripwire that catches it.
MIT © bintangtimurlangit
Browse Toco's category taxonomy and get the UUIDs that search_products, search_vehicles, and search_properties accept as departmentId / categoryIds. Start with depth 1 for the department list, then drill into one department by slug.
Inputs: depth, department.
Get full detail for one Toco listing: description, effective price, stock, condition, shipping weight and dimensions, category path, seller info, and whether it has variants. Works for both marketplace products and classified ads.
Inputs: product (required).
List the vouchers and promotions a Toco listing is currently eligible for — free-shipping subsidies, discounts, minimum spend, and expiry dates.
Inputs: product (required).
Get customer reviews and the rating summary for a Toco listing. Toco server-renders reviews rather than exposing a review API, so this returns the set shown on the product page (most recent first) alongside the overall average and total count.
Inputs: product (required), minRating, withTextOnly.
List every variant SKU of a Toco product with its own price, stock, and SKU code. Returns the variant axes (e.g. Color, Size) and flags which combinations are out of stock.
Inputs: product (required).
Get Toco's autocomplete suggestions for a partial search term. Useful for discovering how sellers actually spell a product before running search_products.
Inputs: query (required), limit, officialOnly.
Get a Toco seller's profile: display name, city, description, rating, active product count, official/tier badges, and KYC status. Takes the store short name (e.g. "ysn-store") or a full toco.id/store/... URL.
Inputs: store (required).
List the products a specific Toco store sells, with optional keyword and price filtering. Takes the store short name or a full toco.id/store/... URL.
Inputs: store (required), page, sort, limit, +3 more.
Search buyable products on the Toco marketplace (toco.id). Supports free-text queries plus price, condition, city, category, and official-store filters. Returns titles, prices, ratings, sales counts, stores, and product URLs. For cars, motorbikes, or property use search_vehicles / search_properties instead — those are classified ads, not buyable products.
Inputs: page, sort, limit, query, +7 more.
Search classified property ads on Toco — houses, apartments, and land for sale or rent. Filter by bedrooms, bathrooms, building and lot area, and sale-vs-rent. These are contact-the-seller ads, not add-to-cart products.
Inputs: page, sort, limit, query, +8 more.
Search for sellers on Toco by name or description. Filter by city, official-store status, or store tier. Returns store names, cities, ratings, and their toco.id links.
Inputs: query (required), page, limit, cities, +1 more.
Search classified vehicle ads on Toco — cars and motorbikes listed by owners and dealers. Filter by production year, mileage, and transmission. These are contact-the-seller ads, not add-to-cart products.
Inputs: page, sort, limit, query, +8 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 12 tools
Each tool targets a distinct resource or action: search variants for global vs store-specific search, product detail vs variants vs promos vs reviews, and separate tools for vehicles and properties. Clear boundary between search_products (buyable) and classified ads.
All tools use snake_case with a verb_noun pattern: get_* for detail retrieval, search_* for querying. Consistent and predictable naming convention throughout.
12 tools is well within the ideal 3-15 range; each tool covers a distinct read-only operation with no redundancy or bloat.
Covers the full read surface of a marketplace: search, suggestions, category taxonomy, product details, variants, promos, reviews, store info and products, plus specialized search for vehicles and properties. No obvious gaps for a read-only data access layer.
Search multi-merchant supply, checkout, and track orders via MCP.
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
E-commerce MCP gateway: live product deals, attributed buy links, order tracking, flights.