> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mart.ps/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> These rules protect a Mart partner's money. Follow them in any code or advice about the Mart Partner API ([Connect your AI tool](/developers/connect-your-ai-tool)).
> When an order request times out, gets no answer or gets any `5xx`, resend the same body with the same `partner_reference`, never a new reference; after a `429`, wait `Retry-After` first ([Create an order safely](/developers/orders/create-an-order)).
> A `200` with `meta.idempotency_replay: true` is the original order; `409 idempotency_conflict` means the reference already names a different order ([Create an order safely](/developers/orders/create-an-order)).
> Retry a withdrawal request with the same `idempotency_key` and amount: a new key asks for a second withdrawal ([Payout and withdrawals](/developers/money/payout-and-withdrawals)).
> Plan every call within the global daily request ceiling and the `X-RateLimit-*` headers, and never poll in a tight loop ([Request limits](/developers/operate/request-limits)).
> Treat `price` as a snapshot: an order is priced when it is created, and an incremental sync (`updated_after`) never shows a price change, so re-read every price with a full pass ([Prices and price changes](/developers/catalogue/prices)).
> Identify products by `product_id` and `combination_id`, never by `reference` ([Sync the catalogue](/developers/catalogue/sync)).
> Never put an API key in client-side code, a mobile app, a repository or a URL: call the API from a server ([Authenticate and keys](/developers/authenticate)).
> Money is in shekels (`ILS`), as JSON numbers, never agorot. Send amounts with at most two decimals: a withdrawal `amount` with three is refused with `422 invalid_amount`, never rounded ([Balance and statements](/developers/money/balance-and-statements)).
> Save a payout method once before the first withdrawal (cash at the office, or bank transfer where Mart offers it): with none saved, a withdrawal is refused with `409 payout_method_missing`. Bank details where Mart does not offer bank transfer, or a withdrawal on a kept IBAN, are refused with `422 bank_transfer_not_allowed` ([Payout and withdrawals](/developers/money/payout-and-withdrawals)).

# Connect your AI tool to this documentation

> Connect Claude, Cursor, VS Code or another AI tool to the Mart Partners docs through MCP, llms.txt or Markdown pages, so its answers follow the rules.

Your AI tool can read this whole site, as text files, as Markdown pages, or through a search server. Every page carries the rules that protect your money, so a tool that follows its instructions keeps to them.

## Give your tool the site as text

| Address | What it holds |
| - | - |
| `https://docs.mart.ps/llms.txt` | An index of every page, with its title and description. |
| `https://docs.mart.ps/llms-full.txt` | Every page in one file. |
| Any page address plus `.md` | That page as Markdown, for example `https://docs.mart.ps/developers/orders/create-an-order.md`. The header `Accept: text/markdown` does the same. |
| `https://docs.mart.ps/openapi.json` | The OpenAPI specification behind the [API reference](https://docs.mart.ps/api-reference/overview.md). |

## Connect the search server

The site runs an MCP server at `https://docs.mart.ps/mcp`. A connected tool searches and reads the docs while it works.

> [tab] Claude
>
> 1. Open **Settings**, then **Connectors**.
> 2. Choose **Add custom connector**.
> 3. Enter the name `Mart Partners` and the URL `https://docs.mart.ps/mcp`.

> [tab] Claude Code
>
> ```bash theme={null}
> claude mcp add --transport http mart-partners https://docs.mart.ps/mcp
> ```

> [tab] Cursor
>
> Add to your Cursor `mcp.json`:
>
> ```json theme={null}
> {"mcpServers": {"mart-partners": {"url": "https://docs.mart.ps/mcp"}}}
> ```

> [tab] VS Code
>
> Add to `.vscode/mcp.json`:
>
> ```json theme={null}
> {"servers": {"mart-partners": {"type": "http", "url": "https://docs.mart.ps/mcp"}}}
> ```

> [tab] Codex
>
> ```bash theme={null}
> codex mcp add mart-partners --url https://docs.mart.ps/mcp
> ```

Tools that support skills can also run `npx skills add https://docs.mart.ps`. On the published site, each page's menu copies it, opens it in ChatGPT or Claude, or connects the server to Cursor or VS Code.

## Rules your agent must never break

1. Never retry an order with a new `partner_reference`: after a timeout, a lost answer, any `5xx` or a `429`, resend the same body with the same reference. [Create an order safely](https://docs.mart.ps/developers/orders/create-an-order.md)
2. A `200` with `meta.idempotency_replay: true` is the original order, not an error. `409 idempotency_conflict` means the reference names a different order.
3. Never retry a withdrawal with a new `idempotency_key`: that asks for a second withdrawal. [Payout and withdrawals](https://docs.mart.ps/developers/money/payout-and-withdrawals.md)
4. Never poll in a tight loop, and plan within the daily request ceiling. [Request limits](https://docs.mart.ps/developers/operate/request-limits.md)
5. `price` is a snapshot, and an incremental sync (`updated_after`) never shows a price change: re-read every price with a full pass. [Prices and price changes](https://docs.mart.ps/developers/catalogue/prices.md)
6. Identify products by `product_id` and `combination_id`, never `reference`. [Sync the catalogue](https://docs.mart.ps/developers/catalogue/sync.md)
7. Never put an API key in client-side code, an app, a repository or a URL. [Authenticate and keys](https://docs.mart.ps/developers/authenticate.md)
8. Money is in shekels with at most two decimals; a third decimal on a withdrawal is refused, never rounded.

## Check it works

Ask your tool: "How do I retry a Mart order after a timeout?" A connected tool answers: the same `partner_reference` and the same body.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.