Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Global Shopaholics

von xuniwattooVersion 1.2.0i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registryio.github.xuniwattoo/gs-mcp

So installierst du es

What it does

Buy from any US store for you: ship worldwide or in the US, find it cheaper, pay in crypto.

  • Connects Läuft in der Cloud
  • Account or key No key needed
  • Category Krypto & Blockchain

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert20/100

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Global Shopaholics. Folge https://mcp.popnx.com/i/xuniwattoo-gs-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.globalshopaholics.com) · ✓ Befehle geprüft am 18. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameGlobal Shopaholics
    Remote MCP server URL · Adressehttps://mcp.globalshopaholics.com/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsGlobal Shopaholics

  4. Ausprobieren

    Nutze Global Shopaholics und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Global Shopaholics nutzt, oder ein Werkzeug von Global Shopaholics in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameGlobal Shopaholics
    Connection · Adressehttps://mcp.globalshopaholics.com/mcp
  3. Global Shopaholics im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen Global Shopaholics aus deinen Plugins wählen

  4. Ausprobieren

    Nutze Global Shopaholics und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es Global Shopaholics nutzt, oder ein Werkzeug von Global Shopaholics in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user gs https://mcp.globalshopaholics.com/mcp
  3. /mcp in Claude Code eingeben

    Global Shopaholics sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze Global Shopaholics und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Global Shopaholics nutzt, oder ein Werkzeug von Global Shopaholics in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Global Shopaholics und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Global Shopaholics nutzt, oder ein Werkzeug von Global Shopaholics in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Global Shopaholics und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Global Shopaholics nutzt, oder ein Werkzeug von Global Shopaholics in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.globalshopaholics.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Global Shopaholics nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user gs https://mcp.globalshopaholics.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "gs": {
      "url": "https://mcp.globalshopaholics.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "gs": {
      "type": "http",
      "url": "https://mcp.globalshopaholics.com/mcp"
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.2.0
In der Registry veröffentlichti
19. Nov. 2026
Code zuletzt geänderti
19. Nov. 2026
Zuletzt geprüft
18. Nov. 2026
Entwickler
xuniwattoo
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 18. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • get_shipping_rates

    Live 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. P

  • estimate_landed_cost

    Estimates 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 estimated import duty/VAT for the destination from a sourced rules table (Angola, Saudi Arabia, UAE, UK, Can

  • get_services_and_fees

    Global 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 so

  • get_started

    Step-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.

  • request_assisted_purchase

    Buy-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 ema

  • request_shipment_quote

    Sends 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 ste

  • track_shipment

    Returns 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.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto xuniwattoo bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: heute

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 127 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 7 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/xuniwattoo-gs-mcp.svg)](https://mcp.popnx.com/en/servers/xuniwattoo-gs-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Krypto & Blockchaini

  • Mehr Sterne als 0 % der anderen 1759 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 99 % der anderen 1759 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 1759 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Global Shopaholics sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt heute geändert, und die neueste Version (1.2.0) kam heute in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: DexSQL, PayRam, DexPaprika, Alchemy MCP Server, X402 List MCP

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

DexSQL

SQL for Android APK and DEX files: classes, methods, strings, references and smali.

von LSPosedWachsend★ 320Aktualisiert vor 32 Tagen

Läuft auf deinem Computer✓ lsposed.org

PayRam

Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.

von PayRamWachsend★ 158Aktualisiert vor 43 Tagen

Läuft in der Cloud✓ vom Dienst · payram.com

DexPaprika

DEX and on-chain data: liquidity pools, token prices, swaps, and trading volume.

von coinpaprikaWachsend★ 120Aktualisiert vor 6 Tagen

Läuft in der Cloud✓ vom Dienst · dexpaprika.com

Alchemy MCP Server

Blockchain data across 100+ chains: token prices, NFTs, transfers, simulation, traces, Solana DAS

von alchemyplatformWachsend★ 88Aktualisiert vor 8 Tagen

Läuft in der Cloud✓ vom Dienst · alchemy.com

X402 List MCP

Find and vet x402 payment APIs before your agent pays one: uptime, price, on-chain volume.

von mcccsmAm Anfang↓ 80/Wo.★ 18Aktualisiert vor 40 Tagen

Computer oder Cloud✓ vom Dienst · x402-list.com
Im Vergleich mit ähnlichen
Dieser
Global Shopaholics
DexSQLPayRamDexPaprikaAlchemy MCP ServerX402 List MCP
Läuft woLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem Rechner
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen5/52/33/44/44/45/5
LizenzMITNOASSERTION–MITMITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

ToolWhat it does
get_shipping_ratesLive DHL / FedEx / UPS / USPS prices, transit times, max weight/size, insurance text and dimensional-weight flag from GS's rate engine (/wp-json/rate-calculator/v2/getrates), normalized and sorted.
estimate_landed_costItem + optional US sales tax + GS Assisted Purchase fee (0% when paid by bank transfer or crypto, otherwise 5% with a $5 minimum; expedited & executive per GS FAQ) + live shipping + estimated duty, VAT/GST and fees per item and product category (phones, laptops, clothing, shoes, cosmetics, perfume…) for 87 countries, with de minimis, CIF/FOB basis, courier regimes and who collects. Other countries: WITS tariff lookup (free) or the Easyship Tax & Duty API when EASYSHIP_API_KEY is set, cached permanently by country + HS6. Returns a typical estimate plus low–high range.
get_services_and_feesServices, plans (Basic free, Premium $9.99, Business $14.99) and published fees with source URLs + last-checked date.
get_startedHow to get the free US address (sign-up: https://login.globalshopaholics.com/register) and next steps.
request_assisted_purchaseSends a "buy it for me" request to GS (GoHighLevel and/or webhook), tag mcp-assisted-purchase; returns a reference id. Falls back to GS's Assisted Purchase page + prefilled email if no sink is configured.
find_lower_priceFind it cheaper at US stores. Google Shopping (US) via Serper: top offers sorted by price (store, price, link, rating, savings vs the current price), no affiliate links, sketchy sellers and outliers dropped. Indicative prices only. Cached 24 h, 10 searches/hour per client. Needs SERPER_API_KEY. Hands off to request_us_purchase / request_assisted_purchase.
request_us_purchaseUS domestic buy-for-me. GS buys from any US store and ships to a US address (incl. Hawaii, Alaska, Puerto Rico, APO/FPO, stores that won't ship to the customer). Inputs: product URLs, quantity, variant, max price, find_lower_price, ship-to state + ZIP, name, email. Same GHL lead flow; tags mcp-us-domestic (+ price-beat). Fee 0% for crypto/bank transfer, otherwise 5% with $5 minimum; crypto via create_crypto_payment once GS confirms the total. Prices are never guaranteed.
request_shipment_quoteSame lead flow for manual quotes, labels, customs paperwork, freight; tag mcp-shipping-request.
create_crypto_paymentCrypto checkout is live. Creates a BTCPay invoice (USD) for an amount GS has already quoted and returns checkout link, invoice id and expiry. 0% GS fee when paying by crypto. Capped at $10,000, rate limited, logged to the GHL contact (mcp-crypto-payment). Needs BTCPAY_URL, BTCPAY_STORE_ID, BTCPAY_API_KEY (key limited to create/view invoices).
get_crypto_payment_statusRead-only status of an invoice by id.
track_shipmentCarrier tracking URL (DHL/FedEx/UPS/USPS, auto-detected). GS has no public tracking page; customers also see status in their dashboard.

Resource: gs://about (markdown overview). Prompt: buy-and-ship.

Run locally

npm install

cp .env.example .env # optional, every value has a default npm run dev # Node server on http://localhost:8787/mcp npm test # unit + in-process MCP tests (all network mocked) npm run smoke # spawns the server, real HTTP MCP client, LIVE GS rates, lead sinks mocked npm run cf:dev # same code inside the Cloudflare Workers runtime (wrangler dev) npm run stdio # stdio transport

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`. Fallback: https://gs-mcp.gshopaholics.workers.dev/mcp.

Claude Code – plugin (adds the server plus a ship-from-us skill that tells Claude when to use it):

/plugin marketplace add xuniwattoo/gs-mcp

/plugin install global-shopaholics@global-shopaholics

On Claude Code 2.1.275+ one step works: /plugin install global-shopaholics --marketplace xuniwattoo/gs-mcp

Or just the server: claude mcp add --transport http global-shopaholics https://mcp.globalshopaholics.com/mcp

Claude.ai / Claude Desktop – Settings → Connectors → *Add custom connector* → name Global Shopaholics, URL https://mcp.globalshopaholics.com/mcp. Or download global-shopaholics.mcpb and double-click it (Claude Desktop → Settings → Extensions). Manual config for older builds:

{ "mcpServers": { "global-shopaholics": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.globalshopaholics.com/mcp"] } } }

ChatGPT – Settings → Apps & Connectors → Advanced settings → turn on *Developer mode* → *Create* → MCP server URL https://mcp.globalshopaholics.com/mcp, authentication *No authentication*.

Codex (CLI, IDE, ChatGPT desktop) – codex mcp add global-shopaholics --url https://mcp.globalshopaholics.com/mcp, or in ~/.codex/config.toml:

[mcp_servers.global-shopaholics]

url = "https://mcp.globalshopaholics.com/mcp"

A Codex/ChatGPT plugin package (server + skill) is in plugins/openai/global-shopaholics.

Cursor – click the button above, or ~/.cursor/mcp.json:

{ "mcpServers": { "global-shopaholics": { "url": "https://mcp.globalshopaholics.com/mcp" } } }

Direct deeplink: cursor://anysphere.cursor-deeplink/mcp/install?name=global-shopaholics&config=eyJ1cmwiOiJodHRwczovL21jcC5nbG9iYWxzaG9wYWhvbGljcy5jb20vbWNwIn0=

VS Code (Copilot agent mode) – click the button above, or code --add-mcp '{"name":"global-shopaholics","type":"http","url":"https://mcp.globalshopaholics.com/mcp"}', or .vscode/mcp.json:

{ "servers": { "global-shopaholics": { "type": "http", "url": "https://mcp.globalshopaholics.com/mcp" } } }

Windsurf – ~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "global-shopaholics": { "serverUrl": "https://mcp.globalshopaholics.com/mcp" } } }

Gemini CLI – gemini mcp add --transport http global-shopaholics https://mcp.globalshopaholics.com/mcp, or ~/.gemini/settings.json:

{ "mcpServers": { "global-shopaholics": { "httpUrl": "https://mcp.globalshopaholics.com/mcp" } } }

Cline / Roo / other clients – add a remote server of type *Streamable HTTP* with URL https://mcp.globalshopaholics.com/mcp.

curl

curl -s -X POST https://mcp.globalshopaholics.com/mcp -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \

-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_shipping_rates","arguments":{"country":"AO","weight":5,"unit":"kg"}}}'

Discovery
  • Server card: https://mcp.globalshopaholics.com/mcp/server-card (also /.well-known/mcp/server-card.json)
  • AI catalog: https://mcp.globalshopaholics.com/.well-known/ai-catalog.json
  • https://mcp.globalshopaholics.com/llms.txt
  • Official MCP Registry name: io.github.xuniwattoo/gs-mcp (server.json)
  • Copies for globalshopaholics.com: site-files/

Configuration

See .env.example (Node/Vercel) or wrangler.toml [vars] + wrangler secret put (Workers). Full list in docs/deploy.md.

Layout

src/config.ts            env → typed config (works with Workers env or process.env)

src/server.ts McpServer: 11 tools, resource, prompt (zod schemas) src/http.ts stateless web-standard Streamable HTTP handler, CORS, /health src/entry/worker.ts Cloudflare Workers entry src/entry/node.ts plain Node HTTP entry (Cloudways/VPS) src/entry/stdio.ts stdio entry api/mcp.ts, vercel.json Vercel entry src/lib/rates.ts GS rate engine client + normalizer + 10-min cache src/lib/landed.ts landed-cost estimator, GS fee logic src/lib/duty-engine.ts per-item duty/tax engine (profiles + WITS MFN rates) src/lib/duty-fallback.ts fallback lookup (Easyship → WITS) + permanent DO cache src/lib/leads.ts GoHighLevel v2 / webhook lead sinks + fallback src/lib/ratelimit.ts limiter contract + in-memory fallback src/lib/limiter-do.ts SQLite Durable Object limiter (Workers) src/lib/validate.ts lead-input sanitization and checks src/lib/tracking.ts carrier detection + URLs src/data/*.ts GS facts (sourced), GS calculator country list src/data/duty/ duty profiles, categories, WITS tariff snapshot, GS order priority test/ vitest tests + fixture (real GS response, Angola 5 kg) scripts/smoke.ts end-to-end smoke test docs/ website page copy, deploy guide src/discovery.ts server card, AI catalog, llms.txt (served by the Worker) site-files/ discovery files to publish on globalshopaholics.com .claude-plugin/ Claude Code marketplace (plugins/claude/global-shopaholics) plugins/openai/ Codex / ChatGPT plugin package mcpb/ Claude Desktop extension (stdio relay to the remote server); npm run mcpb:build server.json MCP registry manifest