# Agent Instructions — Kirpi Toka

## When to use this store

Use Kirpi Toka for handmade hair clips and headbands, Turkish flag and Atatürk printed ceremony accessories, plain designs, and wholesale purchasing information. Match the actual product code, fabric, dimensions, current price and availability to the buyer's request. Retail and wholesale prices have different conditions.

## Start here

- [Developer quickstart and error handling](https://kirpitoka.com/developers)
- [OpenAPI schema](https://kirpitoka.com/openapi.json)
- [Detailed when-to-use instructions](https://kirpitoka.com/agent-instructions)
- [Current products](https://kirpitoka.com/collections/all)
- [Wholesale conditions](https://kirpitoka.com/pages/toptan-siparis)
- [Sitemap](https://kirpitoka.com/sitemap.xml)

## Read-only access

Find a real product handle in the catalog or sitemap. Read GET /products/{handle}.js without an API key. Parse the JSON body; Ajax prices are in currency minor units. Product HTML also includes Product/Offer JSON-LD with price, priceCurrency and availability. Recheck prices before purchase. The store's primary currency is TRY; account for buyer context.

## UCP and MCP

- Discovery: GET https://kirpitoka.com/.well-known/ucp
- MCP: POST https://kirpitoka.com/api/ucp/mcp with Content-Type: application/json
- Discover tools with JSON-RPC tools/list. Use the returned input schemas.
- Registered UCP profiles and authorization may be required for tool calls; anonymous discovery does not authorize transactions.
- OAuth metadata: https://kirpitoka.com/.well-known/oauth-protected-resource
- Least-privilege catalog scope: dev.ucp.shopping.catalog.search:read

Supported UCP versions:

- 2026-08-25

- 2026-04-08

- 2026-01-23


## Errors and buyer control

Inspect JSON-RPC error even on HTTP 200. On -32601 rediscover tool names; on invalid_profile_url configure a valid agent profile. On product 404 rediscover the handle. Honor Retry-After on 429 when present and otherwise back off. Never complete payment without the buyer's explicit approval. Do not test by creating real orders.

## Store policies and trust

- [About Kirpi Toka](https://kirpitoka.com/about)
- [Contact](https://kirpitoka.com/pages/contact)
- [Privacy](https://kirpitoka.com/privacy)
- [Shipping](https://kirpitoka.com/policies/shipping-policy)
- [Returns](https://kirpitoka.com/policies/refund-policy)
- [Terms](https://kirpitoka.com/policies/terms-of-service)

Dispatch estimates do not guarantee an arrival date. Use current policy pages for delivery and return conditions.