Susurros del Ruiz developer resources

Susurros del Ruiz runs a read-only MCP (Model Context Protocol) server that exposes this farm's operational data: harvests, lots, inventory, sales, profitability and payroll. It is meant for AI assistants and internal tooling, not for public consumption. The full reference, with connection examples, lives in developers.md.

Is this for you?

Yes, if you are building an assistant or a tool that needs live figures from this specific farm and you have been given an API key. No, if you are looking for a public catalogue, prices or a way to place an order: there is no public commerce API. To buy mangosteen, pulp or powder, write to gerencia@susurrosdelruiz.com or call +57 300 230 1391.

MCP server

• Endpoint: https://ifapivzvphsdkrhcrmwk.supabase.co/functions/v1/mcp
• Protocol: Model Context Protocol, JSON-RPC over HTTP. Methods: initialize, tools/list, tools/call.
• Auth: Authorization: Bearer szr_live_… Keys are issued by Susurros del Ruiz and are revocable; only a SHA-256 hash is stored.
• Access is read-only. No method writes, deletes or mutates anything.
• Sixteen tools, covering indicators, profit and loss, cash flow, receivables, sales, profitability by client, product and lot, lots, inventory, harvest curve, picker ranking, payroll, expenses, loss and data-integrity alerts.

Public traceability endpoint

This one needs no key. It is what the QR code printed on each package resolves to. Given a lot code it returns the product, the farm, the harvest year, the elaboration date and the expiry. The human-readable version lives at /es/finca/lote/ followed by the lot code.

Machine-readable files

• developers.md — full developer reference
• llms.txt — what the business does and when to consult it
• agent-instructions.md — when to use us, and when not to
• sitemap.xml
• Contact