Set Up the FastMoss MCP Server

← Back to MCP overview

Get started

Setup center

Everything you need to get FastMoss running inside your AI — three steps, about a minute.

Choose your client

Pick the AI client / model you use below and follow its config — remote or local.

Get your API key

Enter your email there, we send the key, paste it into the config.

Trial starts automatically

The moment you create your key, your 3-day free trial begins — free queries refresh daily. Get your key ↗

⚙ Config blocks are reference snippets — annotated screenshots are placeholders until each flow is verified on the live app.

Connection type

Remote: nothing to install — Streamable HTTP to mcp.fastmoss.com/mcp. Key goes in a header (config-file clients) or in the URL (GUI dialogs like Claude Desktop) — each guide shows which.

Configure your client

Pick your client in the left sidebar — its exact steps appear below. Paste your key where it says xxxxxx.

Claude Desktop

macOS · Windows

Open connector settings. Claude menu → Settings → Connectors → Add custom connector
Fill the two fields. This dialog has only Name and URL (no header field) — so your key goes inside the URL:
```
# Name
FastMoss
# URL — paste your key into the URL
https://mcp.fastmoss.com/mcp?api_key=fm_sk_xxx
```

Or edit claude_desktop_config.json: claude_desktop_config.json:

{
  "mcpServers": {
    "fastmoss": {
      "command": "npx",
      "args": ["-y", "@fastmoss/mcp", "mcp"],
      "env": { "FASTMOSS_API_KEY": "fm_sk_xxx" }
    }
  }
}

Restart Claude Desktop.重启 Claude Desktop。Claude Desktop を再起動します。Reinicia Claude Desktop.Reinicie o Claude Desktop.Mulai ulang Claude Desktop.รีสตาร์ท Claude DesktopKhởi động lại Claude Desktop.

🖼Screenshot: Settings → Connectors"Add custom connector" highlighted

🖼Screenshot: custom connector form (Name + URL only)Name "FastMoss", key pasted into the URL — no header field

✓ Test: "Use FastMoss to show today's top 5 selling products in US beauty."

Claude Code

CLI · VS Code · JetBrains

One command:

claude mcp add fastmoss --transport http https://mcp.fastmoss.com/mcp \
  --header "Authorization: Bearer fm_sk_xxx"

One command:

claude mcp add fastmoss --env FASTMOSS_API_KEY=fm_sk_xxx \
  -- npx -y @fastmoss/mcp mcp

Verify: claude mcp list

✓ Test: "Pull the 28-day GMV trend for this shop and summarize."

ChatGPT

Web · Desktop — plan with custom connectors required网页 · 桌面 — 需支持自定义连接器的订阅Web · デスクトップ — カスタムコネクタ対応プランが必要Web · Escritorio — se requiere un plan con conectores personalizadosWeb · Desktop — é necessário um plano com conectores personalizadosWeb · Desktop — perlu paket dengan konektor kustomเว็บ · เดสก์ท็อป — ต้องมีแพ็กเกจที่รองรับตัวเชื่อมต่อแบบกำหนดเองWeb · Desktop — cần gói có trình kết nối tùy chỉnh

Enable developer mode:开启开发者模式：開発者モードを有効化：Activa el modo desarrollador:Ative o modo desenvolvedor:Aktifkan mode developer:เปิดโหมดนักพัฒนา:Bật chế độ nhà phát triển: Settings → Connectors → Advanced → Developer mode
Create a connector:创建连接器：コネクタを作成：Crea un conector:Crie um conector:Buat konektor:สร้างตัวเชื่อมต่อ:Tạo một trình kết nối:
```
# MCP server URL
https://mcp.fastmoss.com/mcp
# Authentication: API key (Bearer)
fm_sk_xxx
```
Enable in chat:在对话中启用：チャットで有効化：Habilítalo en el chat:Ative no chat:Aktifkan di chat:เปิดใช้ในแชต:Bật trong cuộc trò chuyện: Tools → FastMoss

! ChatGPT supports remote connectors only.

🖼Screenshot: Connectors → Advanced → Developer modeCreate connector dialog with URL + key

✓ Test: "Search FastMoss for trending US pet products this week."

Cursor

macOS · Windows · Linux

Cursor Settings → MCP → Add new global MCP server (or .cursor/mcp.json)

Paste:

{
  "mcpServers": {
    "fastmoss": {
      "url": "https://mcp.fastmoss.com/mcp",
      "headers": { "Authorization": "Bearer fm_sk_xxx" }
    }
  }
}

Paste:

