[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup) # Kalodata MCP server: Let your AI agent research TikTok Shop in Kalodata. > Kalodata has an official Open API: ranking and detail endpoints for Category, Shop, Creator, Product, Video and Livestream data in 15 markets, billed in credits (Kalodata blog, 3 and 14 Sep 2026). It has no official MCP server yet: Kalodata's X post of 27 Aug 2026 lists MCP as coming soon (checked 6 Nov 2026). Cotlet runs 13 Kalodata tools in your signed-in account. There is no API key to create and nothing to develop. It works inside the ChatGPT and Claude apps, runs around the clock in our hosting, and one Cotlet account covers many apps. Your agent opens Kalodata, pulls the product, shop, creator and video rankings and reads the details behind them. It follows the shops you want to watch and exports creator lists, all from your own Kalodata account. - Free 7-day trial, no card - Independent, not affiliated with Kalodata - Page: https://cotlet.dev/integrations/kalodata-api-mcp-server ## What can your AI agent do in Kalodata? - Rank top products by revenue - Read a shop's revenue trend - Shortlist creators in a category - Find the videos that sell a product - Follow shops and list the ones you follow - Export a creator list ## Does Kalodata have an MCP server or an API? - The Open API key comes from Kalodata's Open Center. The Open Center, its docs and its price list sit behind a Kalodata login (checked 6 Nov 2026). Kalodata's blog puts a basic query at 0.2 to 0.4 credits and an advanced one at 1 to 2, one credit about $0.1. - Kalodata publishes an agent skill for Codex and Claude Code that needs the same API key. Its GitHub repo also holds a local MCP server with 20 tools that runs on your own computer. - Zapier and n8n list no Kalodata app (checked 6 Nov 2026). | What you need | Kalodata Open API | Cotlet | |---|---|---| | Product, shop and creator rankings and details | Yes | Yes | | Video and livestream rankings | Yes | Yes | | Follow a shop, list followed shops | Not in the skill's commands | Yes | | Export a creator list | Not in the skill's commands | Yes, if your plan has the export | | Official MCP server | Coming soon | Hosted, ready | | Works in the ChatGPT and Claude apps | You build the connection | Paste one address | | Getting started | Open Center account, API key, code | Sign up, sign in once | Checked 6 Nov 2026. Sources: [Kalodata Blog: How to Access TikTok Shop API in 2026](https://www.kalodata.com/blog/kalodata/how-to-access-tiktok-shop-api-in-2026/), [Kalodata Blog: How to Use Kalodata Skill with Codex](https://www.kalodata.com/blog/tiktok/how-to-use-kalodata-skill-with-codex-for-tiktok-shop-product-research/), [Kalodata on X, 27 Aug 2026](https://x.com/kalodata/status/2092826293255512251), [GitHub: kalodata-skill](https://github.com/sailtonight/kalodata-skill) ## How does Cotlet connect to Kalodata? 1. **Sign in to Kalodata.** Use your own account in its Cotlet Cloud Browser. 2. **Connect your AI agent.** Paste one address into Claude or ChatGPT. 3. **Ask in plain words.** Your agent ranks, compares and follows for you. We never keep your Kalodata password, and following a shop changes only your own list. ## How to connect Kalodata to your AI agent Three steps. Chat apps sign in with OAuth. Editors, n8n and scripts use an API key. 1. **Enable Kalodata for agents.** Sign up, log in to Kalodata in its Cloud Browser, then press Enable for agents. 2. **Add the Cotlet address.** Add https://cotlet.dev/mcp/v1 as an MCP server or connector in your agent. 3. **Approve the connection.** Chat apps ask you to sign in to Cotlet. Editors, n8n and scripts use an API key from the console. One shared address, `https://cotlet.dev/mcp/v1`, also carries Kalodata next to your other apps. If you enable Kalodata after connecting, refresh the connector so the new tools show up. Claude: ``` Settings > Connectors > Add custom connector URL: https://cotlet.dev/mcp/v1/connect Claude Code: claude mcp add --transport http cotlet-kalodata \ https://cotlet.dev/mcp/v1 \ --header "Authorization: Bearer $COTLET_API_KEY" ``` ChatGPT: ``` Settings > Apps & Connectors > Create MCP server URL: https://cotlet.dev/mcp/v1/connect Authentication: OAuth ``` Cursor: ``` // ~/.cursor/mcp.json { "mcpServers": { "cotlet-kalodata": { "url": "https://cotlet.dev/mcp/v1", "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" } } } } ``` Codex: ``` # ~/.codex/config.toml [mcp_servers.cotlet-kalodata] url = "https://cotlet.dev/mcp/v1" bearer_token_env_var = "COTLET_API_KEY" ``` n8n: ``` MCP Client Tool (inside an AI Agent) Transport: HTTP Streamable URL: https://cotlet.dev/mcp/v1 Auth: Bearer, ``` Make, Zapier: ``` Make: MCP Client > Call a tool Zapier: MCP Client by Zapier > Run Tool Server URL: https://cotlet.dev/mcp/v1 Token: ``` ## All 13 Kalodata MCP tools ### Categories and products Look up a category ID first, then rank. Revenue and items sold are Kalodata's estimates, and how many rows and how far back you see depends on your plan. - **Search categories** (`search_categories`, read): Find Kalodata categories by keyword, with their IDs. - **List top products** (`list_top_products`, read): Product ranking for a market, category and date range, with estimated revenue and items sold. - **Get product details** (`get_product`, read): One product with estimated revenue, items sold, average unit price and revenue by channel. ### Shops and follows follow_shop and unfollow_shop undo each other in one call and change only your own list. Following a shop you already follow changes nothing. - **List top shops** (`list_top_shops`, read): Shop ranking for a market, category and date range, with estimated revenue. - **Get shop details** (`get_shop`, read): One shop with estimated revenue trend, best-selling products and creator partners. - **List followed shops** (`list_followed_shops`, read): The shops you follow in Kalodata, with their latest estimated revenue. - **Follow shop** (`follow_shop`, write): Follow a shop in Kalodata so it appears in your followed shops. - **Unfollow shop** (`unfollow_shop`, write): Stop following a shop in Kalodata. ### Creators and exports Contact details come only from the export, and the contact option depends on your Kalodata plan. The export reads; it contacts no creator. - **List top creators** (`list_top_creators`, read): Creator ranking for a market, category and date range, with estimated revenue. - **Get creator details** (`get_creator`, read): One creator with estimated revenue, top products and recent videos. - **Export creator list** (`export_creator_list`, read): Export creators from the Creator List with the Export option, optionally with contact information. ### Videos and livestreams Rankings by estimated revenue. Pass a product ID to see only the videos that promote it. - **List top videos** (`list_top_videos`, read): Video ranking for a market and date range, optionally for one product. - **List top livestreams** (`list_top_livestreams`, read): Livestream ranking for a market and date range, with estimated revenue. Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/kalodata-api-mcp-server#tools ## Who can see my Kalodata session, and how do I revoke it? - **What we store.** Your logged-in Kalodata profile, encrypted with AES-256-GCM, in Finland. Not the password. - **What your agent gets.** The 13 Kalodata tools. Never the cookie. - **What the session sees.** The rankings, details, follows and exports your plan shows you. - **What no tool touches.** Plan, billing, password and the account itself. - **If Kalodata signs you out.** Your agent gets a link to sign in again. You type the login, we never do. - **How to cut access.** Disable for agents, reset the browser, or sign out in Kalodata's account settings. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)). There is no SOC 2 report or third-party pentest yet. ## What happens when Kalodata changes? - **12 h** between tests of the Kalodata tools - **$0** for a call to a Kalodata tool paused for repair When Kalodata moves a filter or renames a column, the fix happens on our side and your prompts keep working. [status.cotlet.dev](https://status.cotlet.dev) watches the site, console and API every 3 minutes. ## What changes in Kalodata, and how to undo it 1. **Finds the shop.** Ranks shops for your category and skips the ones you already follow. 2. **Presses Follow.** Uses the Follow button on the shop details page. 3. **Changes only your list.** The shop is not told and no one else sees it. 4. **Reports the result.** Shop ID, name and following: true. | Action | Undo | |---|---| | Follow a shop | Run unfollow_shop, one call | | Unfollow a shop | Run follow_shop, one call | | Rankings and details | Nothing to undo, they only read | | Export a creator list | Nothing to undo, it only reads and contacts no creator | 2 of 13 tools write: follow_shop and unfollow_shop. Both change only your own followed list, and each undoes the other, so they run at once. You can still switch on a wait per tool in the Cotlet console. > Following shops one after another builds a watch list you can read back with list_followed_shops. MCP call: ``` { "name": "follow_shop", "arguments": { "shop_id": "8841002" } } ``` REST: ``` curl -X POST https://cotlet.dev/api/v1/kalodata/shops/8841002/follow \ -H "Authorization: Bearer $COTLET_API_KEY" ``` Tool output: ``` { "shop_id": "8841002", "name": "Glow Labs Store", "following": true } ``` Scripts and cron jobs reach the same tools over REST, with the same key and price. If your plan does not include the contact option of the export, the call returns Kalodata's message, and a failed call costs nothing. ## How much does the Kalodata MCP server cost? **About $14 a month** for a seller with weekly TikTok Shop research, 2,460 credits. Your Kalodata plan is billed by Kalodata as before. | Job | Calls | Credits | |---|---|---| | Rising products in a category, weekly | 7 × 4 | 280 | | Revenue of the shops you follow, weekly | 6 × 4 | 240 | | Creator shortlist with contacts | 9 × 2 | 180 | | Top videos for one product | 2 × 6 | 120 | | Find and follow new shops | 7 × 2 | 140 | | Cloud Browser, 30 days | | 1,500 | | Total | | 2,460 | - Free 7-day trial, no card - 10 credits per successful call, MCP or REST - 50 credits a day for the Cloud Browser - No Kalodata Open API credits to buy The month is our example: a weekly category and shop pass, 2 creator shortlists, 6 product video checks and 2 rounds of following new shops. Kalodata publishes no typical account size. Dollars at the $29 pack rate. ## Kalodata MCP server on GitHub or hosted: which to use | Option | What it does | Where it stops | |---|---|---| | [sailtonight/kalodata-skill](https://github.com/sailtonight/kalodata-skill) | The agent skill Kalodata's blog links. A kalo command line plus a local MCP server with 20 query tools. MIT, last commit 29 Oct 2026. | Needs an Open API key and spends its credits. Runs on your computer. No follow or export commands. | | [HDShinobi/kalodata-mcp](https://github.com/HDShinobi/kalodata-mcp) | Python MCP server over the Open API with 8 tools: category, product, creator and video rankings and details. 0 stars, last commit 7 Oct 2026. | Needs an Open API key. Rankings and details only. | | [walysonbento-byte/kalodata-mcp](https://github.com/walysonbento-byte/kalodata-mcp) | Another Open API wrapper. 1 star, last commit 1 Sep 2026. | Needs an Open API key. No description in the repo. | | [Kalodata Open API](https://www.kalodata.com/blog/kalodata/how-to-access-tiktok-shop-api-in-2026/) | Official ranking and detail endpoints for six data modules in 15 markets. | You write the code and pay per credit. Docs and price list are behind a Kalodata login. | The GitHub servers suit one developer who already has an Open API key and wants rankings on one computer. Cotlet adds follows and creator exports, hosted, with one sign-in and the same tools in ChatGPT, Claude and scripts. ## Who runs Cotlet Take Group sp. z o.o. runs Cotlet. It is a software company registered in Poland, EU (VAT PL6342984273), working since 2019, founded by Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev with questions about the Kalodata tools. ## Kalodata MCP server: questions ### How do I connect Kalodata to ChatGPT or Claude? Sign up at cotlet.dev, log in to Kalodata once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Kalodata account through Cotlet, in their phone apps too. ### What can ChatGPT do in Kalodata? With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Kalodata: find fast-growing products in a category; track competitor shops; build a creator shortlist with contacts. You ask in plain words, and anything that reaches other people waits for your OK first. ### How do I get access? Create a free account at https://cotlet.dev, open Kalodata under Integrations in the console and log in to Kalodata in its Cloud Browser. The trial starts with your first app, no card asked. ### Do I need a Kalodata Open API key? No. Cotlet works in your own Kalodata account and does not use the Open API, which Kalodata bills per credit (checked 5 Nov 2026). Your plan still decides what Kalodata shows you, such as how many rows a ranking returns and whether the contact option of the export is available. ### Can my agent export creator contacts? Yes, with export_creator_list and include_contacts set. Kalodata offers the export on PC and the contact information as an option of it. If your plan lacks that option, the call fails with Kalodata's message. The tool only reads: it contacts no creator, so you send any outreach yourself. ### Are the numbers exact? The tools return what Kalodata shows. Kalodata's figures for revenue and items sold are its estimates from public TikTok data, so use them to rank and compare rather than as exact sales. ### Does Kalodata have an official MCP server? Not yet. Kalodata's X post of 27 Aug 2026 lists MCP as coming soon, and we found no later release (checked 6 Nov 2026). Until then, Cotlet gives your agent hosted Kalodata tools over MCP and REST. ### Which TikTok Shop markets can I use? Kalodata lists 15 national sites, among them the United States, the United Kingdom, Germany, France and Japan (Kalodata blog, 14 Sep 2026). Your agent passes the market as Kalodata's market selector shows it, and your plan decides what you see. ### Is the MCP server different from the REST API? Only the door is different. Both expose the same 13 tools, inputs and answers, with one API key and one price. Agents use MCP; scripts and HTTP steps use REST. ### Is Cotlet affiliated with Kalodata? No. Cotlet is independent and not affiliated with Kalodata or Kalowave Technology. --- Give your AI agents your signed-in browser. **Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md) **Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet) **Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) **Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md) **Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors) **Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet) Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md) Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.