Model Context Protocol
Let an assistant find and send the gift
GiftRoam exposes a small, tool-only MCP server at mcp.giftroam.com. Claude, ChatGPT and any MCP client can search the catalog, check delivery to a country and date, and hand the user a secure checkout link. The assistant never collects an address and never charges a card — the human confirms and pays on this site.
Zero PII in the conversation
The tool schemas have no name, street, phone or email fields. The chat only carries product, country, date and an optional gift message.
Signed, short-lived links
create_checkout returns a single-purpose URL that expires in 30 minutes and can be revoked. All details and payment happen on checkout.giftroam.com.
Status by token only
After payment the buyer receives an order token. get_order_status accepts only that token and returns coarse, PII-free status.
Tools
| Tool | Input | Output |
|---|---|---|
| search_gifts | country, query?, occasion?, budget_min/max?, limit, cursor | Shortlist with price, delivery days, image, tags |
| get_gift_details | gift_id, country | Full description, contents, delivery window, restrictions |
| check_delivery | country, city?, date_needed?, gift_id? | Feasible? earliest/latest, warnings (PO Box, hotel, holidays) |
| create_checkout | gift_id, country, delivery_date?, gift_card_text?, idempotency_key | Signed 30-minute checkout URL + no-PII summary |
| get_order_status | order_token | Coarse status, ETA, next action — never address/phone/payment |
Connect
Streamable HTTP, stateless, no session required. Public read tools need no auth; get_order_status requires the buyer’s order token.
{
"mcpServers": {
"giftroam": { "url": "https://mcp.giftroam.com/mcp" }
}
}The MCP server (M2) shares this site’s order engine. Until it is published, the same operations are available as JSON at /api/v1 (search, gift details, delivery check, checkout, order status).