{
  "mcpServers": {
    "fastmoss": {
      "command": "npx",
      "args": ["-y", "@fastmoss/mcp", "mcp"],
      "env": { "FASTMOSS_API_KEY": "fm_sk_xxx" }
    }
  }
}

Toggle on, check the tool count.

🖼Screenshot: Cursor Settings → MCPFastMoss server enabled, tool count shown

✓ Test (Agent mode): "Compare these 3 product IDs' 7-day sales with FastMoss."

Windsurf

macOS · Windows · Linux

Settings → Cascade → MCP Servers → Add custom server

Paste:

{
  "mcpServers": {
    "fastmoss": {
      "serverUrl": "https://mcp.fastmoss.com/mcp",
      "headers": { "Authorization": "Bearer fm_sk_xxx" }
    }
  }
}

Paste:

{
  "mcpServers": {
    "fastmoss": {
      "command": "npx",
      "args": ["-y", "@fastmoss/mcp", "mcp"],
      "env": { "FASTMOSS_API_KEY": "fm_sk_xxx" }
    }
  }
}

Refresh and enable in Cascade.

🖼Screenshot: Cascade → MCP Servers"Add custom server" with the JSON pasted

✓ Test: "Which US creators drove the most GMV for Sports this month?"

Cline (VS Code)

VS Code extension

MCP Servers → Configure MCP Servers

Paste:

{
  "mcpServers": {
    "fastmoss": {
      "url": "https://mcp.fastmoss.com/mcp",
      "headers": { "Authorization": "Bearer fm_sk_xxx" }
    }
  }
}

Paste:

{
  "mcpServers": {
    "fastmoss": {
      "command": "npx",
      "args": ["-y", "@fastmoss/mcp", "mcp"],
      "env": { "FASTMOSS_API_KEY": "fm_sk_xxx" }
    }
  }
}

Save — Cline hot-reloads tools.

🖼Screenshot: Cline → MCP Servers → ConfigureServer listed green after hot-reload

✓ Test: "Use FastMoss to check if this product is trending up or down."

Cherry Studio

macOS · Windows — friendly for non-developersmacOS · Windows — 适合非开发者macOS · Windows — 開発者以外にも使いやすいmacOS · Windows — apto para no desarrolladoresmacOS · Windows — amigável para não desenvolvedoresmacOS · Windows — ramah untuk non-developermacOS · Windows — เป็นมิตรกับผู้ที่ไม่ใช่นักพัฒนาmacOS · Windows — thân thiện với người không chuyên

Settings → MCP Servers → Add Server

Type "Streamable HTTP":

# URL
https://mcp.fastmoss.com/mcp
# Headers
Authorization=Bearer fm_sk_xxx

Type "stdio":

# Command
npx
# Arguments
-y @fastmoss/mcp mcp
# Environment
FASTMOSS_API_KEY=fm_sk_xxx

Enable the server, turn on FastMoss in your assistant.

🖼Screenshot: Settings → MCP Servers → Add ServerType "Streamable HTTP", URL + header filled

✓ Test: "Top 10 US shops by GMV in Home Supplies, last 28 days."

Gemini CLI

Terminal

Edit ~/.gemini/settings.json

Paste:

{
  "mcpServers": {
    "fastmoss": {
      "httpUrl": "https://mcp.fastmoss.com/mcp",
      "headers": { "Authorization": "Bearer fm_sk_xxx" }
    }
  }
}

Paste:粘贴：貼り付け：Pega:Cole:Tempel:วาง:Dán:

{
  "mcpServers": {
    "fastmoss": {
      "command": "npx",
      "args": ["-y", "@fastmoss/mcp", "mcp"],
      "env": { "FASTMOSS_API_KEY": "fm_sk_xxx" }
    }
  }
}

Run运行実行EjecutaExecuteJalankanรันChạy gemini and check /mcp.，用 /mcp 确认连接。、/mcp で接続を確認します。 y comprueba /mcp. e verifique /mcp.dan periksa /mcp.แล้วตรวจสอบ /mcpvà kiểm tra /mcp.

✓ Test: "Search FastMoss for US electronics ads with ROAS above 2."测试：「用 FastMoss 搜美区 3C 类 ROAS 大于 2 的广告。」テスト：「FastMoss で米国の 3C 広告で ROAS 2 以上のものを検索。」Prueba: «Busca en FastMoss anuncios de electrónica de EE. UU. con ROAS superior a 2.»Teste: "Pesquise na FastMoss anúncios de eletrônicos dos EUA com ROAS acima de 2."Uji: "Cari di FastMoss iklan elektronik AS dengan ROAS di atas 2."ทดสอบ: "ค้นหาใน FastMoss โฆษณาอุปกรณ์อิเล็กทรอนิกส์ในสหรัฐฯ ที่มี ROAS สูงกว่า 2"Thử: "Tìm trên FastMoss các quảng cáo điện tử ở Mỹ có ROAS trên 2."

