Global Shopaholics
● Activeio.github.xuniwattoo/gs-mcp
Buy from any US store for you: ship worldwide or in the US, find it cheaper, pay in crypto.
Connect this server
One click to install, or copy the config below. Suits: Cursor · HTTP clients.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"gs-mcp": {
"url": "https://mcp.globalshopaholics.com/mcp"
}
}
}claude mcp add --transport http gs-mcp https://mcp.globalshopaholics.com/mcpcode --add-mcp '{"name":"gs-mcp","type":"http","url":"https://mcp.globalshopaholics.com/mcp"}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- Crypto & Web3
- Version
- 1.2.0
- Registry
- active
- Published
- 11/18/2026
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Looks healthy: Global Shopaholics is maintained, open source, hosted endpoint answering without a key.
- Maintained
- Active
- Last commit 4 days ago (Nov 18, 2026), 0 open issues.
- Official registry
- Active
- Published as io.github.xuniwattoo/gs-mcp in the official MCP registry, version 1.2.0.
- Source
- Open source, MIT
- Public repository under the MIT licence, 0 stars, 0 forks.
- Runs
- Hosted by the publisher
- Your client talks to mcp.globalshopaholics.com: prompts and tool arguments leave your machine for that host.
- Credentials
- None needed to connect
- The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.
Live check
checked Nov 22, 2026, 00:07 UTCStatus history & uptime →The endpoint answered the MCP handshake as "Global Shopaholics – buy from any US store, ship worldwide or within the US, pay in crypto" and listed 11 tools. Answering since Nov 18, 2026.
Context cost ≈ 5.2k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 11 tools.
Tools (11)
get_shipping_rates8 paramsLive shipping prices from Global Shopaholics' US warehouse (Delaware) to a destination country, for DHL, FedEx, UPS and USPS services. Returns each service's USD price, transit time, max weight/size, insurance terms and whether dimensional weight applies, sorted cheapest first. Prices exclude import duties/taxes. Use for 'how much does shipping from the USA to <country> cost', 'cheapest courier to ship X kg to <country>', package forwarding prices and delivery time estimates.
Show parametersHide parameters
countrystringrequiredDestination country: ISO 2-letter code (AO, SA, AE, GB, NG...) or name ('Angola').citystringDestination city. Defaults to the capital GS's calculator uses.zipstringDestination postal code. Defaults to the calculator's capital zip (00000 where none).weightnumberrequiredPackage weight (0.1–275 in the chosen unit; decimals OK). Use the expected consolidated box weight.unitstringUnit for weight. Dimensions use cm with kg, inches with lb.lengthnumberBox length (cm if kg, in if lb). Optional; improves accuracy because dimensional weight applies.widthnumberBox width.heightnumberBox height.
estimate_landed_cost12 paramsEstimates what a buyer pays in total to get US goods delivered: item price, optional US sales tax, GS Assisted Purchase fee, live GS shipping (if package weight given) and import duty, VAT/GST and fees for the destination. Duty is per product category (phones, laptops, clothing, shoes, bags, cosmetics, perfume, watches, jewelry, toys, supplements, auto parts, tools, books and more) from GS's sourced rules for ${PROFILES.length} countries (Angola, Saudi Arabia, UAE, Australia, UK, all EU countries, Canada, Malaysia, Zambia, India, Algeria, Qatar, Pakistan, Nigeria, Brazil, South Africa, Japan, Korea and more), with de minimis thresholds, valuation basis (CIF/FOB), special courier regimes and who collects. Other countries use an external tariff lookup by HS code. Pass items[] (description and/or category or hs_code, unit price, quantity) for per-item results; the agent should infer the category. Returns a central estimate plus a low–high range, sources and last-checked dates. Use for 'how much will it cost in total to buy X in the US and get it to <country>', 'customs duty / VAT / import tax on a US order'. Results are ESTIMATES, not quotes.
Show parametersHide parameters
destination_countrystringrequiredISO 2-letter code or country name.items_total_usdnumberTotal price of the items in USD (all quantities). Optional when items is given.itemsarrayItem lines for per-category duty and tax. Recommended.us_sales_tax_pctnumberUS sales tax % if the store charges it. Default 0 (GS address is in Delaware: no sales tax).assisted_purchasestring'standard' if GS buys it for you; 'none' if the shopper buys and ships to their GS address.payment_methodstringHow the GS invoice will be paid. Bank transfer or crypto: 0% standard assisted-purchase fee.shipping_usdnumberKnown shipping cost. Omit and pass package to fetch live GS rates.packageobjectPackage for a live shipping quote.preferred_carrierstringPick the cheapest service of this carrier (DHL, FedEx, UPS, USPS).item_categoriesintegerDistinct product types (EU €3-per-category duty). Default 1.hs_codestringOptional HS code for a single-item order (when items is omitted).categorystringOptional category id for a single-item order (when items is omitted).
get_services_and_fees1 paramGlobal Shopaholics' services (US address, consolidation, Assisted Purchase, shipping), subscription plans (Basic free, Premium $9.99/mo, Business $14.99/mo) and published fees (incl. Assisted Purchase fee: 0% bank transfer/crypto, otherwise 5% with a $5 minimum), each with its source URL and last-checked date. Use when a user asks what GS costs, how to pay, or what services exist.
Show parametersHide parameters
topicstringNarrow the answer.
get_started1 paramStep-by-step instructions to sign up for a free Global Shopaholics US shipping address and start shopping and shipping. Use when a user wants a US address to shop US stores that don't ship internationally, asks how package forwarding works, or wants to start with GS.
Show parametersHide parameters
countrystringOptional: user's country, to tailor tips.
request_assisted_purchase11 paramsBuy-it-for-me: sends an Assisted Purchase request to the Global Shopaholics team, for when the user wants something from a US store (including stores that refuse foreign cards or addresses) shipped to them. GS checks price/availability, confirms the total with the customer by email, buys from the US store, and ships it. Nothing is charged by this tool and no payment happens in chat; GS emails an invoice. Legal items only. Only call after the user has confirmed product link(s), quantity, destination, name and email. Returns a reference id and next steps.
Show parametersHide parameters
product_urlsarrayrequiredProduct page URL(s) at US stores (http or https).quantityintegervariantstringSize/color/model details.budget_usdnumberMax the customer wants to spend on items.destination_countrystringrequireddestination_citystringpayment_methodstringPreferred payment method.notesstringnamestringrequiredCustomer full name.emailstringrequiredCustomer email; GS replies here.phonestringOptional phone/WhatsApp with country code.
request_us_purchase12 paramsUS domestic buy-it-for-me. Global Shopaholics (GS) can buy from any US online store and ship it to a US address – not only abroad. Use when someone inside the US wants GS to buy an item for them, find it cheaper (other stores, coupons, price matching, outlet deals – prices are never guaranteed), or get an item from a store that won't ship to them: Hawaii, Alaska, Puerto Rico, Guam/USVI and APO/FPO/DPO military addresses, per-customer item limits, or stores that need a US card. Only the ship-to state and ZIP are needed now; GS collects the full address when it confirms the order. Nothing is charged by this tool. GS emails the customer the confirmed total before buying. Fees: 0% when paying by crypto/stablecoins or bank transfer, otherwise 5% with a $5 minimum. Once GS confirms a total, the customer can pay by crypto through create_crypto_payment. Legal items only. Call after the user confirms the product link(s), quantity, ship-to state/ZIP, name and email.
Show parametersHide parameters
product_urlsarrayrequiredProduct page URL(s) at US stores (http or https).quantityintegervariantstringSize/color/model details.max_price_usdnumberMost the customer will pay for the items.find_lower_pricebooleanTrue if GS should also look for a lower price (other stores, coupons, price matching, outlet).ship_to_statestringrequiredUS state, DC or territory code (e.g. HI, AK, PR) or AA/AE/AP for APO/FPO/DPO.ship_to_zipstringrequired5-digit ZIP (or ZIP+4).payment_methodstringPreferred payment method.notesstringnamestringrequiredCustomer full name.emailstringrequiredCustomer email; GS replies here.phonestringOptional phone/WhatsApp with country code.
request_shipment_quote10 paramsSends a shipping request to the Global Shopaholics team for a manual quote or help with a shipment, labels or customs paperwork (e.g. heavy/oversize items, freight, multiple boxes). Nothing is charged. Call only after the user confirms details. Returns a reference id and next steps. For instant prices use get_shipping_rates instead.
Show parametersHide parameters
destination_countrystringrequireddestination_citystringcontentsstringrequiredWhat is being shipped.declared_value_usdnumberpackagesarrayBoxes (weight + optional dimensions).needsarraynotesstringnamestringrequiredCustomer full name.emailstringrequiredCustomer email; GS replies here.phonestringOptional phone/WhatsApp with country code.
find_lower_price2 paramsSearches Google Shopping (US) for a product and returns the cheapest US offers: store, price, link, rating and the savings versus the user's current price. Use when someone asks 'find this cheaper', 'best price for…', 'is there a better deal' or 'where can I buy this in the US'. Pass a product name (brand + model is best) or a product URL, plus the current price if known. Prices are indicative only – they can change, exclude tax/shipping and may differ at checkout – so never promise them. Links go straight to the retailer's product page where found (direct_link=true), otherwise to a Google Shopping link; they are never affiliate links. GS can buy the cheapest legitimate option for the customer and ship it anywhere in the US or worldwide: submit it with request_us_purchase (US delivery) or request_assisted_purchase (international), and GS confirms the total by email first. Fees: 0% when paying by crypto or bank transfer, otherwise 5% with a $5 minimum; crypto checkout is available via create_crypto_payment once GS quotes a total. Limited to a few searches per hour per client.
Show parametersHide parameters
productstringrequiredProduct name (brand + model) or a product page URL.current_price_usdnumberWhat the customer would pay now, to compute savings.
create_crypto_payment4 paramsCreates a Global Shopaholics crypto checkout (BTCPay invoice, priced in USD) and returns the checkout link, invoice id and expiry. Use ONLY after GS has quoted a total, or for an amount the customer has already agreed with GS (e.g. an assisted-purchase or shipping quote) – never to guess a price. Paying in crypto carries 0% GS assisted-purchase fee, so mention that when offering it. Confirm the amount, description and customer email with the user first. The invoice expires in 60 minutes; the customer pays at the link, not in chat. Amount limit: $0.50–$10,000 USD.
Show parametersHide parameters
amount_usdnumberrequiredTotal to pay in USD, as quoted by GS (max 10,000).descriptionstringrequiredWhat the payment is for, e.g. 'Assisted purchase GSMCP-AP-… incl. shipping'.emailstringrequiredCustomer email; the invoice is linked to it and GS follows up here.referencestringGS reference or quote number (e.g. GSMCP-AP-…), if there is one.
get_crypto_payment_status1 paramReturns the status (New, Processing, Settled, Expired, Invalid) of a GS crypto invoice created with create_crypto_payment, given its invoice id. Read-only.
Show parametersHide parameters
invoice_idstringrequiredInvoice id returned by create_crypto_payment.
track_shipment2 paramsReturns the official carrier tracking URL for a DHL, FedEx, UPS or USPS tracking number (carrier auto-detected from the number format if not given). GS ships with these carriers and emails the tracking number on dispatch.
Show parametersHide parameters
tracking_numberstringrequiredcarrierstring
Checked by Serverdex with a plain initialize + tools/list call to mcp.globalshopaholics.com/mcp, no credentials, about once a day. A failed check is never a removal.
On GitHub
read Nov 18, 2026- Stars
- 0
- Forks
- 0
- Last push
- Nov 18, 2026
- License
- MIT
TypeScriptcloudflare-workersmcpmodel-context-protocolpackage-forwardingshipping
From the README
Global Shopaholics MCP server A public, remote Model Context Protocol server that lets any AI agent (Claude, ChatGPT, Cursor, Grok, …) help a person anywhere buy from any US store and ship it through Global Shopaholics (GS). It only wraps what GS already has: the website's live rate engine, published fees/plans, the sign-up flow, the Assisted Purchase request process and carrier tracking. Duty/VAT figures come from GS's sourced per-country, per-product-category rules (87 countries; see docs/duties.md) and are always labelled estimates with a range. • Transport: Streamable HTTP (stateless, JSON responses) at /mcp, plus a stdio entry. • Runtime: web-standard Request/Response → runs on Cloudflare Workers (primary), Vercel, or any Node ≥ 20 host (Cloudways). • No auth for read tools. Lead tools are rate-limited per IP (hourly), per email (daily) and by a global daily cap; rate-lookup tools have a per-IP hourly cap. On Cloudflare Workers these limits live in a SQLite Durable Object; Node/Vercel fall back to a per-process in-memory limiter. Tools Resource: gs://about (markdown overview). Prompt: buy-and-ship. Run locally npm run build && npm start runs the compiled Node server (dist/entry/node.js). Connect an AI agent Public MCP URL (Streamable HTTP, free, no sign-up, no auth): https://mcp.globalshopaholics.com/mcp.…
Read the full README on GitHub →Remotes
- streamable-http
https://mcp.globalshopaholics.com/mcp
Alternatives to Global Shopaholics
All Global Shopaholics alternatives →Best Crypto & Web3 servers →The most-starred Crypto & Web3 servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Oh My Posh Validator | 23,772 | Nov 2026 | Working |
| Solana MCP by Vybe | 2,728 | Oct 2026 | Working |
| Solana MCP by Vybe | 2,728 | Oct 2026 | Working |
| Oracle3 prediction-market agent tools | 569 | Nov 2026 | Local / not checked |
| Flyto Core | 483 | Nov 2026 | Local / not checked |
Global Shopaholics: questions people ask
- Is Global Shopaholics a remote or a local MCP server?
- According to its entry in the official MCP registry, Global Shopaholics ships as a hosted endpoint (streamable-http) that your client connects to by URL.
- Does Global Shopaholics need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
- Is Global Shopaholics safe to use?
- Looks healthy: Global Shopaholics is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- Is Global Shopaholics still maintained?
- Active: the repository's last commit 4 days ago. Last push Nov 18, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
- What tools does Global Shopaholics expose?
- 11 tools as listed by the server itself during the live check, including get_shipping_rates, estimate_landed_cost, get_services_and_fees, get_started, request_assisted_purchase. The full list with parameters is in the Live check section above.
- How do I add Global Shopaholics to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More Crypto & Web3 servers
Browse all Crypto & Web3 →YRUZ x402 tools
xzntexe
Pay-per-call x402 tools: package advisories, EU tenders, Wikidata facts, promo board, web, crypto
Base Token Facts
yankiifr
Base token checks for agents: simulated buy and sell, taxes, honeypots. Pay per call in USDC (x402).
Oracle3 prediction-market agent tools
YichengYang-Ethan
Kalshi and Polymarket data, venue fees, no-arbitrage checks and paper execution for AI agents.
Dokimo MCP
ypratap11
Verify AI-agent revenue: recompute a Merkle proof and check it against an on-chain anchor.
Tokenomics Audit Desk — Unlock Calendar
yungsuper16-eng
Premium via x402: $1.00 full 20-token reconstruction - tokenomics-x402.gtcclothing1.workers.dev
Mark: agent escrow
yuvlero
Bitcoin escrow for AI agents: dispute protection for agent payments. 2-of-3, Lightning in/out.
Add the badge to your site
Show visitors that Global Shopaholics is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/io-github-xuniwattoo-gs-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Global Shopaholics — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/io-github-xuniwattoo-gs-mcp?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-xuniwattoo-gs-mcp) [](https://serverdex.io/install/vscode/io-github-xuniwattoo-gs-mcp) [](https://serverdex.io/install/claude-code/io-github-xuniwattoo-gs-mcp)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/io-github-xuniwattoo-gs-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-xuniwattoo-gs-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-xuniwattoo-gs-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).