MCP

TikTok Intelligence for Brands, Creators, and Trend Teams MCP Server

MCP tools for TikTok

Base URL

https://mcp.pressmonitor.com/tiktok/v1

Authentication

MCP calls also use Bearer tokens over JSON-RPC 2.0 requests.

Authorization: Bearer YOUR_TOKEN

Discover Tools

Start by listing the tools exposed by the MCP server.

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
tool challenge_info

Challenge Info

Challenge Info

Arguments

Name Type Required Description
challenge_id string Yes Challenge id
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"challenge_info","arguments":{"challenge_id":"SOME_STRING_VALUE","device_id":"SOME_STRING_VALUE"}}}'
tool challenge_posts

Challenge Posts

Challenge Posts

Arguments

Name Type Required Description
challenge_id string Yes Challenge id
count string No Number of results to return
cursor string No Cursor
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"challenge_posts","arguments":{"challenge_id":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE"}}}'
tool collection_info

Collection Info

Collection Info

Arguments

Name Type Required Description
collection_id string Yes Collection id
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"collection_info","arguments":{"collection_id":"SOME_STRING_VALUE","device_id":"SOME_STRING_VALUE"}}}'
tool collection_posts

Collection Posts

Collection Posts

Arguments

Name Type Required Description
collection_id string Yes Collection id
count string No Number of results to return
cursor string No Cursor
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"collection_posts","arguments":{"collection_id":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE"}}}'
tool download_music

Download Music

Download Music

Arguments

Name Type Required Description
music_id string Yes Music id
device_id string No Device id
format string No Format

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"download_music","arguments":{"music_id":"SOME_STRING_VALUE","device_id":"SOME_STRING_VALUE","format":"SOME_STRING_VALUE"}}}'
tool download_video

Download Video

Download Video

Arguments

Name Type Required Description
aweme_id string Yes Aweme id
device_id string No Device id
format string No Format

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"download_video","arguments":{"aweme_id":"SOME_STRING_VALUE","device_id":"SOME_STRING_VALUE","format":"SOME_STRING_VALUE"}}}'
tool effect_info

Effect Info

Effect Info

Arguments

Name Type Required Description
effect_id string Yes Effect id
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"effect_info","arguments":{"effect_id":"SOME_STRING_VALUE","device_id":"SOME_STRING_VALUE"}}}'
tool effect_posts

Effect Posts

Effect Posts

Arguments

Name Type Required Description
effect_id string Yes Effect id
count string No Number of results to return
cursor string No Cursor
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"effect_posts","arguments":{"effect_id":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE"}}}'
tool live_category

Live Category

Live Category

Arguments

Name Type Required Description
device_id string No Device id
lang string No Lang

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"live_category","arguments":{"device_id":"SOME_STRING_VALUE","lang":"en"}}}'
tool live_check_alive

Live Check Alive

Live Check Alive

Arguments

Name Type Required Description
room_id string Yes Room id
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"live_check_alive","arguments":{"room_id":"SOME_STRING_VALUE","device_id":"SOME_STRING_VALUE"}}}'
tool live_stream

Live Stream

Live Stream

Arguments

Name Type Required Description
room_id string Yes Room id
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"live_stream","arguments":{"room_id":"SOME_STRING_VALUE","device_id":"SOME_STRING_VALUE"}}}'
tool music_info

Music Info

Music Info

Arguments

Name Type Required Description
music_id string Yes Music id
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"music_info","arguments":{"music_id":"SOME_STRING_VALUE","device_id":"SOME_STRING_VALUE"}}}'
tool music_posts

Music Posts

Music Posts

Arguments

Name Type Required Description
music_id string Yes Music id
count string No Number of results to return
cursor string No Cursor
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"music_posts","arguments":{"music_id":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE"}}}'
tool music_unlimited_sounds

Music Unlimited Sounds

Music Unlimited Sounds

Arguments

Name Type Required Description
music_id string Yes Music id
count string No Number of results to return
cursor string No Cursor
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"music_unlimited_sounds","arguments":{"music_id":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE"}}}'
tool place_info

Place Info

Place Info

Arguments

Name Type Required Description
challenge_id string Yes Challenge id
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"place_info","arguments":{"challenge_id":"SOME_STRING_VALUE","device_id":"SOME_STRING_VALUE"}}}'
tool place_posts

Place Posts

Place Posts

Arguments

Name Type Required Description
challenge_id string Yes Challenge id
count string No Number of results to return
cursor string No Cursor
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"place_posts","arguments":{"challenge_id":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE"}}}'
tool post_category

Post Category

Post Category

Arguments

Name Type Required Description
sec_uid string Yes Sec uid
category_type string No Category type
count string No Number of results to return
cursor string No Cursor
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"post_category","arguments":{"sec_uid":"SOME_STRING_VALUE","category_type":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE"}}}'
tool post_comments

Post Comments

Post Comments

Arguments

Name Type Required Description
aweme_id string Yes Aweme id
count string No Number of results to return
cursor string No Cursor
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"post_comments","arguments":{"aweme_id":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE"}}}'
tool post_detail

Post Detail

Post Detail

Arguments

Name Type Required Description
aweme_id string Yes Aweme id
device_id string No Device id
from string No From

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"post_detail","arguments":{"aweme_id":"SOME_STRING_VALUE","device_id":"SOME_STRING_VALUE","from":"SOME_STRING_VALUE"}}}'
tool post_discover_keyword

Post Discover Keyword

Post Discover Keyword

Arguments

Name Type Required Description
keyword string Yes Keyword
count string No Number of results to return
cursor string No Cursor
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"post_discover_keyword","arguments":{"keyword":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE"}}}'
tool post_related

Post Related

Post Related

Arguments

Name Type Required Description
aweme_id string Yes Aweme id
count string No Number of results to return
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"post_related","arguments":{"aweme_id":"SOME_STRING_VALUE","count":20,"device_id":"SOME_STRING_VALUE"}}}'
tool post_reply_comments