Verify your connection验证连接接続を確認Verifica tu conexiónVerifique sua conexãoVerifikasi koneksi Andaตรวจสอบการเชื่อมต่อของคุณXác minh kết nối của bạn

Paste this after setup — live numbers back means you're in. Zero-result calls are free.配置后粘贴这句——返回真实数据就是连通了。零结果不扣费。設定後に貼り付け——実際のデータが返れば接続完了。ゼロ結果は無料です。Pega esto después de la configuración: si vuelven datos reales, estás dentro. Las llamadas con resultados vacíos son gratis.Cole isso após a configuração — se retornarem dados reais, você está conectado. Chamadas com resultados vazios são gratuitas.Tempel ini setelah setup — angka live yang kembali berarti Anda sudah terhubung. Panggilan dengan hasil nol gratis.วางสิ่งนี้หลังตั้งค่า — ถ้าได้ตัวเลขจริงกลับมาแปลว่าคุณเชื่อมต่อสำเร็จแล้ว การเรียกที่ได้ผลลัพธ์เป็นศูนย์นั้นฟรีDán nội dung này sau khi thiết lập — có số liệu thật trả về nghĩa là bạn đã kết nối. Các lần gọi không kết quả là miễn phí.

"List the FastMoss tools you can see, then show today's top 3 selling products in the US."「列出你能看到的 FastMoss 工具，然后查今天美区销量前 3 的商品。」「見える FastMoss ツールを列挙し、今日の米国売上トップ3の商品を表示してください。」«Enumera las herramientas de FastMoss que puedas ver y luego muestra los 3 productos más vendidos de hoy en EE. UU.»"Liste as ferramentas da FastMoss que você consegue ver e mostre os 3 produtos mais vendidos de hoje nos EUA.""Daftar alat FastMoss yang bisa Anda lihat, lalu tunjukkan 3 produk terlaris hari ini di AS.""ระบุเครื่องมือ FastMoss ที่คุณมองเห็น จากนั้นแสดงสินค้าขายดี 3 อันดับแรกของวันนี้ในสหรัฐฯ""Liệt kê các công cụ FastMoss bạn thấy, sau đó hiển thị top 3 sản phẩm bán chạy nhất hôm nay ở Mỹ."

💬

Stuck? Talk to us — we'll help you get connected.卡住了？随时找我们——帮你把接入跑通。行き詰まりましたか？お問い合わせください——接続までサポートします。¿Atascado? Háblanos: te ayudaremos a conectarte.Empacou? Fale conosco — vamos te ajudar a conectar.Terkendala? Hubungi kami — kami akan membantu Anda terhubung.ติดปัญหา? คุยกับเรา — เราจะช่วยคุณเชื่อมต่อGặp khó? Hãy trò chuyện với chúng tôi — chúng tôi sẽ giúp bạn kết nối.

Scan to join our community group, or email support. Real people, fast answers.扫码加入交流群，或邮件联系客服。真人答疑，响应快。QR をスキャンしてコミュニティに参加、またはメールでサポートへ。実在の担当者が迅速に対応します。Escanea para unirte a nuestro grupo comunitario o escribe al soporte. Personas reales, respuestas rápidas.Escaneie para entrar no nosso grupo da comunidade ou envie e-mail ao suporte. Pessoas reais, respostas rápidas.Pindai untuk bergabung dengan grup komunitas kami, atau email dukungan. Orang sungguhan, jawaban cepat.สแกนเพื่อเข้าร่วมกลุ่มคอมมูนิตี้ของเรา หรืออีเมลหาฝ่ายซัพพอร์ต คนจริง ตอบเร็วQuét để tham gia nhóm cộng đồng của chúng tôi, hoặc email hỗ trợ. Người thật, phản hồi nhanh.

✉ Support客服邮箱サポートSoporteSuporteDukunganซัพพอร์ตHỗ trợ: support@fastmoss.com

QR二维码QRQRQRQRQRQR

Feishu group飞书群Lark グループGrupo de FeishuGrupo do FeishuGrup Feishuกลุ่ม FeishuNhóm Feishu

QR二维码QRQRQRQRQRQR

WeChat group微信群WeChat グループGrupo de WeChatGrupo do WeChatGrup WeChatกลุ่ม WeChatNhóm WeChat

QR二维码QRQRQRQRQRQR

Support chat客服群サポートチャットChat de soporteChat de suporteChat dukunganแชตซัพพอร์ตChat hỗ trợ