frisco MCP server
Commit Nov 10, 2026Enables AI assistants to browse grocery products, manage shopping carts, place orders, and reserve delivery slots on Frisco.pl.
Also known as rrudol/frisco
- Stars
- 9
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 10, 2026
- License
- MIT
What is frisco MCP?
frisco enables AI assistants to browse grocery products, manage shopping carts, place orders, and reserve delivery slots on Frisco.pl.
Summary generated from the project's README
About frisco MCP server
Managing grocery shopping and delivery schedules through an AI assistant is possible with frisco. This MCP server connects AI clients like Claude Desktop or Cursor to the Frisco.pl grocery delivery API, allowing users to interact with their accounts via natural language. It functions as a local server using stdio transport and requires a session established through a browser login or a cURL import.
Users can perform a variety of tasks including searching for products with category filtering, checking nutrition information, and managing shopping carts. The server also provides tools to view order history, reserve specific delivery slots, and handle session management. Because it relies on local session files containing authorization tokens and cookies, it is designed for individual use on private machines rather than shared environments.
What you can do with it
- 1Search for specific groceriesFind products by name or narrow them down using specific category IDs.
- 2Automate bulk shopping listsAdd multiple items to your cart at once using a JSON file.
- 3Schedule grocery deliveriesCheck available delivery windows and reserve a specific time slot.
- 4Review past purchasesAccess your account history to see previous orders.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablerrudol/frisco is public and reachablegithub.com/rrudol/frisco ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/rrudol/frisco ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubFrisco CLI
Unofficial CLI & MCP server for the Frisco.pl grocery delivery API.
Disclaimer: This is an independent, community project — not affiliated with Frisco. Use at your own risk.
Features
- Interactive cart TUI (Bubble Tea)
- Product search with category filtering and nutrition info
- Delivery slot reservation
- Order history
- Batch cart additions from JSON shopping lists
- MCP server for AI assistant integration
- Session management (cURL import, browser login)
Requirements
- Go
1.26+(pergo.mod) - For
frisco session login: a locally installed browser supported bychromedp(e.g. Chrome/Chromium)
Installation
go install github.com/rrudol/frisco/cmd/frisco@latest
Local build:
make build
./bin/frisco --help
Quick start
- Log in via browser (recommended):
frisco session login
- Or save session from a cURL command:
frisco session from-curl --curl "curl 'https://www.frisco.pl/app/commerce/api/v1/users/123/cart' -H 'authorization: Bearer ...' -H 'cookie: ...'"
- Verify your session works:
frisco session verify
Commands
frisco cart # Interactive TUI (list, +/-, remove, refresh)
frisco cart show
frisco cart add --product-id <id> --quantity 1
frisco cart add-batch --file list.json # --dry-run for parse-only
frisco products search --search banana
frisco products search --search apple --category-id 18707
frisco products nutrition --product-id 4094
frisco reservation slots --days 2
frisco reservation reserve --date 2026-03-25 --from-time 06:00 --to-time 07:00
frisco reservation cancel
frisco account show
frisco account orders list --all-pages
frisco session login # Interactive browser login
frisco session refresh-token # Refresh access token
frisco mcp # Start MCP server (stdio)
Batch cart from a shopping list
frisco session verify— make sure your session is valid.- Search for products:
frisco products search --search "phrase"— optionally add--category-idto narrow results. Use--format jsonand pipe tojqto extract product IDs. - Build a JSON file: an array of
{ "product_id": "…", "quantity": n }objects or{"items":[…]}. Template: examples/cart-add-batch.example.json. frisco cart add-batch --file list.json— displays a cart summary after adding. Use--dry-runto validate the file without calling the API.
Category IDs
Using --category-id with products search / products pick narrows results and dramatically improves relevance. Full category tree: categories.md.
Output format
By default the CLI outputs human-readable tables. Use --format json for machine-readable output:
frisco account orders list --all-pages
frisco account orders list --all-pages --format json
MCP server — AI assistant integration
frisco mcp starts an MCP server over stdio, exposing cart, products, orders, reservations, and session tools to any compatible AI client.
Claude Desktop
Download the latest .mcpb bundle for your platform from Releases, then in Claude Desktop go to Extensions → Advanced Settings → Install Extensions and select the downloaded file.
Login: Ask Claude to log you in to Frisco (e.g. "zaloguj mnie do Frisco"). A Chrome window will open — log in on frisco.pl and navigate to your cart or account page. The session is captured automatically and saved for future use. Requires Chrome/Chromium.
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"frisco": {
"command": "frisco",
"args": ["mcp"]
}
}
}
If frisco is not in your PATH, use the absolute path to the binary (e.g. "/Users/you/go/bin/frisco").
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"frisco": {
"command": "frisco",
"args": ["mcp"]
}
}
}
Claude Code
claude mcp add frisco -- frisco mcp
Any client supporting stdio transport works:
frisco mcp
The server exposes tools for: product search, cart management, order history, delivery reservation, account info, and session management.
Session data
Session is stored locally at ~/.frisco-cli/session.json.
Security notes:
- The file may contain tokens and session headers (
Authorization,Cookie). - Access to this file grants API access in your account's context.
- Do not run
frisco mcpin untrusted or shared environments.
If an access token expires, the CLI will automatically attempt to refresh it. If refresh fails, re-import your session with frisco session from-curl or frisco session login.
Example payloads
- examples/shipping-address.example.json
- examples/reservation-payload.example.json
- examples/cart-add-batch.example.json
License
frisco MCP questions
How do I log in to Frisco using the MCP server?
You can ask your AI assistant to log you in, which will open a Chrome window for you to complete the login on frisco.pl. The session is then captured automatically.
Can I add multiple items to my cart at once?
Yes, you can perform batch additions to your cart using a JSON file containing product IDs and quantities.
Where is my session data stored?
Your session information is stored locally in a file at ~/.frisco-cli/session.json.