
Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)
A remote MCP server that connects your AI agent to 1.5 billion indexed posts across Twitter, Instagram, Reddit, and TikTok. You get 39 tools spanning search, user profiles, comment threads, follower graphs, and async CSV exports up to 500K rows. Authenticate once with Google OAuth, no platform API keys required. The tracking tools let you subscribe to ongoing monitoring of queries or accounts, useful for lead gen or brand watch. Works via streamable HTTP in Claude Desktop, Cursor, and friends. If you need to scrape social at scale from a prompt or build an agent that monitors competitors, this plugs straight in.
- GitHub stars
- 13
- tools
- 52
- transport
- HTTP
- last updated
- Jul 14, 2026
Install
From registry metadata$ npx add-mcp https://mcp.xpoz.ai/mcp --name social-insightsRun in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http social-insights https://mcp.xpoz.ai/mcpRun in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 52 toolsVerified live against the running server on Nov 6, 2026.
getTwitterUsersGet one or more Twitter user profiles by IDs or usernames (1-100 per request). Use identifierType="id" for numeric user IDs, identifierType="username" for usernames. All identifiers must be the same type. For single user: pass array of 1, e.g. identifiers=["elonmusk"]. For per...9 params
Get one or more Twitter user profiles by IDs or usernames (1-100 per request). Use identifierType="id" for numeric user IDs, identifierType="username" for usernames. All identifiers must be the same type. For single user: pass array of 1, e.g. identifiers=["elonmusk"]. For per...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarrayforceLatestbooleanidentifierType*stringid · usernameidentifiers*arrayuserPromptstringgetTwitterUserGet Twitter user profile by ID or username. Use identifierType="id" for numeric user ID, identifierType="username" for username. For username: Use ONLY when you have the precise username (e.g., "elonmusk"). For person names or fuzzy search, use searchTwitterUsers instead. Opti...9 params
Get Twitter user profile by ID or username. Use identifierType="id" for numeric user ID, identifierType="username" for username. For username: Use ONLY when you have the precise username (e.g., "elonmusk"). For person names or fuzzy search, use searchTwitterUsers instead. Opti...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarrayforceLatestbooleanidentifier*stringidentifierType*stringid · usernameuserPromptstringsearchTwitterUsersSearch users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., "Elon Musk", "Sam Altman"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, di...8 params
Search users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., "Elon Musk", "Sam Altman"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, di...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarraylimitnumbername*stringuserPromptstringgetTwitterUserConnectionsGet Twitter user connections (followers or following). Use connectionType="followers" for users who follow them, connectionType="following" for users they follow. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to r...14 params
Get Twitter user connections (followers or following). Use connectionType="followers" for users who follow them, connectionType="following" for users they follow. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to r...
_isTrialboolean_requestIdstring_trialTokenstringconnectionType*stringfollowers · followingfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberresponseTypestringfast · paging · csvtableNamestringuserPromptstringusername*stringgetTwitterUsersByKeywordsSearch for USERS who authored tweets/comments/quotes/retweets matching keywords. USE CASE: Find users who have posted content about specific topics, keywords, or phrases. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Ret...16 params
Search for USERS who authored tweets/comments/quotes/retweets matching keywords. USE CASE: Find users who have posted content about specific topics, keywords, or phrases. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Ret...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlanguagestringlimitnumberpageNumbernumberpageNumberEndnumberquery*stringresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringgetTwitterPostsByIdsGet multiple Twitter posts by numeric IDs (1-100 IDs per request). Returns results directly. Returns only found tweets, omitting not-found IDs for flexibility. First searches database, then external API for missing/stale data in parallel. Use when you have multiple exact post...8 params
Get multiple Twitter posts by numeric IDs (1-100 IDs per request). Returns results directly. Returns only found tweets, omitting not-found IDs for flexibility. First searches database, then external API for missing/stale data in parallel. Use when you have multiple exact post...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarrayforceLatestbooleanpostIds*arrayuserPromptstringgetTwitterPostsByAuthorGet posts from author by username with multiple response modes. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAG...15 params
Get posts from author by username with multiple response modes. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAG...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringusername*stringgetTwitterPostsByKeywordsSearch posts by keywords. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): Async pag...21 params
Search posts by keywords. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): Async pag...
_isTrialboolean_requestIdstring_trialTokenstringauthorIdstringauthorUsernamestringcountryCodestringendDatestringfeedbackstringfieldsarrayfilterOutRetweetsbooleanforceLatestbooleanlanguagestringlimitnumberpageNumbernumberpageNumberEndnumberquery*stringresponseTypestringfast · paging · csvsortBystringrelevance · lateststartDatestringtableNamestring+1 more parameters. See the server's own documentation for the full schema.
getTwitterPostRetweetsGet retweets of specific post. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Database-only. Results include guidance for full mode. PAGING (responseType="paging"): Async paginated results...14 params
Get retweets of specific post. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Database-only. Results include guidance for full mode. PAGING (responseType="paging"): Async paginated results...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarraylimitnumberpageNumbernumberpageNumberEndnumberpostId*stringresponseTypestringfast · pagingstartDatestringtableNamestringuserPromptstringgetTwitterPostQuotesGet quote posts of specific post. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): A...14 params
Get quote posts of specific post. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="paging"): A...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberpostId*stringresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringgetTwitterPostCommentsGet comments (replies) to specific post. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="pagi...14 params
Get comments (replies) to specific post. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results include guidance for full mode. PAGING (responseType="pagi...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberpostId*stringresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringcountTweetsCount tweets containing a specific phrase within a date range. Returns the total count of matching tweets (int) directly, or zero if none found. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases ("deep learning"), boolean expressions (AI AND crypto, bitcoi...8 params
Count tweets containing a specific phrase within a date range. Returns the total count of matching tweets (int) directly, or zero if none found. QUERY SYNTAX: Plain keywords (bitcoin, climate change), quoted phrases ("deep learning"), boolean expressions (AI AND crypto, bitcoi...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringphrase*stringstartDatestringuserPromptstringgetTwitterPostInteractingUsersGet users who interacted with a specific Twitter post (commenters, quoters, or retweeters). INTERACTION TYPES: "commenters" (users who replied to the post), "quoters" (users who quoted the post), "retweeters" (users who retweeted the post). FAST (default, omit responseType or...16 params
Get users who interacted with a specific Twitter post (commenters, quoters, or retweeters). INTERACTION TYPES: "commenters" (users who replied to the post), "quoters" (users who quoted the post), "retweeters" (users who retweeted the post). FAST (default, omit responseType or...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleaninteractionType*stringcommenters · quoters · retweeterslimitnumberpageNumbernumberpageNumberEndnumberpostId*stringresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringcheckOperationStatuscheckOperationStatus: poll an async operation and retrieve its results or CSV download URL. Use this after any tool call made with responseType="paging" or responseType="csv" — those return an operationId that must be polled via checkOperationStatus to get the actual data. Als...3 params
checkOperationStatus: poll an async operation and retrieve its results or CSV download URL. Use this after any tool call made with responseType="paging" or responseType="csv" — those return an operationId that must be polled via checkOperationStatus to get the actual data. Als...
_requestIdstringfeedbackstringoperationId*stringcancelOperationCancel running operation. Required: operationId. Gracefully stops operation at next checkpoint. Returns confirmation. Use checkOperationStatus to verify cancellation completed.3 params
Cancel running operation. Required: operationId. Gracefully stops operation at next checkpoint. Returns confirmation. Use checkOperationStatus to verify cancellation completed.
_requestIdstringfeedbackstringoperationId*stringgetInstagramPostsByIdsGet multiple Instagram posts by IDs (1-50 IDs per request). Returns results directly. Returns only found posts, omitting not-found IDs for flexibility. First searches database, then external API for missing/stale data in parallel. Use when you have multiple exact post IDs. NOT...8 params
Get multiple Instagram posts by IDs (1-50 IDs per request). Returns results directly. Returns only found posts, omitting not-found IDs for flexibility. First searches database, then external API for missing/stale data in parallel. Use when you have multiple exact post IDs. NOT...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarrayforceLatestbooleanpostIds*arrayuserPromptstringgetInstagramPostsByUserGet posts from Instagram user by ID or username with two response modes. Use identifierType="id" for numeric user ID, identifierType="username" for username. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce...16 params
Get posts from Instagram user by ID or username with two response modes. Use identifierType="id" for numeric user ID, identifierType="username" for username. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanidentifier*stringidentifierType*stringid · usernamelimitnumberpageNumbernumberpageNumberEndnumberresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringgetInstagramPostsByKeywordsSearch Instagram posts by keywords with two response modes. Searches in both post captions and video subtitles. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh d...15 params
Search Instagram posts by keywords with two response modes. Searches in both post captions and video subtitles. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh d...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberquery*stringresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringgetInstagramUserGet Instagram user profile by ID or username. Use identifierType="id" for numeric user ID, identifierType="username" for username. For username: Use ONLY when you have the precise username (e.g., "cristiano"). For person names or fuzzy search, use searchInstagramUsers instead....9 params
Get Instagram user profile by ID or username. Use identifierType="id" for numeric user ID, identifierType="username" for username. For username: Use ONLY when you have the precise username (e.g., "cristiano"). For person names or fuzzy search, use searchInstagramUsers instead....
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarrayforceLatestbooleanidentifier*stringidentifierType*stringid · usernameuserPromptstringsearchInstagramUsersSearch users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., "Cristiano Ronaldo", "Kim Kardashian"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy...8 params
Search users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., "Cristiano Ronaldo", "Kim Kardashian"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarraylimitnumbername*stringuserPromptstringgetInstagramUserConnectionsGet Instagram user connections (followers or following). Use connectionType="followers" for users who follow them, connectionType="following" for users they follow. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to...14 params
Get Instagram user connections (followers or following). Use connectionType="followers" for users who follow them, connectionType="following" for users they follow. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to...
_isTrialboolean_requestIdstring_trialTokenstringconnectionType*stringfollowers · followingfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberresponseTypestringfast · pagingtableNamestringuserPromptstringusername*stringgetInstagramPostInteractingUsersGet USER PROFILES of people who interacted with an Instagram post. Returns full user data (bio, followerCount, followingCount, etc.). RETURNS USER PROFILES: id, username, fullName, biography, followerCount, followingCount, isVerified, profilePicUrl. Use for analyzing WHO engag...14 params
Get USER PROFILES of people who interacted with an Instagram post. Returns full user data (bio, followerCount, followingCount, etc.). RETURNS USER PROFILES: id, username, fullName, biography, followerCount, followingCount, isVerified, profilePicUrl. Use for analyzing WHO engag...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarrayforceLatestbooleaninteractionType*stringcommenters · likerslimitnumberpageNumbernumberpageNumberEndnumberpostId*stringresponseTypestringfast · pagingtableNamestringuserPromptstringgetInstagramUsersByKeywordsSearch for USERS who authored Instagram posts matching keywords. USE CASE: Find users who have posted content about specific topics, keywords, or phrases. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Returns up to 300 r...15 params
Search for USERS who authored Instagram posts matching keywords. USE CASE: Find users who have posted content about specific topics, keywords, or phrases. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Returns up to 300 r...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberquery*stringresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringgetInstagramCommentsByPostIdGet COMMENT CONTENT (text, likes) for an Instagram post. Returns the actual comment objects with text and metadata. RETURNS COMMENT DATA: id, text, username, createdAtDate, likeCount, childCommentCount. Use for reading what people said. NOT FOR USER PROFILES: To get detailed u...15 params
Get COMMENT CONTENT (text, likes) for an Instagram post. Returns the actual comment objects with text and metadata. RETURNS COMMENT DATA: id, text, username, createdAtDate, likeCount, childCommentCount. Use for reading what people said. NOT FOR USER PROFILES: To get detailed u...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberpostId*stringresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringgetRedditUserGet Reddit user profile by username. Returns user profile including karma breakdown (link, comment, total), account status (gold, mod, employee), and profile info. Use without u/ prefix (e.g., "spez" not "u/spez"). Optional fields parameter for performance (default: ["id", "us...8 params
Get Reddit user profile by username. Returns user profile including karma breakdown (link, comment, total), account status (gold, mod, employee), and profile info. Use without u/ prefix (e.g., "spez" not "u/spez"). Optional fields parameter for performance (default: ["id", "us...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarrayforceLatestbooleanuserPromptstringusername*stringsearchRedditUsersSearch Reddit users by name, username, or profile description using real-time external API. PRIMARY USE: When given a person's name (e.g., "spez", "GallowBoob"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, disco...8 params
Search Reddit users by name, username, or profile description using real-time external API. PRIMARY USE: When given a person's name (e.g., "spez", "GallowBoob"), partial info, or uncertain username. Use for: Name-based search, finding multiple candidates, fuzzy matching, disco...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarraylimitintegername*stringuserPromptstringgetRedditUsersByKeywordsSearch for USERS who authored Reddit posts matching keywords. USE CASE: Find users who have posted content about specific topics. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Returns up to 300 results directly in one ca...16 params
Search for USERS who authored Reddit posts matching keywords. USE CASE: Find users who have posted content about specific topics. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Returns up to 300 results directly in one ca...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberquery*stringresponseTypestringfast · paging · csvstartDatestringsubredditstringtableNamestringuserPromptstringgetRedditPostsByKeywordsSearch Reddit posts by keywords with two response modes. Searches in post titles and selftext. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results incl...18 params
Search Reddit posts by keywords with two response modes. Searches in post titles and selftext. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh data. Results incl...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberquery*stringresponseTypestringfast · paging · csvsortstringrelevance · hot · top · new · commentsstartDatestringsubredditstringtableNamestringtimestringhour · day · week · month · year · alluserPromptstringgetRedditPostWithCommentsByIdGet Reddit post by ID with its comments. Returns both the post data and comments in a single response. FAST (default, omit responseType or responseType="fast"): Returns post and up to 300 comments directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh...13 params
Get Reddit post by ID with its comments. Returns both the post data and comments in a single response. FAST (default, omit responseType or responseType="fast"): Returns post and up to 300 comments directly (use limit param to reduce, e.g. limit=5). Auto API fallback for fresh...
_isTrialboolean_requestIdstring_trialTokenstringcommentFieldsarrayfeedbackstringforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberpostFieldsarraypostId*stringresponseTypestringfast · pagingtableNamestringgetRedditCommentsByKeywordsSearch Reddit comments by keywords. Searches in comment body text. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Results include guidance for full mode. PAGING (responseType="paging"): As...14 params
Search Reddit comments by keywords. Searches in comment body text. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). Results include guidance for full mode. PAGING (responseType="paging"): As...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarraylimitnumberpageNumbernumberpageNumberEndnumberquery*stringresponseTypestringfast · paging · csvstartDatestringsubredditstringtableNamestringgetRedditCommentByIdGet a single Reddit comment by its ID. Accepts the bare base36 comment id or the t1_-prefixed form (e.g. "laz1ytq" or "t1_laz1ytq"), as returned by getRedditPostWithCommentsById and getRedditCommentsByKeywords. First searches database, then fetches from the external API if the...7 params
Get a single Reddit comment by its ID. Accepts the bare base36 comment id or the t1_-prefixed form (e.g. "laz1ytq" or "t1_laz1ytq"), as returned by getRedditPostWithCommentsById and getRedditCommentsByKeywords. First searches database, then fetches from the external API if the...
_isTrialboolean_requestIdstring_trialTokenstringcommentId*stringfeedbackstringfieldsarrayforceLatestbooleansearchRedditSubredditsSearch Reddit subreddits by keywords using real-time external API. Searches subreddit names and descriptions to find communities. Use for: Discovering communities about topics, finding niche subreddits, exploring Reddit communities. Optional fields parameter for performance (d...8 params
Search Reddit subreddits by keywords using real-time external API. Searches subreddit names and descriptions to find communities. Use for: Discovering communities about topics, finding niche subreddits, exploring Reddit communities. Optional fields parameter for performance (d...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarraylimitintegerquery*stringuserPromptstringgetRedditSubredditWithPostsByNameGet Reddit subreddit by name with its posts. FAST (default, omit responseType or responseType="fast"): Returns subreddit data with up to 300 posts directly (use limit param to reduce). Auto API fallback for fresh data. PAGING (responseType="paging"): Async paginated results (1...13 params
Get Reddit subreddit by name with its posts. FAST (default, omit responseType or responseType="fast"): Returns subreddit data with up to 300 posts directly (use limit param to reduce). Auto API fallback for fresh data. PAGING (responseType="paging"): Async paginated results (1...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberpostFieldsarrayresponseTypestringfast · pagingsubredditFieldsarraysubredditName*stringtableNamestringgetRedditSubredditsByKeywordsSearch for SUBREDDITS where Reddit posts match keywords. Returns unique, deduplicated subreddit profiles. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce). Auto API fallback for fresh data. PAGING (respons...15 params
Search for SUBREDDITS where Reddit posts match keywords. Returns unique, deduplicated subreddit profiles. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce). Auto API fallback for fresh data. PAGING (respons...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberquery*stringresponseTypestringfast · pagingstartDatestringtableNamestringuserPromptstringgetTiktokUserGet Tiktok user profile by ID or username. Use identifierType="id" for numeric user ID, identifierType="username" for username. For username: Use ONLY when you have the precise username. For person names or fuzzy search, use searchTiktokUsers instead. Optional fields parameter...9 params
Get Tiktok user profile by ID or username. Use identifierType="id" for numeric user ID, identifierType="username" for username. For username: Use ONLY when you have the precise username. For person names or fuzzy search, use searchTiktokUsers instead. Optional fields parameter...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarrayforceLatestbooleanidentifier*stringidentifierType*stringid · usernameuserPromptstringsearchTiktokUsersSearch Tiktok users by name or username via external API. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getTiktokUser when username is certain). Optional fields parameter for performance (default...8 params
Search Tiktok users by name or username via external API. Use for: Name-based search, finding multiple candidates, fuzzy matching, discovering users. NOT for: Exact username lookup (use getTiktokUser when username is certain). Optional fields parameter for performance (default...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarraylimitnumbername*stringuserPromptstringgetTiktokUsersByKeywordsSearch for USERS who authored Tiktok posts matching keywords. USE CASE: Find users who have posted content about specific topics. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Returns up to 300 results directly in one ca...15 params
Search for USERS who authored Tiktok posts matching keywords. USE CASE: Find users who have posted content about specific topics. Returns unique, deduplicated user profiles. RESPONSE MODES (responseType parameter): "fast" (DEFAULT): Returns up to 300 results directly in one ca...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberquery*stringresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringgetTiktokUsersByHashtagsSearch for USERS who authored Tiktok posts tagged with specific hashtags. USE CASE: Find users who have posted content tagged with one or more hashtags. Returns unique, deduplicated user profiles. Pass hashtags as an array of bare alphanumeric strings - do NOT include leading...15 params
Search for USERS who authored Tiktok posts tagged with specific hashtags. USE CASE: Find users who have posted content tagged with one or more hashtags. Returns unique, deduplicated user profiles. Pass hashtags as an array of bare alphanumeric strings - do NOT include leading...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanhashtags*arraylimitnumberpageNumbernumberpageNumberEndnumberresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringgetTiktokPostsByIdsGet multiple Tiktok posts by IDs (1-100 IDs per request). Returns results directly. First searches database, then external API for missing/stale data. Optional fields parameter for performance: ["id", "description", "likeCount"]. Returns: results array with id, description, us...8 params
Get multiple Tiktok posts by IDs (1-100 IDs per request). Returns results directly. First searches database, then external API for missing/stale data. Optional fields parameter for performance: ["id", "description", "likeCount"]. Returns: results array with id, description, us...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarrayforceLatestbooleanpostIds*arrayuserPromptstringgetTiktokPostsByUserGet posts from Tiktok user by ID or username with three response modes. Use identifierType="id" for numeric user ID, identifierType="username" for username. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce,...16 params
Get posts from Tiktok user by ID or username with three response modes. Use identifierType="id" for numeric user ID, identifierType="username" for username. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce,...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanidentifier*stringidentifierType*stringid · usernamelimitnumberpageNumbernumberpageNumberEndnumberresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringgetTiktokPostsByKeywordsSearch Tiktok posts by keywords with three response modes. Searches post descriptions and video transcripts. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). PAGING (responseType="paging"):...15 params
Search Tiktok posts by keywords with three response modes. Searches post descriptions and video transcripts. FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). PAGING (responseType="paging"):...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberquery*stringresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringgetTiktokPostsByHashtagsSearch Tiktok posts by hashtags with three response modes. Searches the hashtags column directly (NOT post descriptions). Pass hashtags as an array of bare alphanumeric strings - do NOT include leading "#". OR semantics: matches posts containing ANY of the listed hashtags. FAS...15 params
Search Tiktok posts by hashtags with three response modes. Searches the hashtags column directly (NOT post descriptions). Pass hashtags as an array of bare alphanumeric strings - do NOT include leading "#". OR semantics: matches posts containing ANY of the listed hashtags. FAS...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanhashtags*arraylimitnumberpageNumbernumberpageNumberEndnumberresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringsearchTiktokSoundsSearch Tiktok sounds/music by keyword. Use to discover sound/music objects (by title, artist, or album), then pass the returned id to getTiktokPostsBySound to find posts using that sound. Optional fields parameter (default: ["id", "title", "author", "userCount"]). Returns: arr...8 params
Search Tiktok sounds/music by keyword. Use to discover sound/music objects (by title, artist, or album), then pass the returned id to getTiktokPostsBySound to find posts using that sound. Optional fields parameter (default: ["id", "title", "author", "userCount"]). Returns: arr...
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringfieldsarraykeyword*stringlimitnumberuserPromptstringgetTiktokPostsBySoundGet Tiktok posts that use a specific sound/music with three response modes. Required: soundId (numeric ID from searchTiktokSounds). FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). PAGING (r...15 params
Get Tiktok posts that use a specific sound/music with three response modes. Required: soundId (numeric ID from searchTiktokSounds). FAST (default, omit responseType or responseType="fast"): Returns up to 300 results directly (use limit param to reduce, e.g. limit=5). PAGING (r...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberresponseTypestringfast · paging · csvsoundId*stringstartDatestringtableNamestringuserPromptstringgetTiktokCommentsByPostIdGet COMMENT CONTENT (text, likes) for a Tiktok post. Returns the actual comment objects with text and metadata. RETURNS COMMENT DATA: id, text, username, createdAtDate, likeCount. Use for reading what people said. FAST (default, omit responseType or responseType="fast"): Retur...15 params
Get COMMENT CONTENT (text, likes) for a Tiktok post. Returns the actual comment objects with text and metadata. RETURNS COMMENT DATA: id, text, username, createdAtDate, likeCount. Use for reading what people said. FAST (default, omit responseType or responseType="fast"): Retur...
_isTrialboolean_requestIdstring_trialTokenstringendDatestringfeedbackstringfieldsarrayforceLatestbooleanlimitnumberpageNumbernumberpageNumberEndnumberpostId*stringresponseTypestringfast · paging · csvstartDatestringtableNamestringuserPromptstringgetUserAccessKeyRetrieve authenticated user access key. Required: authentication, confirmation. Returns: access key, metadata.3 params
Retrieve authenticated user access key. Required: authentication, confirmation. Returns: access key, metadata.
_requestIdstringconfirmRetrieval*booleanfeedbackstringcheckAccessKeyStatusCheck access key status without revealing key. Required: authentication. Returns: status, metadata.2 params
Check access key status without revealing key. Required: authentication. Returns: status, metadata.
_requestIdstringfeedbackstringgetTrackedItemsGet tracked keywords and users. Returns: phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only.4 params
Get tracked keywords and users. Returns: phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only.
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringaddTrackedItemsAdd keywords/users to track. Accepts array of items with phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only. Returns error if plan limit exceeded.5 params
Add keywords/users to track. Accepts array of items with phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only. Returns error if plan limit exceeded.
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringitems*arrayremoveTrackedItemsRemove tracked keywords/users. Accepts array of items with phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only. Use getTrackedItems first to see current items.5 params
Remove tracked keywords/users. Accepts array of items with phrase, type (keyword/user/subreddit/hashtag), platform (twitter/instagram/reddit/tiktok). Subreddit is Reddit-only, hashtag is TikTok-only. Use getTrackedItems first to see current items.
_isTrialboolean_requestIdstring_trialTokenstringfeedbackstringitems*arraygetAccountDetailsGet authenticated user's account details: plan (name, features), billing (period, next renewal date; null for Free plan), and usage (subscription credits remaining, extra credits remaining, extra tracked items). Required: authentication. Returns: nested plan/billing/usage object.2 params
Get authenticated user's account details: plan (name, features), billing (period, next renewal date; null for Free plan), and usage (subscription credits remaining, extra credits remaining, extra tracked items). Required: authentication. Returns: nested plan/billing/usage object.
_requestIdstringfeedbackstringgetCreditsUsageHistoryGet authenticated user's credits and export-rows usage over time, for analyzing usage patterns. Params: range ("today" | "7d" | "current_month" | "lifetime", default current_month), granularity ("hour" | "day", default day). Returns time-series buckets for both credits and exp...4 params
Get authenticated user's credits and export-rows usage over time, for analyzing usage patterns. Params: range ("today" | "7d" | "current_month" | "lifetime", default current_month), granularity ("hour" | "day", default day). Returns time-series buckets for both credits and exp...
_requestIdstringfeedbackstringgranularitystringhour · daydefault: dayrangestringtoday · 7d · current_month · lifetimedefault: current_monthSponsors
Readme
Xpoz MCP Server
Search Twitter, Instagram, Reddit & TikTok from any AI agent. Billions of posts indexed. Natural language queries. CSV exports up to 500K rows. No API keys needed.
Remote MCP server — no local installation required. Connect via Streamable HTTP and authenticate with OAuth 2.1 (sign in with Google, no API keys to manage). Direct probes to
https://mcp.xpoz.ai/mcpreturn401 Unauthorized— that's expected; your MCP client handles the OAuth flow.
Quick Start
Claude Desktop / Cursor / Windsurf
Add to your MCP config:
{
"mcpServers": {
"xpoz": {
"type": "streamable-http",
"url": "https://mcp.xpoz.ai/mcp"
}
}
}
Claude Code, Codex, Gemini CLI
# Claude Code
claude mcp add --transport http --scope user xpoz https://mcp.xpoz.ai/mcp
# Codex / Gemini CLI: see https://www.xpoz.ai/integrations
OpenClaw
clawhub install xpoz-social-search
Details
- Repository
- github.com/xpozpublic/xpoz-mcp
- Website
- www.xpoz.ai
- Categories
- Data & Analytics, Media & Entertainment
- Transport
- HTTP
- Registry
- MCP registry, active
- Resources
- 2
- Prompts
- 2
- Tools verified
- Nov 6, 2026