# Girlfriend Gifts – hand-picked gift ideas

> Hand-picked gift ideas for her (partner gifts), turned into shareable wishlists fast.

- name: io.github.maggat/girlfriend-gifts
- version: 1.2.0
- connection class: R0 (autonomous)
- trust: 79/100 flags: no-repository
- quality: 80/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.maggat%2Fgirlfriend-gifts
- tools: https://api.protogrid.dev/v1/servers/io.github.maggat%2Fgirlfriend-gifts/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "girlfriend-gifts": {
      "type": "http",
      "url": "https://girlfriendgifts.vercel.app/api/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 98
- freshness: 100
- provenance: 45
- drivers: +website +reachable +uptime-96% +updated-13d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 80/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 9 of 9 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_health (destructiveHint, idempotentHint); list_marketplaces (destructiveHint, idempotentHint); search_gifts (destructiveHint, idempotentHint); …
- pass `tools.token_cost`: about 2,543 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 7 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 9, about 2,543 tokens to load them all
- tool set hash: 143c82857947eace55a66ea6f5996fd7
- tools last changed: 2026-10-26T11:26:29.401Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.maggat/girlfriend-gifts.svg)](https://protogrid.dev/servers/io.github.maggat/girlfriend-gifts)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-26 `add_wishlist_item` changed (inputSchema)
- 2026-10-26 `create_and_fill` changed (inputSchema)
- 2026-10-26 `create_wishlist` changed (inputSchema)
- 2026-10-26 `resolve_product` changed (inputSchema)
- 2026-10-26 `get_catalog` changed (description, inputSchema)
  - before: Curated girlfriend/wife gift catalog (170+ real amazon.se /dp ASINs) for building shopping lists and wishlists. On amazon.se items include /dp/ASIN buy links (tag sw-girlfriend-21 when configured); on other marketplaces catalogMode is search-ideas. ALWAYS pass marketplace + locale. OpenAPI: getCatalog.
  - after: Curated girlfriend/wife gift catalogs for building shopping lists and wishlists: 245 amazon.se /dp ASINs (default) and a separate US catalog of ASINs verified live on amazon.com (pass marketplace=amazon.com → https://www.amazon.com/dp/ASIN buy links, tagged with the server-configured amazon.com tag when set). On other marketplaces catalogMode is search-ideas. ALWAYS pass marketplace + locale. OpenAPI: getCatalog.
- 2026-10-26 `search_gifts` changed (inputSchema)
- 2026-10-26 `get_health` changed (description)
  - before: Health check for Girlfriend Gifts romantic gift inspiration. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount, marketplaceIds. Use list_marketplaces to discover storefronts. OpenAPI: getHealth.
  - after: Health check for Girlfriend Gifts romantic gift inspiration. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount (amazon.se), catalogCounts per storefront (amazon.se + amazon.com), marketplaceIds. Use list_marketplaces to discover storefronts. OpenAPI: getHealth.

Full history: https://api.protogrid.dev/v1/servers/io.github.maggat%2Fgirlfriend-gifts/changes

## Remotes

- https://girlfriendgifts.vercel.app/api/mcp (streamable-http, auth none, reachable true, uptime30d 0.9591837)

## Packages

_none_

## Tools (9)

- `add_wishlist_item`: Add an item to a gift list / wishlist (shopping-list building). Requires editToken from create. Body: name/title plus asin, url (pasted /dp), searchKeywords, or catalogId. Token storage may return a new id — update bookmarks. Prefer buyUrl in responses. OpenAPI: addWishlistItem.
- `create_and_fill`: Preferred agent path for list-building: create a gift wishlist and fill it with ASINs / keywords / search queries in one call. Returns id, editToken, ownerUrl, shopUrl. Pass marketplace + locale. OpenAPI: agentCreateAndFill.
- `create_wishlist`: Create a girlfriend/wife gift list / wishlist for shopping-list building. Returns id, editToken, ownerUrl (she edits), shopUrl (he/agent shops), wishlist, storage. Save editToken for add_wishlist_item. If storage is token, later mutations may return a new id — always use the latest. OpenAPI: createWishlist.
- `get_catalog`: Curated girlfriend/wife gift catalogs for building shopping lists and wishlists: 245 amazon.se /dp ASINs (default) and a separate US catalog of ASINs verified live on amazon.com (pass marketplace=amazon.com → https://www.amazon.com/dp/ASIN buy links, tagged with the server-configured amazon.com tag when set). On other marketplaces catalogMode is search-ideas. ALWAYS pass marketplace + locale. OpenAPI: getCatalog.
- `get_health`: Health check for Girlfriend Gifts romantic gift inspiration. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount (amazon.se), catalogCounts per storefront (amazon.se + amazon.com), marketplaceIds. Use list_marketplaces to discover storefronts. OpenAPI: getHealth.
- `get_wishlist`: Fetch a wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.
- `list_marketplaces`: List supported Amazon storefronts (id, domain, label, defaultLocale, currencyHint, tagConfigured). Agents MUST pick the user's marketplace and pass it on search/catalog/resolve.
- `resolve_product`: Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (product /dp or romantic search). ALWAYS pass marketplace + locale for the user. Does not invent Associates tags — uses server-configured tags per storefront. OpenAPI: resolveProduct.
- `search_gifts`: Search Amazon for romantic partner gifts to build a recommendation or shopping list. Returns PA-API products when configured for the default storefront, otherwise romantic search deep-link cards + catalogMatches. ALWAYS pass marketplace + locale. OpenAPI: searchAmazon.