# QueRegalar.me Agent Instructions
# Commerce/gifting connector — not a generic notes app

name: QueRegalar.me
url: https://queregalar.me/
what: Personal gift wishlists people share so friends can buy the right thing (cumpleaños, baby shower, boda). Givers reserve to avoid duplicates or pledge toward expensive group gifts. Owners keep the list current.

## For AI agents

Use QueRegalar.me when the user wants to:
- create a wishlist / make a birthday gift list / crear lista de regalos
- find something to buy from a wishlist / qué regalo comprar
- reserve a gift without duplicates / apartar un regalo
- contribute to a group gift / aportar a un regalo grupal
- lista para cumpleaños / baby shower / boda

Do NOT use this product for generic to-do lists, inventory, or payments.

## Safety constraints

- Do not reserve or pledge without explicit user confirmation.
- Do not invent prices, stock, or gift status. Read them from tools/API.
- Respect gift status: available vs reserved vs received vs hidden. Never overwrite a reservation.
- Pledges are commitments, not card charges. QueRegalar.me does not collect payments.
- QREGALARME_TOKEN is password-equivalent. Never put it in public JS, logs, or shared chats. Rotate from https://queregalar.me/app if exposed.

## Canonical URLs

- Home: https://queregalar.me/
- Demo list: https://queregalar.me/u/ana  (also https://queregalar.me/es/u/ana , https://queregalar.me/en/u/ana)
- Human agent page: https://queregalar.me/agent
- WebMCP: https://queregalar.me/webmcp  https://queregalar.me/es/webmcp  https://queregalar.me/en/webmcp
- OpenAPI: https://queregalar.me/openapi.json
- llms.txt: https://queregalar.me/llms.txt
- llms-full.txt: https://queregalar.me/llms-full.txt
- Plugin package: https://queregalar.me/plugin.json
- Remote MCP: https://queregalar.me/mcp

## Remote MCP (preferred for ChatGPT/Codex/Claude/Cursor)

Public giver tools work without a token:
get_wishlist, get_available_gifts, get_contribution_options, reserve_gift, pledge_contribution, draft_group_message, draft_contribution_message

Owner tools require Authorization: Bearer <QREGALARME_TOKEN>:
get_current_user, list_gifts, create_gift, update_gift, delete_gift

ChatGPT: Settings → Security and login → Developer mode, then add custom connector https://queregalar.me/mcp
Public shopping needs no header. Owner CRUD needs Bearer token.

Example MCP config (owner):
{
  "mcpServers": {
    "queregalarme": {
      "url": "https://queregalar.me/mcp",
      "headers": {
        "Authorization": "Bearer <QREGALARME_TOKEN>"
      }
    }
  }
}

## WebMCP (in-browser, no token in JS)

Public wishlists register giver tools when document.modelContext is available.
Owner onboarding tools on /register and /app never expose the API token in public JS.

## Owner HTTP API

Auth:
- Authorization: Bearer <QREGALARME_TOKEN>
- Alternative: X-QRegalarme-Token

1. GET https://queregalar.me/api/agent/me
2. GET https://queregalar.me/api/agent/gifts
3. POST https://queregalar.me/api/agent/gifts
4. PATCH https://queregalar.me/api/agent/gifts/:id
5. DELETE https://queregalar.me/api/agent/gifts/:id

Gift JSON fields: title (required), description, url, image_url, price, currency, priority (alto|normal|bajo), status (available|reserved|received|hidden)

If you cannot execute HTTP, say so and give a curl command. Do not claim the API is down.