TikTok data for agents

Official6 tools

by tiktok

13 TikTok endpoints. Pay per call in USDC via x402.

sh.fetcher.tiktok/mcp — Model Context Protocol (MCP) Server

The sh.fetcher.tiktok/mcp server provides access to 13 TikTok endpoints. It uses a pay-per-call pricing model denominated in USDC via x402, making each endpoint invocation a separate billable request.

🛠️ Key Features

13 TikTok endpoints
Pay per call pricing
Billing in USDC via x402

🚀 Use Cases

Fetching data from TikTok through a fixed set of 13 endpoints

⚡ Developer Benefits

Clear endpoint count: 13 TikTok endpoints
Consistent monetization model: pay per call in USDC using x402

⚠️ Limitations

Limited to the provided set of 13 TikTok endpoints
Costs accrue per call (priced in USDC via x402)

Captured live from the server via tools/list.

search_endpoints

Free. Search fetcher.sh's TikTok endpoints by keyword. Returns paths, descriptions and per-call prices. Start here.

Parameters1

query

string

optional

Keywords, e.g. 'twitter followers' or 'reviews'

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords, e.g. 'twitter followers' or 'reviews'"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

describe_endpoint

Free. Show the full call signature for one endpoint: required and optional parameters, allowed values, price, and response shape.

Parameters1

path

string

required

Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path, e.g. /api/twitter/search or /api/twitter/handle/{handle}"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fetch_data

Paid. Fetch live data from any TikTok endpoint. Pass the endpoint path plus its parameters (path and query parameters together in `params`). Priced per call in USDC on Base, Polygon, Arbitrum, Monad or Solana: pay with x402, or send an Authorization: Bearer bby_live_... header to spend prepaid credits. Call describe_endpoint first if unsure about parameters.

Parameters2

path	string	required	Endpoint path from search_endpoints, e.g. /api/tiktok/post/search
params	object	optional	All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Endpoint path from search_endpoints, e.g. /api/tiktok/post/search"
    },
    "params": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      },
      "description": "All parameters for the endpoint, path and query alike, e.g. { query: 'x402', sort: 'Latest' }"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_balance

Free. Show the remaining credit balance for the API key sent in this connection's Authorization header. Call this before a long run of paid requests.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

topup_credits

Paid (the amount you choose, minimum $1). Buy prepaid credits with x402 so later calls skip the per-call payment round trip. With an Authorization: Bearer bby_live_... header on this connection it recharges that key. Without one, the paying wallet becomes the account and a new API key is minted and returned once — store it as a secret, it cannot be recovered.

Parameters2

amount	number	required	Amount to add, in USD. Minimum 1.
rotate	boolean	optional	Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent.

Raw schema

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number",
      "minimum": 1,
      "description": "Amount to add, in USD. Minimum 1."
    },
    "rotate": {
      "type": "boolean",
      "description": "Mint a replacement key for the paying wallet, invalidating the old one immediately. Only valid when no Authorization header is sent."
    }
  },
  "required": [
    "amount"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tiktok_post_search

Paid ($0.004). Post search — TikTok. Live data as JSON. Pay with x402 or an Authorization: Bearer bby_live_... credits key.

Parameters5

keyword	string	required	Required.
cursor	string	optional	Optional.
region	string	optional	Optional.
sortType	string	optional	Optional. One of: RELEVANCE, MOST_LIKED, DATE_POSTED.
dateRange	string	optional	Optional. One of: ALL_TIME, YESTERDAY, THIS_WEEK, THIS_MONTH, LAST_THREE_MONTHS, LAST_SIX_MONTHS.

Raw schema

{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "description": "Required."
    },
    "cursor": {
      "type": "string",
      "description": "Optional."
    },
    "region": {
      "type": "string",
      "description": "Optional."
    },
    "sortType": {
      "type": "string",
      "enum": [
        "RELEVANCE",
        "MOST_LIKED",
        "DATE_POSTED"
      ],
      "description": "Optional. One of: RELEVANCE, MOST_LIKED, DATE_POSTED."
    },
    "dateRange": {
      "type": "string",
      "enum": [
        "ALL_TIME",
        "YESTERDAY",
        "THIS_WEEK",
        "THIS_MONTH",
        "LAST_THREE_MONTHS",
        "LAST_SIX_MONTHS"
      ],
      "description": "Optional. One of: ALL_TIME, YESTERDAY, THIS_WEEK, THIS_MONTH, LAST_THREE_MONTHS, LAST_SIX_MONTHS."
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (6)

search_endpointsdescribe_endpointfetch_datacheck_balancetopup_creditstiktok_post_search

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://tiktok.fetcher.sh/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://tiktok.fetcher.sh/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

TikTok data for agents - agentage MCP Catalog