JustIdea Prestashop DEMO — 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 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Getting started — free, no signup

Most of this store needs no credentials at all. The catalogue, prices, stock, shipping quotes and policies are free to read with no account, no API key and no registration. There is no paid tier gating any of it.

curl https://prestashop.justidea.dev/llms.txt

Self-serve keys. The MCP endpoint expects a bearer token, and you can issue yourself one in a single request — no human, no form:

curl -X POST https://prestashop.justidea.dev/v1/register \
  -H "Content-Type: application/json" -d '{"label":"my-agent"}'

No sandbox is needed. Every operation here is read-only — nothing creates, changes or deletes anything — so there is no destructive call to practise away from production. Point your client straight at this store.

GraphQL

A read-only GraphQL endpoint at https://prestashop.justidea.dev/graphql. Introspection is open — send the standard introspection query and generate a client.

Typed errors

Failures come back inside the payload as userErrors, not only in the top-level errors array. Each carries a stable code from the UserErrorCode enum, the field path at fault, and a message. Branch on the code; the wording may change, the code will not.

{ product(id: 999999) { product { name } userErrors { code field message } } }
# → { "data": { "product": { "product": null,
#     "userErrors": [{ "code": "NOT_FOUND", "field": ["product","id"], ... }] } } }

Pagination

Relay connections: walk pageInfo.endCursor into after rather than incrementing offsets. Cursors are opaque.

{ products(first: 20, query: "jacket") {
    totalCount
    edges { cursor node { id name price { amount currency } availability } }
    pageInfo { hasNextPage endCursor }
    userErrors { code message } } }

Schema evolution

Additive changes — new types, fields and enum members — may land at any time. A field being retired is marked with the @deprecated directive, carrying the reason and its replacement, and keeps working for at least 180 days after that. Breaking changes get a new endpoint version rather than being applied in place. Responses carry API-Version, and a retired version would additionally carry Deprecation and Sunset headers (RFC 8594, RFC 9745).

Code samples

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

Python

import requests

# Store overview, no credentials needed
overview = requests.get("https://prestashop.justidea.dev/llms.txt").text

# Any page as Markdown
page = requests.get("https://prestashop.justidea.dev/", headers={"Accept": "text/markdown"}).text

# Search the catalogue over MCP
r = requests.post(
    "https://prestashop.justidea.dev/agent/mcp",
    headers={"Authorization": "Bearer <token>"},
    json={"jsonrpc": "2.0", "id": 1, "method": "tools/call",
          "params": {"name": "search_products",
                     "arguments": {"query": "shirt", "limit": 5}}},
)
if r.status_code == 429:
    wait = int(r.headers.get("Retry-After", 60))  # honour the throttle
products = r.json()["result"]["structuredContent"]["products"]

JavaScript

const overview = await (await fetch("https://prestashop.justidea.dev/llms.txt")).text();

const res = await fetch("https://prestashop.justidea.dev/agent/mcp", {
  method: "POST",
  headers: { Authorization: "Bearer <token>", "Content-Type": "application/json" },
  body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/list" }),
});
console.log(res.headers.get("RateLimit-Remaining"));  // pace yourself
const { 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/v1/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 9.5.1.