Birthday Gift Finder – hand-picked gift ideas

io.github.maggatPublished by GitHub account maggatv1.2.0Updated Oct 26, 2026

Hand-picked gift ideas for birthdays that assistants turn into shareable wishlists fast. SE + US.

The publisher's own server: Finder Jobs

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Remote MCP server that suggests hand-picked Amazon birthday gifts and builds shareable wishlists for US and Swedish storefronts.

What you can do
  • Check server health and list supported Amazon storefronts
  • Search birthday gifts and browse paginated hand-picked catalogs with product links
  • Resolve an ASIN, pasted Amazon product URL or keywords into a tagged buy link
  • Create a wishlist, add items to it, and fetch it by id
  • Create and fill a curated wishlist in one call and return owner and share links
When to use it
Useful when someone wants birthday gift ideas or a shareable wishlist (önskelista, presenttips) for shoppers in the US or Sweden, and you want the assistant to assemble it in one or two calls.
Requirements
A remote streamable HTTP endpoint; no package, account, API key or environment variable is declared. Marketplace defaults come from country and Accept-Language, falling back to amazon.se.
Before you install
Wishlists are created on the server and the editToken returned by create_wishlist is needed to add items, so treat it as a secret. Product links carry the provider's Amazon affiliate tracking tags, and products are curated by the provider rather than customer-reviewed. Anyone with the share link can view the wishlist.

Installation

In SourceWeft

  1. Open Birthday Gift Finder – hand-picked gift ideas in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.maggat%2Fbirthday-gifts/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "birthday-gift-finder-hand-picked-gift-id": {
      "type": "http",
      "url": "https://birthday-gift-finder.vercel.app/api/mcp"
    }
  }
}

Tools

9

get_health

Health & marketplaces

Health check for Birthday Gift Finder. Returns ok, storage, defaultDomain (amazon.se), catalogs for amazon.se and amazon.com with their tracking tags, and marketplaces[]. Use this first. OpenAPI: getHealth.

Takes no parameters.

list_marketplaces

List Amazon marketplaces

List supported Amazon storefronts. amazon.com (US) and amazon.se have hand-picked catalogs with /dp links. Pass marketplace on search/catalog/resolve when you know the user's store; otherwise en-US requests get amazon.com and everything else amazon.se.

Takes no parameters.

search_gifts

Search birthday gifts

Search birthday gifts on the user's Amazon storefront. Pass marketplace=amazon.com for US shoppers (English search), amazon.se for Sweden. Returns search links plus hand-picked catalogMatches with /dp links. OpenAPI: searchAmazon.

ParametersqrequiredlimitlocaleageBandcountryoccasionmarketplacegiftCategory

get_catalog

Curated gift catalog

Paginated hand-picked birthday gifts with /dp buyUrls. marketplace=amazon.com returns the US catalog (English, USD or no price, tag sw-fodelsedag-20); amazon.se the Swedish one (tag sw-fodelsedag-21). OpenAPI: getCatalog.

ParametersqlimitlocaleoffsetcountryoccasionmarketplacegiftCategorygiftCategories

resolve_product

Resolve buy link

Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl on amazon.com or amazon.se (tagged for both). Pass marketplace when known. OpenAPI: resolveProduct.

ParametersurlasinlocalecountrykeywordsoccasionbudgetBandmarketplacegiftCategory

create_wishlist

Create wishlist

Create a birthday gift wishlist. Returns id, editToken, ownerUrl, shopUrl, wishlist, storage. Save editToken for add_wishlist_item. OpenAPI: createWishlist.

ParametersitemslocaleageBandcountryoccasionbudgetBandmarketplacerecipientNamegiftCategories

create_and_fill

One-shot create and fill

One call: create a curated birthday gift wishlist and return shopUrl (share link) + ownerUrl. Preferred agent path: create a wishlist and add ASINs / keywords / search queries in one call. OpenAPI: agentCreateAndFill.

ParameterslocaleageBandcountryoccasionitemAsinsbudgetBanditemQueriesmarketplaceitemKeywordsrecipientNamegiftCategories

get_wishlist

Get wishlist

Fetch a wishlist by id. Returns wishlist items with buyUrl/linkType when available, plus ownerUrl and shopUrl. OpenAPI: getWishlist.

Parametersidrequired

add_wishlist_item

Add wish item

Add an item to a wishlist. Requires editToken from create. OpenAPI: addWishlistItem.

ParametersidrequiredurlasinnameemojititlecatalogIdeditTokenrequiredsearchKeywords

Version history

1
  1. v1.2.0LatestOct 26, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Finder integrations