# QueRegalar.me Agent Instructions

Purpose: manage a user's gift wishlist via HTTP API.

Authentication:
- Ask the user for their QREGALARME_TOKEN.
- Send it as: Authorization: Bearer <QREGALARME_TOKEN>
- Alternative header: X-QRegalarme-Token: <QREGALARME_TOKEN>
- Treat the token as a password. Never expose it in public logs or messages.

Base URL: https://queregalar.me
OpenAPI schema: https://queregalar.me/openapi.json
Agent/MCP page: https://queregalar.me/agent

MCP option:
- Preferred for Codex/Windows/external agents: use the remote MCP endpoint. No local path, WSL, git repo, or npm package required.
- MCP URL: https://queregalar.me/mcp
- MCP auth header: Authorization: Bearer <QREGALARME_TOKEN>
- Tools exposed by the remote MCP server: get_current_user, list_gifts, create_gift, update_gift, delete_gift.
- Example MCP config:
{
  "mcpServers": {
    "queregalarme": {
      "url": "https://queregalar.me/mcp",
      "headers": {
        "Authorization": "Bearer <QREGALARME_TOKEN>"
      }
    }
  }
}
- Local stdio MCP also exists for advanced/self-hosted use, but remote MCP is the default recommendation.

WebMCP (in-browser, no token):
- Public wishlists at https://queregalar.me/u/:username register tools when document.modelContext is available.
- Demo/docs: https://queregalar.me/webmcp
- Demo list: https://queregalar.me/u/ana
- Tools: get_wishlist, get_available_gifts, reserve_gift, draft_group_message
- Humans without WebMCP still use the normal reserve form.

Available HTTP operations:
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 string
- description: optional string
- url: optional product URL
- image_url: optional image URL
- price: optional string
- currency: optional string, e.g. MXN, USD
- priority: alto | normal | bajo
- status: available | reserved | received | hidden

Example create request:
POST https://queregalar.me/api/agent/gifts
Headers:
  Authorization: Bearer <QREGALARME_TOKEN>
  Content-Type: application/json
Body:
{
  "title": "Cafetera moka",
  "description": "De acero, 6 tazas",
  "url": "https://example.com/cafetera",
  "price": "450",
  "currency": "MXN",
  "priority": "alto"
}

If you cannot execute HTTP requests from your environment, tell the user your environment lacks network/tool execution and provide a ready-to-run curl command. Do not claim the API is unavailable.