Tu Tiendita for developers
MCP server
Tu Tiendita is a mobile app for small shops in Mexico and Latin America: sales, store credit (fiado), inventory and simple reports. Its MCP server lets an AI assistant answer a shop owner's questions about her own store, with her permission. It is read only.
Endpoint
- MCP:
https://mcp.tutiendita.com.mx/mcp, Streamable HTTP, stateless. - Authorization server metadata:
https://mcp.tutiendita.com.mx/.well-known/oauth-authorization-server - Protected resource metadata:
https://mcp.tutiendita.com.mx/.well-known/oauth-protected-resource/mcp, also advertised in theWWW-Authenticateheader of a 401.
Authorization
- OAuth 2.1, authorization code with PKCE (S256). Scope:
tienda:leer(read the store). - Clients: Client ID Metadata Documents, or dynamic registration at
/oauth/register. - Account linking, two steps: the authorization page asks for a one time code the store owner makes in the Tu Tiendita app (Settings, Assistants) behind Face ID or the passcode when her phone has one; it lives 10 minutes and works once. Then her phone asks her to allow the connection: it shows the assistant, the country the code was typed from, and three numbers, and she taps the one the authorization page shows (number matching). Nothing is readable before she allows it. Only the store owner can link a store, and only from her phone; employees and browser sessions cannot.
- Redirect URIs must be an assistant's exact callback (Claude, ChatGPT; Muse by host), https, without query or fragment. Other apps can't register. PKCE S256 is required for every client.
- Refresh tokens last 30 days. The owner sees every connected assistant in the app and disconnects it there; a disconnected link stops answering at once, and its grant is revoked on the next call.
Tools
All tools are read only (readOnlyHint: true) and answer JSON with the store's name and currency.
| Tool | Input | Returns |
|---|---|---|
sales_summary | period: hoy (today), ayer (yesterday), ultimos_7_dias, este_mes. Store local days. | Total, number of sales, money by payment method, top 10 products by money. Cancelled sales excluded. |
who_owes_me | none | Total owed to the store and the customers who owe, biggest first: name, amount, dates of last sale and payment. |
find_customer | name | Matching customers' credit accounts: owed, bought on credit, paid, last dates. |
find_product | name or barcode digits | Price, stock (per size or color), low stock flag. |
Data and limits
- Never returned: phone numbers, notes, product costs, margins, employees, payment credentials.
- Per store per day: up to 300 tool calls and a fixed read budget, reserved before each read. Per link: 30 tool calls a minute. Identical questions within 5 minutes are answered from a cache.
- Markets: stores in Mexico and 40+ countries in Latin America and the Caribbean. Owners use the app in Spanish, Portuguese, English or Dutch.
- How Tu Tiendita handles data: privacy policy and terms.
Review and support
Directory reviewers get a code that opens a demo store; ask at [email protected]. Questions and problems go to the same address.