Julklappsspel Gifts – hand-picked gift ideas

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

Hand-picked gift ideas for Christmas gift games, turned into shareable wishlists fast.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Remote MCP server that searches curated Amazon gift ideas and builds shareable wishlists for Christmas gift games (julklappsspel / secret santa).

What you can do
  • Check server health and list supported Amazon marketplaces (amazon.com, amazon.se)
  • Search Amazon for party gift ideas and browse a paginated curated gift catalog
  • Resolve an ASIN, pasted Amazon product URL or keywords into a buy link
  • Create a wishlist, or create and fill one in a single call, returning owner and shopper share links
  • Fetch a wishlist by id and add items to it using the edit token from creation
When to use it
Useful when someone wants gift ideas, a present list or a wishlist for a Christmas gift game, secret santa or white elephant, and wants a shareable link to hand to participants. It is a narrow, single-purpose shopping helper rather than a general product search tool.
Requirements
A remote streamable HTTP endpoint; no package, account, API key or environment variable is declared. The assistant should pick a marketplace (amazon.com for US, amazon.se for Sweden); if omitted, en-US requests default to amazon.com and everything else to amazon.se.
Before you install
Creating wishlists writes data to the service and returns an editToken that must be kept to add items later; anyone with the owner or shop link can reach the list. Products are curated by the operator rather than customer-reviewed, and buy links may carry an affiliate tracking tag. Only two Amazon marketplaces are supported.

Installation

In SourceWeft

  1. Open Julklappsspel Gifts – 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%2Fjulklappsspel-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": {
    "julklappsspel-gifts-hand-picked-gift-ide": {
      "type": "http",
      "url": "https://julklappsspel.vercel.app/api/mcp"
    }
  }
}

Tools

9

get_health

Health & marketplaces

Health check for Julklappsspel. Returns ok, storage, paapi, trackingTag, defaultDomain, catalogCount, and marketplaces[] (domain, label, tagConfigured). Use this first. OpenAPI: getHealth.

Takes no parameters.

list_marketplaces

List Amazon marketplaces

List supported Amazon storefronts. Pick the user's marketplace: amazon.com for the US, amazon.se for Sweden. If you omit it, en-US requests get amazon.com and everything else amazon.se.

Takes no parameters.

search_gifts

Search party gifts

Search Amazon for party organizer / julklappsspel gifts on the user's marketplace. Pass marketplace=amazon.com for US shoppers (English, USD budgets) or amazon.se for Sweden; if omitted, en-US gets amazon.com, else amazon.se. OpenAPI: searchAmazon.

ParametersqrequiredlimitlocaleoccasionmarketplacegiftCategory

get_catalog

Curated gift catalog

Paginated curated party gift starters. Pass marketplace=amazon.com for US shoppers (English, USD budgets) or amazon.se for Sweden; if omitted, en-US gets amazon.com, else amazon.se. Search remains primary discovery. OpenAPI: getCatalog.

ParametersqlimitlocaleoffsetoccasionmarketplacegiftCategorygiftCategories

resolve_product

Resolve buy link

Resolve an ASIN, pasted Amazon /dp/ URL, or keywords to a buyUrl (trackingTag null until enrolled). Pass marketplace=amazon.com for US shoppers (English, USD budgets) or amazon.se for Sweden; if omitted, en-US gets amazon.com, else amazon.se. OpenAPI: resolveProduct.

ParametersurlasinlocalekeywordsoccasionbudgetBandmarketplacegiftCategory

create_wishlist

Create wishlist

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

ParametersitemslocalehostNameoccasionbudgetBandmarketplacegiftCategories

create_and_fill

One-shot create and fill

One call: create a curated Christmas gift game (julklappsspel / secret santa) 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.

ParameterslocalehostNameoccasionitemAsinsbudgetBanditemQueriesmarketplaceitemKeywordsgiftCategories

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.