Kalodata MCP server Let your AI agent research TikTok Shop in Kalodata.

ToolWhat it doesAccess

• search_categories Find Kalodata categories by keyword, with their IDs. read

  Returns the categories whose names match the keyword, each with its ID, name and parent category. Use the ID as category_id in the ranking tools. It returns an empty list when nothing matches.

  MCP callkalodata_read → search_categories

  REST endpointGET https://cotlet.dev/api/v1/kalodata/categories/search

  Parameters

  Parameters: search_categories

  Name	Type	Description
  keyword string required	string	Word to look for in category names, for example "beauty".
  region string	string	Market as Kalodata's market selector shows it, for example US. Default: your account's current market.

  Example input

  {
    "keyword": "keyword"
  }

  Example response

  {
    "categories": [
      {
        "category_id": "600001",
        "name": "Beauty & Personal Care",
        "parent": null
      },
      {
        "category_id": "601450",
        "name": "Skincare",
        "parent": "Beauty & Personal Care"
      }
    ]
  }

• list_top_products Product ranking for a market, category and date range, with estimated revenue and items sold. read

  Returns one page of the Product ranking in the order of sort_by, highest first. Each row has the estimated revenue, estimated items sold and average unit price Kalodata shows for the date range. Figures are Kalodata's estimates. How many rows and how far back you can go depends on your plan. Pass product_id to get_product.

  MCP callkalodata_read → list_top_products

  REST endpointGET https://cotlet.dev/api/v1/kalodata/top-products

  Parameters

  Parameters: list_top_products

  Name	Type	Description
  region string	string	Market as Kalodata's market selector shows it, for example US. Default: your account's current market.
  category_id string	string	Category ID from search_categories. Leave out for all categories.
  period enum	enum	Date range of the ranking: last_7_days or last_30_days. Default: last_30_days.
  page integer	integer	Page of the ranking, starting at 1. Default: 1.
  sort_by enum	enum	revenue or items_sold. Default: revenue.
  keyword string	string	Only products whose name contains this word.

  Example response

  {
    "products": [
      {
        "product_id": "1729384650",
        "name": "Vitamin C serum",
        "revenue": 41200,
        "items_sold": 2310,
        "avg_unit_price": 17.84,
        "currency": "USD"
      },
      {
        "product_id": "1729391122",
        "name": "Heatless curler set",
        "revenue": 28900,
        "items_sold": 1874,
        "avg_unit_price": 15.42,
        "currency": "USD"
      }
    ],
    "page": 1
  }

• get_product One product with estimated revenue, items sold, average unit price and revenue by channel. read

  Returns the product page figures for the date range: estimated revenue, items sold, average unit price and the revenue split across video, livestream and shop channels. It also returns the daily revenue trend and the shop that sells it. Figures are Kalodata's estimates.

  MCP callkalodata_read → get_product

  REST endpointGET https://cotlet.dev/api/v1/kalodata/products/{product_id}

  Parameters

  Parameters: get_product

  Name	Type	Description
  product_id string required	string	Product ID from list_top_products.
  region string	string	Market as Kalodata's market selector shows it, for example US. Default: your account's current market.
  period enum	enum	Date range of the ranking: last_7_days or last_30_days. Default: last_30_days.

  Example input

  {
    "product_id": "product_8c41d2"
  }

  Example response

  {
    "product_id": "1729384650",
    "name": "Vitamin C serum",
    "shop_id": "8841002",
    "revenue": 41200,
    "items_sold": 2310,
    "avg_unit_price": 17.84,
    "currency": "USD",
    "revenue_by_channel": {
      "video": 30100,
      "livestream": 8200,
      "shop": 2900
    },
    "trend": [
      {
        "date": "2026-11-03",
        "revenue": 5600
      },
      {
        "date": "2026-11-04",
        "revenue": 6100
      }
    ]
  }

ToolWhat it doesAccess

• list_top_shops Shop ranking for a market, category and date range, with estimated revenue. read

  Returns one page of the Shop ranking by estimated revenue, highest first. Each row has the shop name, estimated revenue and items sold for the date range. Pass shop_id to get_shop or follow_shop. Figures are Kalodata's estimates.

  MCP callkalodata_read → list_top_shops

  REST endpointGET https://cotlet.dev/api/v1/kalodata/top-shops

  Parameters

  Parameters: list_top_shops

  Name	Type	Description
  region string	string	Market as Kalodata's market selector shows it, for example US. Default: your account's current market.
  category_id string	string	Category ID from search_categories. Leave out for all categories.
  period enum	enum	Date range of the ranking: last_7_days or last_30_days. Default: last_30_days.
  page integer	integer	Page of the ranking, starting at 1. Default: 1.

  Example response

  {
    "shops": [
      {
        "shop_id": "8841002",
        "name": "Glow Labs Store",
        "revenue": 96400,
        "items_sold": 5210,
        "currency": "USD"
      },
      {
        "shop_id": "8839417",
        "name": "Curl Society",
        "revenue": 71300,
        "items_sold": 4390,
        "currency": "USD"
      }
    ],
    "page": 1
  }

