Model Context Protocol

KOLSprite MCP Service

Expose TikTok creator, video, product and shop data to AI assistants through MCP tool calls — powered by KSS Open API.

Choose Your MCP Plan

Get an independent MCP Key with monthly or yearly billing. API Key and MCP Key are billed separately.

Monthly Plan

$19/mo
Original price: $ 29/mo
Plan Benefits
MCP Tools4 modules
Rate limit40 calls/min
Monthly quota1,000 calls
TransportSSE
BillingIndependent from API Key
Best Value

Yearly Plan

$190/yr
Original price: $ 290/yr
Plan Benefits
MCP Tools4 modules
Rate limit40 calls/min
Monthly quota4,000 calls
TransportSSE
BillingIndependent from API Key
MCP Endpointhttps://mcp.kolsprite.com/sse
TransportSSE
Authenticationsecret-key: <your_mcp_key>
API Base URLhttps://open.kolsprite.com

Four Data Modules

Each MCP tool maps to a KSS Open API endpoint. Use natural language in your AI client to search TikTok commerce data.

POST/api/creator/search
View API docs

Creator Search

Search TikTok creators by fans, engagement, sales volume, categories and more.

MCP Toolcreator_search
Key filter parameters
regionkeywordfansCntplayCntinteractcategoryListsalesVolume
Key response fields
nameuniqueIdfansCntinteractionRatesalesVolumegpmgoodsCategory
Example prompt

Find US beauty creators with 100k+ followers and sales volume over 100.

POST/api/video/search
View API docs

Video Search

Search shoppable TikTok videos by views, 30-day sales, publish date, linked shop or product.

MCP Toolvideo_search
Key filter parameters
regionkeywordplayCntproductsalesVolumeLst30dpubDateshopId
Key response fields
titleplayCntsalesVolumeLst30dcreator.nameproduct.titleproduct.price
Example prompt

Search US skincare shoppable videos with 30-day sales above 500.

POST/api/product/search
View API docs

Product Search

Search TikTok Shop products by price, sales, rating, category, fulfillment and logistics type.

MCP Toolproduct_search
Key filter parameters
regionkeywordpricesalesVolumeLst30dratingcatIdsftlt
Key response fields
titlepricesalesVolumeLst30dratingreviewsshopName
Example prompt

Find US serums priced $10–50 with 30-day sales over 1000 and rating above 4.0.

POST/api/shop/search
View API docs

Shop Search

Search TikTok Shop stores by rating, sales, influencer count, product count and service metrics.

MCP Toolshop_search
Key filter parameters
regionkeywordratingsalesVolumeLst30dinfluencerproductsshopType
Key response fields
shopNameratingsalesVolumeLst30dinfluencersrespondRateshipRate
Example prompt

Find US beauty shops rated 4.5+ with 30-day sales over 5000.

POST/api/creator/search
View API docs

Creator Search

Search TikTok creators by fans, engagement, sales volume, categories and more.

MCP Toolcreator_search
Key filter parameters
regionkeywordfansCntplayCntinteractcategoryListsalesVolume
Key response fields
nameuniqueIdfansCntinteractionRatesalesVolumegpmgoodsCategory
Example prompt

Find US beauty creators with 100k+ followers and sales volume over 100.

Available MCP Tools

After connecting, the kol service registers these tools for AI auto-invocation.

ToolDescriptionAPI Endpoint
creator_searchMulti-dimensional TikTok creator search/api/creator/search
video_searchVideo search and filtering/api/video/search
product_searchProduct search and sales analysis/api/product/search
shop_searchShop search and rating query/api/shop/search

MCP and API share the same data source but have independent rate limits. Default: 20 calls/minute per MCP Key, monthly quota by plan. Exceeding limits returns ERROR_API_MINUTE_MAX / ERROR_API_MONTH_MAX.

Basic Configuration

Standard mcpServers snippet for Cherry Studio, Claude Desktop, Cursor, Windsurf and other SSE-compatible clients.

mcpServers
{
  "mcpServers": {
    "kol": {
      "url": "https://mcp.kolsprite.com/sse",
      "type": "sse",
      "headers": {
        "secret-key": "<your_mcp_key>"
      }
    }
  }
}

Getting Started

Follow these steps to connect KOLSprite MCP in your AI client.

  1. 1

    Apply for MCP Key

    Contact your administrator to enable MCP access and obtain your secret-key. MCP and API billing/limits are independent.

  2. 2

    Choose an MCP client

    Recommended: Cherry Studio, Claude Desktop, Cursor, Windsurf. Ensure the client supports SSE remote MCP servers.

  3. 3

    Open MCP config file

    Config location varies by client — e.g. ~/.cursor/mcp.json for Cursor, claude_desktop_config.json for Claude Desktop.

  4. 4

    Paste config and replace Key

    Merge the JSON above into your client config and replace secret-key with your MCP Key.

  5. 5

    Restart client / refresh MCP

    Save and restart, or click Refresh in MCP settings. When kol shows Connected, setup is complete.

  6. 6

    Use in conversation

    Ask in natural language, e.g. "Find US beauty creators with 100k+ followers" — the model will call the matching tool automatically.

FAQ