Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Read-only TikTok Shop Partner API: orders, finance, products and analytics across shops.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 12/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 24/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala TikTok Shop. Sigue https://mcp.popnx.com/i/buer2333-tiktok-shop-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server TikTok Shop para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "tiktok-shop": { "command": "uvx", "args": [ "tiktok-shop-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de TikTok Shop aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
SettingsDeveloperEdit Config
{
"mcpServers": {
"tiktok-shop": {
"command": "uvx",
"args": [
"tiktok-shop-mcp"
]
}
}
}Usa TikTok Shop y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando TikTok Shop o muestra una herramienta de TikTok Shop en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
TIKTOK_SHOP_CONFIG Ruta a shops.json (por defecto /.config/tiktok-mcp/shops.json) TIKTOK_SHOP_BESTSELLERS_SHOP Tienda usada por las herramientas más vendidas cuando se omite seller_name Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar TikTok Shop
TikTok Shop se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar TikTok Shop
B · Otros en Tiendas en línea y pagos que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server TikTok Shop para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user tiktok-shop -- uvx tiktok-shop-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de TikTok Shop aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user tiktok-shop -- uvx tiktok-shop-mcpDeberías ver TikTok Shop en la lista como conectado
Usa TikTok Shop y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando TikTok Shop o muestra una herramienta de TikTok Shop en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
TIKTOK_SHOP_CONFIG Ruta a shops.json (por defecto /.config/tiktok-mcp/shops.json) TIKTOK_SHOP_BESTSELLERS_SHOP Tienda usada por las herramientas más vendidas cuando se omite seller_name Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server TikTok Shop para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "tiktok-shop": { "command": "uvx", "args": [ "tiktok-shop-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de TikTok Shop aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Usa TikTok Shop y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando TikTok Shop o muestra una herramienta de TikTok Shop en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
TIKTOK_SHOP_CONFIG Ruta a shops.json (por defecto /.config/tiktok-mcp/shops.json) TIKTOK_SHOP_BESTSELLERS_SHOP Tienda usada por las herramientas más vendidas cuando se omite seller_name Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server TikTok Shop para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "tiktok-shop": { "type": "stdio", "command": "uvx", "args": [ "tiktok-shop-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de TikTok Shop aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Usa TikTok Shop y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando TikTok Shop o muestra una herramienta de TikTok Shop en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
TIKTOK_SHOP_CONFIG Ruta a shops.json (por defecto /.config/tiktok-mcp/shops.json) TIKTOK_SHOP_BESTSELLERS_SHOP Tienda usada por las herramientas más vendidas cuando se omite seller_name Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user tiktok-shop -- uvx tiktok-shop-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"tiktok-shop": {
"command": "uvx",
"args": [
"tiktok-shop-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"tiktok-shop": {
"command": "uvx",
"args": [
"tiktok-shop-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"tiktok-shop": {
"type": "stdio",
"command": "uvx",
"args": [
"tiktok-shop-mcp"
]
}
}
}TIKTOK_SHOP_CONFIG envTIKTOK_SHOP_BESTSELLERS_SHOP envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub Buer2333, dueña del repo
Último cambio de código: anteayer
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para tiktok-shop-mcp@0.3.0
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/buer2333-tiktok-shop-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez anteayer, y la última versión (0.3.0) llegó al registro hace 31 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Amazon Ads, Seller Central, Vendor Central and AMC data for AI agents. Read-only by default.
Search products, compare prices and discover deals across 6 European markets with your AI assistant.
| Este TikTok Shop | Stripe MCP | flightclaw | Trade It | Marketplace Ad Pros: Amazon Ads & Seller Central | idealo MCP Server | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | No | No | No | No | No | No |
| Se añade con + en Claude | No | Sí | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 5/5 | 4/4 | 4/4 |
| Licencia | MIT | MIT | MIT | CC0-1.0 | MIT | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
A Model Context Protocol (MCP) server for the TikTok Shop Partner API — query orders, finance, products, analytics, and affiliate performance across multiple shops from Claude, or any other MCP client.
Built for sellers and agencies who operate TikTok Shops and want their AI assistant to answer questions like *"what did the US shop sell yesterday?"*, *"which SKUs are trending this week?"*, or *"pull the settlement statements for June"* — directly against the official API, with no browser scraping.
seller_name (partial match) to pick the shopstart_date=2026-07-01 + an IANA timezone instead of unix timestamps; the server handles conversionmcp-retry (exponential backoff + jitter on 429/5xx/network errors)TIKTOK_SHOP_WRITE_SHOPS, and each defaults to a dry run. See Product writes. Otherwise the only thing the server writes is your own shops.json, when it refreshes tokens, with owner-only (0600) permissions. If you never need writes, authorize the Partner Center app with read scopes only| Group | Tools |
|---|---|
| Shops & auth | list_shops · refresh_token · refresh_all_tokens |
| Orders | get_shop_orders · get_order_detail · search_returns · search_cancellations |
| Finance | get_shop_statements · get_shop_transactions |
| Products | get_shop_products · get_product_detail |
| Listing lookups | get_categories · get_category_attributes · get_category_rules · get_brands · get_warehouses |
| Product writes (opt-in, see below) | upload_product_image · create_product · partial_edit_product · activate_products · deactivate_products |
| Shop analytics | get_shop_performance · get_shop_performance_hourly · get_shop_products_performance · get_product_performance · get_shop_videos_performance · get_sku_performance · get_customer_service_performance |
| Video & affiliate | get_account_video_gmv · get_videos_bestselling · get_creators_bestselling · get_products_bestselling |
pip install tiktok-shop-mcp
Or from source, into a virtualenv, with the direct dependencies pinned to the versions the tests run against:
git clone https://github.com/Buer2333/tiktok-shop-mcp.git
cd tiktok-shop-mcp python3 -m venv .venv .venv/bin/pip install -r requirements.txt .venv/bin/pip install --no-deps -e .
requirements.txt pins the direct runtime dependencies to exact versions, including mcp-retry, which wraps every API call and so sees your tokens. Transitive dependencies (pydantic, starlette, and so on) are not pinned; for a fully reproducible install, generate a lock file with pip-compile --generate-hashes. Bump a pin only after reading what changed in that release.
Works with both mcp 1.x and 2.x. mcp 2.0 renamed FastMCP to MCPServer (mcp.server.mcpserver) and turned mcp.server.fastmcp into a raising stub; server.py imports via a try-v2-except-v1 shim. Tests pass on 1.28.1 and 2.1.1; requirements.txt pins 2.1.1.
Credentials live in a JSON file outside the repo (default ~/.config/tiktok-mcp/shops.json, override with the TIKTOK_SHOP_CONFIG env var). The server never reads a shops.json from the project folder, so a copy there can't be picked up and synced or committed by accident. Keep the file owner-only:
chmod 700 ~/.config/tiktok-mcp && chmod 600 ~/.config/tiktok-mcp/shops.json
The setup scripts leave token backups (shops.json.bak.* and a recovery/ folder) next to it; delete them once your shops are working. A small shops.json.lock file also lives there; it is how the server, the cron refresher, and the setup scripts avoid writing the file at the same time, so leave it be.
[
{ "seller_name": "MY SHOP US", "seller_base_region": "US", "app_key": "...", "app_secret": "...", "access_token": "TTP_...", "refresh_token": "TTP_...", "shop_id": "...", "shop_cipher": "..." } ]
You get app_key / app_secret by creating an app on the TikTok Shop Partner Center, then authorize your shop(s) to obtain tokens. shop_id / shop_cipher are returned by the authorized-shops endpoint; the bundled probe_authorized_shops.py script can fetch them for you.
The three *_bestselling tools need a shop whose app has the Bestsellers scope. The lists are platform-wide, so one such shop is enough: set TIKTOK_SHOP_BESTSELLERS_SHOP to its seller_name (partial match OK) and the tools use it whenever seller_name is omitted. Without it they fall back to the first shop in shops.json.
TIKTOK_SHOP_APP_SECRET=... .venv/bin/python add_or_update_shop.py "<full_callback_url>" --seller-name "MY SHOP"
TIKTOK_SHOP_APP_SECRET is only needed for the first shop on an app; after that the script reads it from the existing entry. The callback URL carries app_key and code. The code is single-use and starts with TTP_, while an app secret is 40 hex characters, so they are easy to tell apart.
To keep one business's shops apart from another's, point TIKTOK_SHOP_CONFIG at its own file for both this script and the server. Backups and the recovery/ folder follow that path.
401 / 105002 Expired credentials; the server then refreshes it and retries once, so MCP use needs no scheduled job.*_expire_at in shops.json and list_shops:** real UTC dates. Entries written by older versions can show years like 2083 until their next refresh.claude mcp add tiktok-shop -- tiktok-shop-mcp
{
"mcpServers": { "tiktok-shop": { "command": "tiktok-shop-mcp", "env": { "TIKTOK_SHOP_CONFIG": "/path/to/shops.json" } } } }
Five tools change a shop's listings. They are off unless you turn them on per shop.
| Tool | Endpoint (Product API 202309) | Required params |
|---|---|---|
upload_product_image | POST /product/202309/images/upload (multipart) | seller_name, image_path; use_case = MAIN_IMAGE (default), ATTRIBUTE_IMAGE, DESCRIPTION_IMAGE, CERTIFICATION_IMAGE, SIZE_CHART_IMAGE |
create_product | POST /product/202309/products | seller_name, product (the Create Product body: title, category_id, main_images, skus, ...) |
partial_edit_product | POST /product/202309/products/{id}/partial_edit | seller_name, product_id, changes |
activate_products | POST /product/202309/products/activate | seller_name, product_ids (max 20) |
deactivate_products | POST /product/202309/products/deactivate | seller_name, product_ids (max 20) |
The gate. Every write tool checks, before it builds a request:
seller_name is given and matches a shops.json entry exactly. The read tools' partial, case-insensitive match and first-shop fallback do not apply: "MY SHOP" will not select "MY SHOP US".TIKTOK_SHOP_WRITE_SHOPS environment variable (comma-separated). Unset or empty means every write tool refuses, dry runs included.{
"mcpServers": { "tiktok-shop": { "command": "tiktok-shop-mcp", "env": { "TIKTOK_SHOP_WRITE_SHOPS": "MY SHOP US" } } } }
Dry run first. dry_run defaults to true: the tool returns the method, path and JSON body it would send (no token, signature or app key) and makes no HTTP request. Pass dry_run=false to send. A real send then:
GET /product/202309/products/{id}) and returns it as read_back. After partial_edit_product the read-back asks for the version under review, since TikTok Shop keeps the old version live until the edit passes audit. After activate_products / deactivate_products it returns each product's status, and errors lists per-product failures that come back with code 0.What the tools will not do.
PUT .../products/{id}): it overwrites every field the body leaves out.partial_edit_product refuses skus. The API treats each top-level field as a unit, so a skus list you send stands in for the whole property; the docs do not say what happens to SKUs left out of it (they may be removed), and SKUs carry inventory. It also refuses listing_platforms and anything not on its list (title, description, brand_id, main_images, product_attributes, package_weight, package_dimensions, video, certifications, size_chart, search_terms, key_product_features, external_product_id, save_mode, locale).Things to know before sending.
product_attributes entry or one package_dimensions value and it is blanked. Send the full property.PENDING). New products are audited after creation.create_product sets each SKU's opening inventory (warehouse_id from get_warehouses, quantity). If another system syncs your stock, make the opening numbers match it; after creation, leave stock to that system.category_version v2; the tools default to it.seller.product.basic) and Product Modify (seller.product.write) scopes; get_warehouses needs Logistics Basic (seller.logistics).tiktok_shop_mcp/
├── server.py # FastMCP app — tool definitions, date handling, error envelope ├── client.py # Signed HTTP client (HMAC-SHA256 request signing, via mcp-retry) ├── config.py # Multi-shop credential loading & resolution ├── write_guard.py # Exact-name + TIKTOK_SHOP_WRITE_SHOPS gate for write tools └── tools/ # One module per API domain (orders, finance, products, analytics…)
All tools return structured JSON. Errors come back as {"error": true, "message": …, "suggestion": …} so the model can self-correct (e.g. refresh an expired token and retry).
This is an independent open-source project, not affiliated with or endorsed by T