• get_shop One shop with estimated revenue trend, best-selling products and creator partners. read

  Returns the shop page figures for the date range: estimated revenue and items sold, the daily revenue trend, the best-selling products with their revenue, and how many creators promoted the shop. Figures are Kalodata's estimates.

  MCP callkalodata_read → get_shop

  REST endpointGET https://cotlet.dev/api/v1/kalodata/shops/{shop_id}

  Parameters

  Parameters: get_shop

  Name	Type	Description
  shop_id string required	string	Shop ID from list_top_shops or list_followed_shops.
  region string	string	Market as Kalodata's market selector shows it, for example US. Default: your account's current market.
  period enum	enum	Date range of the ranking: last_7_days or last_30_days. Default: last_30_days.

  Example input

  {
    "shop_id": "shop_8c41d2"
  }

  Example response

  {
    "shop_id": "8841002",
    "name": "Glow Labs Store",
    "revenue": 96400,
    "items_sold": 5210,
    "currency": "USD",
    "trend": [
      {
        "date": "2026-11-03",
        "revenue": 3100
      },
      {
        "date": "2026-11-04",
        "revenue": 3400
      }
    ],
    "top_products": [
      {
        "product_id": "1729384650",
        "name": "Vitamin C serum",
        "revenue": 41200
      }
    ],
    "creators_promoting": 38
  }

• list_followed_shops The shops you follow in Kalodata, with their latest estimated revenue. read

  Returns the shops your account follows, with the estimated revenue and items sold for the date range. It returns an empty list when you follow no shop. Use shop_id with get_shop or unfollow_shop.

  MCP callkalodata_read → list_followed_shops

  REST endpointGET https://cotlet.dev/api/v1/kalodata/followed-shops

  Parameters

  Parameters: list_followed_shops

  Name	Type	Description
  region string	string	Market as Kalodata's market selector shows it, for example US. Default: your account's current market.
  period enum	enum	Date range of the ranking: last_7_days or last_30_days. Default: last_30_days.

  Example response

  {
    "shops": [
      {
        "shop_id": "8841002",
        "name": "Glow Labs Store",
        "revenue": 96400,
        "items_sold": 5210,
        "currency": "USD"
      }
    ]
  }

• follow_shop Follow a shop in Kalodata so it appears in your followed shops. write

  Presses the Follow button on the shop details page. It reaches no one and changes only your own list. No confirmation is needed because unfollow_shop undoes it in one call. Following a shop you already follow changes nothing.

  MCP callkalodata_write → follow_shop

  REST endpointPOST https://cotlet.dev/api/v1/kalodata/shops/{shop_id}/follow

  Parameters

  Parameters: follow_shop

  Name	Type	Description
  shop_id string required	string	Shop ID from list_top_shops or list_followed_shops.

  Example input

  {
    "shop_id": "8841002"
  }

  Example response

  {
    "shop_id": "8841002",
    "name": "Glow Labs Store",
    "following": true
  }

• unfollow_shop Stop following a shop in Kalodata. write

  Removes the shop from your followed shops. It reaches no one, and follow_shop undoes it in one call, so it needs no confirmation.

  MCP callkalodata_write → unfollow_shop

  REST endpointPOST https://cotlet.dev/api/v1/kalodata/shops/{shop_id}/unfollow

  Parameters

  Parameters: unfollow_shop

  Name	Type	Description
  shop_id string required	string	Shop ID from list_top_shops or list_followed_shops.

  Example input

  {
    "shop_id": "shop_8c41d2"
  }

  Example response

  {
    "shop_id": "8841002",
    "name": "Glow Labs Store",
    "following": false
  }

ToolWhat it doesAccess

• list_top_creators Creator ranking for a market, category and date range, with estimated revenue. read

  Returns one page of the Creator ranking by estimated revenue, highest first. Each row has the creator's handle, follower count, estimated revenue and items sold. How many creators you see depends on your plan. Pass creator_id to get_creator or export_creator_list. Figures are Kalodata's estimates.

  MCP callkalodata_read → list_top_creators

  REST endpointGET https://cotlet.dev/api/v1/kalodata/top-creators

  Parameters

  Parameters: list_top_creators

  Name	Type	Description
  region string	string	Market as Kalodata's market selector shows it, for example US. Default: your account's current market.
  category_id string	string	Category ID from search_categories. Leave out for all categories.
  period enum	enum	Date range of the ranking: last_7_days or last_30_days. Default: last_30_days.
  page integer	integer	Page of the ranking, starting at 1. Default: 1.
  followers string	string	Follower range as min-max, for example 10000-1000000.

  Example response

  {
    "creators": [
      {
        "creator_id": "6812340071",
        "handle": "@maya.glows",
        "followers": 184000,
        "revenue": 22800,
        "items_sold": 1290,
        "currency": "USD"
      },
      {
        "creator_id": "6790012345",
        "handle": "@brushbyleo",
        "followers": 56000,
        "revenue": 14100,
        "items_sold": 980,
        "currency": "USD"
      }
    ],
    "page": 1
  }

