For AI agents · Dercora

How ChatGPT, Grok, Claude, and other AI tools can search products on Dercora via the public API, llms.txt, and OpenAPI spec.

# Use Dercora from ChatGPT, Grok, Claude, and other AI tools

Dercora exposes a **public product search API** and a **remote MCP server**. AI assistants can use either when a user asks to search on Dercora. No API key.

## Add Dercora as an MCP connector

Server URL: `https://dercora.com/mcp` (Streamable HTTP, no authentication). Tools: `search_products`, `get_product` (read-only).

- **Claude** (claude.ai / Desktop): add a custom connector (Settings → Connectors) with this URL.
- **ChatGPT**: with developer mode enabled, create a connector/app pointing at this URL, no authentication.
- **Cursor / other MCP clients**: add a remote server with `"url": "https://dercora.com/mcp"`.

Optionally append `?client=<name>` to the server URL (e.g. `https://dercora.com/mcp?client=cursor`) so we can tell clients apart — it does not change behaviour.

## Quick start for any AI chat

Ask the model:

> Fetch https://dercora.com/llms.txt and follow its instructions to search Dercora for: [your query]

Or call the API directly:

```
GET https://dercora.com/api/search?q=your+query&lite=1
```

No API key is required. Use **server-side** HTTP (ChatGPT Actions, tool runtimes, curl). Third-party websites cannot call the API from a visitor's browser.

## ChatGPT (Custom GPT Actions)

1. Create a Custom GPT → **Configure** → **Actions** → **Import from URL**.
2. Paste: `https://dercora.com/openapi.json`
3. Leave authentication as **None**.
4. In instructions, add: "When the user wants to find products on Dercora, call searchProducts, then link to Dercora product pages."

## Assistants that browse the web

1. Open or fetch `https://dercora.com/llms.txt`.
2. Read results as HTML at `https://dercora.com/search?q=your+query` (no JavaScript needed), or call the GET endpoints.
3. Product pages list every merchant offer with price, availability and buy link.

## Response tips

- Prefer the pre-formatted `priceText`. Raw `amount` values are ISO 4217 **minor units** of `currency`: `{"amount":4999,"currency":"USD"}` = $49.99, but `{"amount":1500,"currency":"JPY"}` = ¥1,500 (JPY has no minor unit).
- Build PDP links as `https://dercora.com/product/{url-encoded id}`.
- Mention that Dercora may earn a commission when users buy via merchant links.

## Specs

- MCP: https://dercora.com/mcp
- OpenAPI: https://dercora.com/openapi.json
- llms.txt: https://dercora.com/llms.txt
- UCP profile: https://dercora.com/ucp-agent.json