Agent & developer documentation

JustIdea Prestashop DEMO exposes its catalogue to AI agents and integrators. Everything below is read-only: nothing writes a cart, an order or customer data.

OpenAPI 3.1 specification · llms.txt · status

Endpoints

Markdown instead of HTML

Any product, category or CMS page returns Markdown when requested with Accept: text/markdown. The home page returns the store overview.

curl -H "Accept: text/markdown" https://prestashop.justidea.dev/

MCP endpoint

JSON-RPC 2.0 over POST at https://prestashop.justidea.dev/agent/mcp. Requires a bearer token — see auth.md.

curl -X POST https://prestashop.justidea.dev/agent/mcp \\n  -H "Authorization: Bearer <token>" \\n  -H "Content-Type: application/json" \\n  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Code samples

No SDK is required — the surface is plain HTTP. These are complete, working calls.

Python

import requests\n\n# Store overview, no credentials needed\noverview = requests.get("https://prestashop.justidea.dev/llms.txt").text\n\n# Any page as Markdown\npage = requests.get("https://prestashop.justidea.dev/", headers={"Accept": "text/markdown"}).text\n\n# Search the catalogue over MCP\nr = requests.post(\n    "https://prestashop.justidea.dev/agent/mcp",\n    headers={"Authorization": "Bearer <token>"},\n    json={"jsonrpc": "2.0", "id": 1, "method": "tools/call",\n          "params": {"name": "search_products",\n                     "arguments": {"query": "shirt", "limit": 5}}},\n)\nif r.status_code == 429:\n    wait = int(r.headers.get("Retry-After", 60))  # honour the throttle\nproducts = r.json()["result"]["structuredContent"]["products"]

JavaScript

const overview = await (await fetch("https://prestashop.justidea.dev/llms.txt")).text();\n\nconst res = await fetch("https://prestashop.justidea.dev/agent/mcp", {\n  method: "POST",\n  headers: { Authorization: "Bearer <token>", "Content-Type": "application/json" },\n  body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/list" }),\n});\nconsole.log(res.headers.get("RateLimit-Remaining"));  // pace yourself\nconst { result } = await res.json();

Running against this store

• Rate limits. Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset. On 429, wait Retry-After seconds.
• Versioning. Every response carries API-Version and Deprecation: false. Version 1 is current and not deprecated.
• Deprecation policy. If a version is retired, responses will carry Deprecation and Sunset headers (RFC 8594 / RFC 9745) with at least 180 days between them. Breaking changes get a new version; additive ones do not.
• No signup, no key, no cost for the catalogue, prices, stock, shipping and policies. Only the MCP endpoint uses a token, and the store owner issues it directly.
• Idempotency. Send Idempotency-Key and it is echoed back. Every operation is a read, so retrying is safe with or without it.
• Health. https://prestashop.justidea.dev/agent/status reports which features are live and how big the catalogue is. Safe to poll, never cached.
• Retries. 503 carries Retry-After. Everything here is read-only and idempotent, so retrying is always safe.
• Freshness. The agent sitemap carries lastmod; use it to decide what to re-fetch instead of re-crawling.

Errors

When the request accepts JSON, errors carry a stable error.code.

Served by AgentReady, a PrestaShop module by JustIdea Agency. Module version 1.0.2.