Silpo
- typescript
0
GitHub Stars
typescript
Language
4 months ago
First Indexed
2 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
Installation
Add the following to your MCP client configuration file.
Configuration
View docs{
"mcpServers": {
"mit9-silpo-mcp": {
"command": "npx",
"args": [
"-y",
"silpo-mcp"
]
}
}
}This MCP Server for the Silpo online supermarket enables you to interact with Silpo through a model context protocol, providing search, categories, promotions, cart operations, delivery checks, and personalized recommendations via your AI assistant.
How to use
You use this server by running it as an MCP endpoint and connecting your AI assistant client to it. You can manage a local memory cart, synchronize a server cart with Silpo, access order history, receive recommendations based on past purchases, and check delivery options. Before you start shopping, you may set your delivery address or verify whether a given address falls within the delivery zone. You can authorize with a cabinet token to unlock server-side features like order history and loyalty balances.
How to install
Prerequisites: you need Node.js and npm installed on your machine.
# Quick start using the MCP server
npx silpo-mcp
If you want to work with the source code locally, follow these steps to install dependencies, build, and run the server.
# Clone the repository
git clone https://github.com/MIt9/silpo-mcp.git
cd silpo-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Run the built server
npm start
Additional configuration and notes
You can connect your AI assistant to the MCP server in two ways. The primary method uses npx to start the server in a local, in-memory context. As an alternative during development, you may run the server via node pointing directly to the built index file.
Security and tokens
To access server-side features like order history and loyalty balances, you need an authorization token from the Silpo cabinet. Obtain the token from the cabinet and supply it to the server using set_auth_token. Ensure the token is scoped to the Silpo cabinet and includes the appropriate client_id in the JWT payload.
Getting coordinates and delivery checks
To determine delivery coverage or set a delivery location, you can provide a textual address or geographic coordinates. The server supports querying delivery zones and retrieving available delivery time slots.
Troubleshooting
If you encounter issues, ensure you are using a valid MCP command, that your delivery address is set when necessary, and that you have a valid authentication token for cabinet-bound features. Cloudflare protections may block certain operations; verify network access and try again if you see intermittent failures.
Examples of common workflows
Here is a practical flow to enable full server-side functionality: set the basket ID, then set the cabinet token, and proceed to use server-side cart and history features. If the basket lacks a delivery address, the assistant will prompt for it and call set_delivery_address before searching for products.
FAQ
Available tools
Associate a specific server-side basket by providing a basketId so the session can attach to the correct cart in the cabinet. This enables server-side cart operations and session restoration.
Provide a cabinet access token to enable authenticated features such as server-side cart access, order history, and loyalty data.
Set the delivery address for the session either as a textual address or geographic coordinates.
Fetch the current server-side shopping cart associated with your cabinet basket. This allows viewing and managing the server cart.
Add an item to the server cart hosted in Silpo. Use with product identifiers and quantity.
Modify the quantity or attributes of an item already in the server cart.
Remove an item from the server cart.
Attach a comment to a cart item, such as delivery preferences or preparation notes.
Retrieve the list of past orders from the cabinet to review previous purchases.
Offer product suggestions based on historical orders to facilitate quick reordering.
Check the current loyalty balance if the API provides this information.
Find products by query text to discover items matching your search terms.
Retrieve the list of product categories to help you navigate Silpo’s catalog.
List products currently on sale or with promotions.
Fetch detailed information for a specific product by its ID.
Get all products within a selected category with optional filtering and sorting.
Search recipes on silpo.ua by name, with ingredients and quantities.
Obtain recipe filters from Silpo API such as time and category constraints.
Add a product to the local in-memory cart.
Remove a product from the local in-memory cart.
View the current local in-memory cart contents.
Clear all items from the local in-memory cart.
Add a product to a separate shopping list with quantity and note.
View the current shopping list contents.
Remove a product from the shopping list.
Clear all items from the shopping list.
Mark a shopping list item as purchased or not purchased.
Move all items from the shopping list into the local cart.