Post Reply Comments

Post Reply Comments

Arguments

Name Type Required Description
aweme_id string Yes Aweme id
comment_id string Yes Comment id
count string No Number of results to return
cursor string No Cursor
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"post_reply_comments","arguments":{"aweme_id":"SOME_STRING_VALUE","comment_id":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE"}}}'
tool search_account

Search Account

Search Account

Arguments

Name Type Required Description
keyword string Yes Keyword
count string No Number of results to return
cursor string No Cursor
device_id string No Device id
search_id string No Search id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_account","arguments":{"keyword":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE","search_id":"SOME_STRING_VALUE"}}}'
tool search_general

Search General

Search General

Arguments

Name Type Required Description
keyword string Yes Keyword
count string No Number of results to return
cursor string No Cursor
search_id string No Search id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_general","arguments":{"keyword":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","search_id":"SOME_STRING_VALUE"}}}'
tool search_live

Search Live

Search Live

Arguments

Name Type Required Description
keyword string Yes Keyword
count string No Number of results to return
cursor string No Cursor
device_id string No Device id
search_id string No Search id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_live","arguments":{"keyword":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE","search_id":"SOME_STRING_VALUE"}}}'
tool search_suggest_keyword

Search Suggest Keyword

Search Suggest Keyword

Arguments

Name Type Required Description
keyword string Yes Keyword
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_suggest_keyword","arguments":{"keyword":"SOME_STRING_VALUE","device_id":"SOME_STRING_VALUE"}}}'
tool search_video

Search Video

Search Video

Arguments

Name Type Required Description
keyword string Yes Keyword
count string No Number of results to return
cursor string No Cursor
device_id string No Device id
search_id string No Search id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_video","arguments":{"keyword":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE","search_id":"SOME_STRING_VALUE"}}}'
tool user_followers

User Followers

User Followers

Arguments

Name Type Required Description
sec_uid string Yes Sec uid
count string No Number of results to return
min_cursor string No Min cursor

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"user_followers","arguments":{"sec_uid":"SOME_STRING_VALUE","count":20,"min_cursor":"NEXT_CURSOR"}}}'
tool user_following

User Following

User Following

Arguments

Name Type Required Description
sec_uid string Yes Sec uid
count string No Number of results to return
cursor string No Cursor

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"user_following","arguments":{"sec_uid":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR"}}}'
tool user_info

User Info

User Info

Arguments

Name Type Required Description
sec_uid string No Sec uid
unique_id string No Unique id
with_commerce_info string No With commerce info

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"user_info","arguments":{"sec_uid":"SOME_STRING_VALUE","unique_id":"SOME_STRING_VALUE","with_commerce_info":"SOME_STRING_VALUE"}}}'
tool user_info_by_id

User Info By Id

User Info By Id

Arguments

Name Type Required Description
user_id string Yes User id
with_commerce_info string No With commerce info

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"user_info_by_id","arguments":{"user_id":"SOME_STRING_VALUE","with_commerce_info":"SOME_STRING_VALUE"}}}'
tool user_info_v2

User Info V2

User Info V2

Arguments

Name Type Required Description
sec_uid string No Sec uid
unique_id string No Unique id
with_commerce_info string No With commerce info

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"user_info_v2","arguments":{"sec_uid":"SOME_STRING_VALUE","unique_id":"SOME_STRING_VALUE","with_commerce_info":"SOME_STRING_VALUE"}}}'
tool user_playlist

User Playlist

User Playlist

Arguments

Name Type Required Description
sec_uid string Yes Sec uid
count string No Number of results to return
cursor string No Cursor

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"user_playlist","arguments":{"sec_uid":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR"}}}'
tool user_posts

User Posts

User Posts

Arguments

Name Type Required Description
sec_uid string Yes Sec uid
count string No Number of results to return
cursor string No Cursor
device_id string No Device id
from string No From
with_play_token string No With play token

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"user_posts","arguments":{"sec_uid":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE","from":"SOME_STRING_VALUE","with_play_token":"SOME_STRING_VALUE"}}}'
tool user_posts_liked

User Posts Liked

User Posts Liked

Arguments

Name Type Required Description
sec_uid string Yes Sec uid
count string No Number of results to return
cursor string No Cursor
device_id string No Device id
from string No From

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"user_posts_liked","arguments":{"sec_uid":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE","from":"SOME_STRING_VALUE"}}}'
tool user_posts_oldest

User Posts Oldest

User Posts Oldest

Arguments

Name Type Required Description
sec_uid string Yes Sec uid
count string No Number of results to return
cursor string No Cursor
device_id string No Device id
from string No From

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"user_posts_oldest","arguments":{"sec_uid":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE","from":"SOME_STRING_VALUE"}}}'
tool user_repost

User Repost

User Repost

Arguments

Name Type Required Description
sec_uid string Yes Sec uid
count string No Number of results to return
cursor string No Cursor

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"user_repost","arguments":{"sec_uid":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR"}}}'
tool user_story

User Story

User Story

Arguments

Name Type Required Description
sec_uid string Yes Sec uid
count string No Number of results to return
cursor string No Cursor
device_id string No Device id

Code Examples

curl -X POST \ 'https://mcp.pressmonitor.com/tiktok/v1' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer YOUR_TOKEN' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"user_story","arguments":{"sec_uid":"SOME_STRING_VALUE","count":20,"cursor":"NEXT_CURSOR","device_id":"SOME_STRING_VALUE"}}}'