• get_creator One creator with estimated revenue, top products and recent videos. read

  Returns the creator page figures for the date range: followers, estimated revenue and items sold, the products that sold most with their revenue, and the latest videos with views. Contact details are not returned here; use export_creator_list. Figures are Kalodata's estimates.

  MCP callkalodata_read → get_creator

  REST endpointGET https://cotlet.dev/api/v1/kalodata/creators/{creator_id}

  Parameters

  Parameters: get_creator

  Name	Type	Description
  creator_id string required	string	Creator ID from list_top_creators.
  region string	string	Market as Kalodata's market selector shows it, for example US. Default: your account's current market.
  period enum	enum	Date range of the ranking: last_7_days or last_30_days. Default: last_30_days.

  Example input

  {
    "creator_id": "creator_8c41d2"
  }

  Example response

  {
    "creator_id": "6812340071",
    "handle": "@maya.glows",
    "followers": 184000,
    "revenue": 22800,
    "items_sold": 1290,
    "currency": "USD",
    "top_products": [
      {
        "product_id": "1729384650",
        "name": "Vitamin C serum",
        "revenue": 9100
      }
    ],
    "recent_videos": [
      {
        "video_id": "7391100223",
        "views": 412000,
        "posted": "2026-10-29"
      }
    ]
  }

• export_creator_list Export creators from the Creator List with the Export option, optionally with contact information. read

  Runs Kalodata's Export on the Creator List for the creators you pick and returns the rows. Kalodata offers the export on PC and contact information as an option of it. If your plan does not include the contact option, the call fails with Kalodata's message and returns no rows. It only reads; it contacts no creator.

  MCP callkalodata_read → export_creator_list

  REST endpointGET https://cotlet.dev/api/v1/kalodata/creator-lists/export

  Parameters

  Parameters: export_creator_list

  Name	Type	Description
  creator_ids array required	array	Creator IDs from list_top_creators.
  include_contacts boolean	boolean	Add contact information to each row. Default: false.
  region string	string	Market as Kalodata's market selector shows it, for example US. Default: your account's current market.

  Example input

  {
    "creator_ids": "creator ids"
  }

  Example response

  {
    "rows": [
      {
        "creator_id": "6812340071",
        "handle": "@maya.glows",
        "followers": 184000,
        "revenue": 22800,
        "contact": {
          "email": "maya@example.com"
        }
      }
    ],
    "exported": 1
  }

ToolWhat it doesAccess

• list_top_videos Video ranking for a market and date range, optionally for one product. read

  Returns one page of the Video ranking by estimated revenue, highest first. Each row has the video link, creator handle, views, estimated revenue and the product it promotes. Figures are Kalodata's estimates.

  MCP callkalodata_read → list_top_videos

  REST endpointGET https://cotlet.dev/api/v1/kalodata/top-videos

  Parameters

  Parameters: list_top_videos

  Name	Type	Description
  region string	string	Market as Kalodata's market selector shows it, for example US. Default: your account's current market.
  category_id string	string	Category ID from search_categories. Leave out for all categories.
  period enum	enum	Date range of the ranking: last_7_days or last_30_days. Default: last_30_days.
  page integer	integer	Page of the ranking, starting at 1. Default: 1.
  product_id string	string	Only videos that promote this product ID.

  Example response

  {
    "videos": [
      {
        "video_id": "7391100223",
        "url": "https://www.tiktok.com/@maya.glows/video/7391100223",
        "creator": "@maya.glows",
        "views": 412000,
        "revenue": 7400,
        "product": "Vitamin C serum"
      }
    ],
    "page": 1
  }

• list_top_livestreams Livestream ranking for a market and date range, with estimated revenue. read

  Returns one page of the Livestream ranking by estimated revenue, highest first. Each row has the host, the shop, the stream date, viewers and estimated revenue. Figures are Kalodata's estimates.

  MCP callkalodata_read → list_top_livestreams

  REST endpointGET https://cotlet.dev/api/v1/kalodata/top-livestreams

  Parameters

  Parameters: list_top_livestreams

  Name	Type	Description
  region string	string	Market as Kalodata's market selector shows it, for example US. Default: your account's current market.
  category_id string	string	Category ID from search_categories. Leave out for all categories.
  period enum	enum	Date range of the ranking: last_7_days or last_30_days. Default: last_30_days.
  page integer	integer	Page of the ranking, starting at 1. Default: 1.

  Example response

  {
    "livestreams": [
      {
        "livestream_id": "7390008841",
        "host": "@glowlabs.live",
        "shop": "Glow Labs Store",
        "date": "2026-11-02",
        "viewers": 18400,
        "revenue": 8200,
        "currency": "USD"
      }
    ],
    "page": 1
  }