Giftroam

com.giftroamPublished by giftroam.comOfficial publisherv0.3.0Updated Oct 24, 2026

Send real gifts to 190+ countries: search, check delivery, get a secure checkout link.

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

Giftroam lets an assistant search gifts deliverable to 190+ countries, check delivery feasibility, create a secure checkout link, and track orders.

What you can do
Search gifts by destination country, occasion, budget and needed-by date, with final prices and delivery days, paginated by cursor. Get full details for one gift in one country: contents, images, price, delivery window, substitution policy and restrictions. Check whether delivery to a country, city or date is feasible, with estimates and warnings. Create a signed, single-purpose checkout link valid for 30 minutes, returning an order summary. Look up order status and next action by the buyer's private order token. List the signed-in user's orders with status, ETA, gift, destination and tracking token.
When to use it
Useful when someone wants to send a real gift abroad and needs help choosing something deliverable, confirming it can arrive by a date, or getting a link to complete payment securely. Also handy for checking the status of an existing order.
Requirements
A remote endpoint at mcp.giftroam.com over streamable HTTP; no local runtime, packages or environment variables. Listing the user's own orders requires an authenticated Giftroam connection via OAuth with the orders:read scope; guest connections get auth_required.
Before you install
Checkout links lead to a secure page where the recipient's name, address, phone, delivery details and payment are collected; the assistant never handles them. Creating a checkout link is a step toward a real purchase, so confirm the gift, destination and price first. Order lookup relies on the buyer's private order token, which is the only credential; treat it as sensitive. Order tools never return addresses, phone numbers or payment details.

Installation

In SourceWeft

  1. Open Giftroam 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/com.giftroam%2Fgiftroam/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": {
    "giftroam": {
      "type": "http",
      "url": "https://mcp.giftroam.com/mcp"
    }
  }
}

Tools

6

search_gifts

Search gifts deliverable to a country

Find gifts that can be delivered to a destination country, optionally filtered by free text, occasion, budget (minor units) and a needed-by date. Returns a shortlist with final customer prices (delivery included) and delivery days. Paginate with cursor.

Parameterslimitquerycursorlocalecountryrequiredoccasionbudget_maxbudget_mindate_needed

get_gift_details

Get gift details

Full description, contents, images, customer price, estimated delivery window (EST cutoff-aware), substitution policy and restrictions for one gift in one destination country.

Parameterslocalecountryrequiredgift_idrequired

check_delivery

Check delivery feasibility

Is delivery to a country (optionally a city, by a date, for a specific gift) feasible? Returns earliest/latest estimate and warnings (PO box, hotel, holiday window) with a suggested action.

Parameterscitylocalecountryrequiredgift_iddate_needed

create_checkout

Create a checkout link

Create a signed, single-purpose checkout link (30-minute expiry) for one gift to one country. The schema has no recipient fields on purpose: name, address, phone, delivery details and payment are collected on the secure page. Returns an order summary with the link. Retries with the same idempotency_key return the same link.

Parameterslocalecountryrequiredgift_idrequiredquantitydelivery_dategift_card_textidempotency_keyrequired

get_order_status

Get order status

Customer-facing status, ETA window and next action for an order. Looked up by the buyer's private order token, issued after payment; the token is the only credential. Never returns address, phone or payment details.

Parameterslocaleorder_tokenrequired

list_my_orders

List my orders (signed-in)

The signed-in user's GiftRoam orders: status, ETA window, gift, destination and the order token for tracking. Requires the authenticated GiftRoam connection (OAuth, scope orders:read); on a guest connection it returns auth_required. Never returns addresses, phone numbers or payment details.

Parameterslimitlocale

Version history

1
  1. v0.3.0LatestSep 16, 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.