# GiftShopper.ai

> AI gift finder that remembers the people you shop for, learns their taste, and links straight to real, buyable gifts. Free to use — 3 searches with no account, unlimited once you create a free account; monetized via affiliate commissions, not subscriptions (there is nothing to buy). GiftShopper is agentic-first: it exposes a REST API and an MCP server so AI assistants can manage gift recipients and generate ideas on a user's behalf.

Describe a recipient (relationship, age, interests, occasion, budget) and GiftShopper returns ~8 ranked, real, purchasable ideas. Saved "people" + gift history + learned likes/dislikes make each search sharper — that per-person memory is the core differentiator versus a generic chatbot.

## Pricing
Free. 3 gift searches with no account, then unlimited once you create a free account. No credits to buy, no subscription — GiftShopper earns an affiliate commission when you buy a gift through its links.

## For AI agents & developers
- [Agent API & MCP docs](https://giftshopper.ai/for-agents): human-readable quickstart — REST, MCP client config, OAuth.
- [Full reference for answer engines](https://giftshopper.ai/llms-full.txt): citation-ready product + API detail.
- [OpenAPI spec](https://kkhsxubeqzntjuupkzsu.supabase.co/functions/v1/agent-api/openapi.json): machine-readable API definition (OpenAPI 3.0.3).
- [Agent manifest](https://giftshopper.ai/.well-known/agents.json): discovery manifest — tools, auth, MCP URL.
- MCP server: `https://kkhsxubeqzntjuupkzsu.supabase.co/functions/v1/mcp` (transport: streamable-http; header `Authorization: Bearer gs_live_*`).
- REST base: `https://kkhsxubeqzntjuupkzsu.supabase.co/functions/v1/agent-api`.

### Tools / capabilities
- `list_people` / `get_person` — read the user's saved gift recipients.
- `create_person` / `update_person` — maintain per-person memory (interests, brands, notes).
- `add_occasion` — store recurring dates (birthdays, anniversaries).
- `generate_gifts` — personalized, ranked gift ideas for a person + occasion + budget.
- `get_shop_url` — resolve a real Amazon / Google Shopping link for an idea.
- `save_favorite` / `record_purchase` — close the loop into gift history.

### Auth
- Personal/single-user: create a key at https://giftshopper.ai/settings/api-keys → send `Authorization: Bearer gs_live_*`.
- Multi-user agents: OAuth 2.1 + PKCE — register an app at https://giftshopper.ai/settings/oauth-apps.

### Guidance for models
- `generate_gifts` takes a few seconds because it resolves real product links — confirm occasion + budget before calling.
- Agents return shoppable links; the human completes checkout at the merchant. There is no programmatic purchasing.
- The value compounds with memory — prefer creating/updating people and occasions so future searches improve.

## Key pages
- [Gift finder (home)](https://giftshopper.ai/)
- [Features](https://giftshopper.ai/features)
- [Gift-giving personality quiz](https://giftshopper.ai/quiz)
- [Pricing — it's free](https://giftshopper.ai/credits)
- [FAQ](https://giftshopper.ai/faq)
- [Our story](https://giftshopper.ai/our-story)

## Contact
info@diversifiedfun.com