With credentials configured, the MCP auto-logs in on startup and the store ID is auto-detected from your delivery address. When using a token directly, set BRAVOVA_STORE_ID manually for correct pricing.
Environment Variables
Variable
Description
BRAVOVA_AUTH_TOKEN
Pre-existing auth token (highest priority)
BRAVOVA_USERNAME
Cedula for auto-login
BRAVOVA_PASSWORD
Password for auto-login
BRAVOVA_STORE_ID
Default store ID for pricing/availability
Authentication priority:
BRAVOVA_AUTH_TOKEN - use directly if set
BRAVOVA_USERNAME + BRAVOVA_PASSWORD - auto-login on startup
Neither - use the login tool manually
Store ID behavior:
With login (username/password): store ID is auto-detected from your delivery address
With token only: set BRAVOVA_STORE_ID to get correct pricing (e.g., 1008)
If not set: tools like search_articles won't return prices unless you pass storeId explicitly
Streamable HTTP transport - Add HTTP transport with streaming support as per MCP spec (SSE transport is legacy)
Auto re-login on token expiry - Detect auth failures, automatically re-login if credentials are available, retry the failed request, and notify the user that session was refreshed
Token persistence - Save token to ~/.bravova-token on successful login, load on startup to avoid re-authentication
Token expiry detection - Proactively refresh token before it expires
Disclaimer
This project is unofficial and is not affiliated with, endorsed by, or connected to Supermercados Bravo or any of its subsidiaries or affiliates.
This software interacts with Supermercados Bravo's API in a manner that may violate their Terms of Service. Use of this software is at your own risk. The author assumes no responsibility for:
Account suspension or termination
Any legal action taken by Supermercados Bravo
API changes that break functionality
Data loss or other damages
This project is provided for educational and personal use only. By using this software, you acknowledge that you understand these risks and accept full responsibility for your usage.