A
licenseA
qualityD
maintenanceSend real physical postcards worldwide via AI agents. Supports single and bulk send (up to 500 recipients), balance checking, delivery tracking, and volume pricing from $0.72/card.
5
17
5
MIT
giftroam
by com.giftroam
Server Details
Send real gifts to 190+ countries: search, check delivery, get a secure checkout link.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP
- URL
Glama MCP Gateway
Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.
MCP client
Glama
MCP server
Full call logging
Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.
Tool access control
Enable or disable individual tools per connector, so you decide what your agents can and cannot do.
Managed credentials
Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.
Usage analytics
See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.
100% free. Your data is private.
Tool Definition Quality
Score is being calculated. Check back soon.
Available Tools
6 toolscheck_deliveryCheck delivery feasibilityRead-onlyIdempotentInspect
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. Use it whenever the user has a deadline.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | Destination city (used for warnings only; never store addresses in chat). | |
| locale | No | Language of the conversation with the user (e.g. he-IL, fr-FR). Localizes content and messages; prices and availability are unaffected. | |
| country | Yes | Destination country, ISO-3166 alpha-2. | |
| gift_id | No | Optional gift_id to use that gift's delivery window. | |
| date_needed | No | YYYY-MM-DD the gift must arrive by. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| error | No | Present only when the call failed |
| latest | No | ISO date of the latest estimated delivery |
| locale | No | BCP-47 locale the texts are localized to |
| earliest | No | ISO date of the earliest estimated delivery |
| feasible | No | |
| warnings | No | |
| display_text | No | Human-readable one-line summary of the result |
| business_days | No | |
| suggested_action | No |
create_checkoutCreate a checkout linkIdempotentInspect
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. Show the returned summary and get the user's explicit confirmation before sharing the link. Use the same idempotency_key when retrying.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| locale | No | Language of the conversation with the user (e.g. he-IL, fr-FR). Localizes content and messages; prices and availability are unaffected. The checkout page opens in this language. | |
| country | Yes | Destination country, ISO-3166 alpha-2. | |
| gift_id | Yes | gift_id from search_gifts. | |
| quantity | No | Always 1 in v1. | |
| delivery_date | No | Requested delivery date YYYY-MM-DD; omit for as-soon-as-possible. | |
| gift_card_text | No | Card message (≤180 chars) if the user already gave one. | |
| idempotency_key | Yes | Client-generated key; retries with the same key return the same link. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| error | No | Present only when the call failed |
| locale | No | BCP-47 locale the texts are localized to |
| summary | No | |
| expires_at | No | |
| checkout_url | No | Single-purpose secure checkout link on checkout.giftroam.com (30-minute expiry) |
| display_text | No | Human-readable one-line summary of the result |
get_gift_detailsGet gift detailsRead-onlyIdempotentInspect
Full description, contents, images, customer price, estimated delivery window (EST cutoff-aware), substitution policy and restrictions for one gift in one destination country.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| locale | No | Display language for gift content (e.g. he-IL). Prices and availability are unaffected. | |
| country | Yes | Destination country, ISO-3166 alpha-2. | |
| gift_id | Yes | gift_id from search_gifts (or the gift's URL slug). |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| gift | No | |
| error | No | Present only when the call failed |
| locale | No | BCP-47 locale the texts are localized to |
| display_text | No | Human-readable one-line summary of the result |
get_order_statusGet order statusRead-onlyIdempotentInspect
Customer-facing status, ETA window and next action for an order. Requires the buyer's order token (delivered after payment) — the token is the credential; never guess or enumerate tokens. Never returns address, phone or payment details.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| locale | No | Language of the conversation with the user (e.g. he-IL, fr-FR). Localizes content and messages; prices and availability are unaffected. | |
| order_token | Yes | The order token from the buyer's confirmation (GR-XXXXX-…). Never guess tokens. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| gift | No | |
| error | No | Present only when the call failed |
| locale | No | BCP-47 locale the texts are localized to |
| status | No | Machine status, e.g. confirmed | on_the_way | delivered | needs_attention |
| country | No | |
| updated_at | No | |
| next_action | No | |
| display_text | No | Human-readable one-line summary of the result |
| status_label | No | |
| delivery_date | No | |
| estimated_window | No |
list_my_ordersList my orders (signed-in)Read-onlyIdempotentInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| locale | No | Language of the conversation with the user (e.g. he-IL, fr-FR). Localizes content and messages; prices and availability are unaffected. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| error | No | Present only when the call failed |
| total | No | |
| locale | No | BCP-47 locale the texts are localized to |
| orders | No | |
| display_text | No | Human-readable one-line summary of the result |
search_giftsSearch gifts deliverable to a countryRead-onlyIdempotentInspect
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. Country is required — ask for it first.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| query | No | Product keywords only, 1-4 words (e.g. 'chocolate basket', 'red roses'). Do NOT include the destination, recipient or occasion here - use the country/occasion fields. Omit for a general browse. | |
| cursor | No | Opaque cursor from a previous page. | |
| locale | No | Display language for results (e.g. he-IL). The query may be typed in that language. | |
| country | Yes | Destination country, ISO-3166 alpha-2 (e.g. FR). | |
| occasion | No | Occasion slug from the occasions resource (e.g. birthday). | |
| budget_max | No | Maximum price in minor units (cents). | |
| budget_min | No | Minimum price in minor units (cents). | |
| date_needed | No | YYYY-MM-DD; only gifts that can arrive by then. |
Output Schema
ParametersJSON Schema
| Name | Required | Description |
|---|---|---|
| error | No | Present only when the call failed |
| total | No | |
| locale | No | BCP-47 locale the texts are localized to |
| country | No | |
| results | No | |
| next_cursor | No | |
| date_warning | No | Present when the requested needed-by date is unreachable: results are shown WITHOUT the date filter |
| display_text | No | Human-readable one-line summary of the result |
Claim this connector by publishing a /.well-known/glama.json file on your server's domain with the following structure:
{
"$schema": "https://glama.ai/mcp/schemas/connector.json",
"maintainers": [{ "email": "your-email@example.com" }]
}The email address must match the email associated with your Glama account. Once published, Glama will automatically detect and verify the file within a few minutes.
Control your server's listing on Glama, including description and metadata
Access analytics and receive server usage reports
Get monitoring and health status updates for your server
Feature your server to boost visibility and reach more users
For users:
Full audit trail – every tool call is logged with inputs and outputs for compliance and debugging
Granular tool control – enable or disable individual tools per connector to limit what your AI agents can do
Centralized credential management – store and rotate API keys and OAuth tokens in one place
Change alerts – get notified when a connector changes its schema, adds or removes tools, or updates tool definitions, so nothing breaks silently
For server owners:
Proven adoption – public usage metrics on your listing show real-world traction and build trust with prospective users
Tool-level analytics – see which tools are being used most, helping you prioritize development and documentation
Direct user feedback – users can report issues and suggest improvements through the listing, giving you a channel you would not have otherwise
The connector status is unhealthy when Glama is unable to successfully connect to the server. This can happen for several reasons:
The server is experiencing an outage
The URL of the server is wrong
Credentials required to access the server are missing or invalid
If you are the owner of this MCP connector and would like to make modifications to the listing, including providing test credentials for accessing the server, please contact support@glama.ai.
Discussions
No comments yet. Be the first to start the discussion!
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables gift recommendations via Naver Shopping and nearby pickup store search via Kakao Local APIs.
- FlicenseAqualityBmaintenanceA dedicated MCP and REST service that searches grocery retailers directly and returns reviewable product links, enabling users to find products and create handoffs without adding to carts or placing orders.7
- FlicenseNot gradedqualityCmaintenanceBuy video game keys, gift cards, and digital subscriptions via x402 USDC payments on Base. 8 tools covering catalog search, price quotes, on-chain purchase confirmation, delivery status, and refunds.