Hosted MCP server · #115 most used on Smithery

xpoz

net-service/xpoz

Social media intelligence for AI agents: search and analyze Twitter/X, Instagram, Reddit, and TikTok through natural language. Billions of posts indexed, including historical data. No social media API keys, no installation, just add the endpoint URL. Perfect for brand monitoring, competitive analysis, influencer research, market research, and OSINT. ## What You Can Do **Twitter/X:** - Get user profiles, followers, following lists - Search tweets by keywords with boolean operators - Analyze engagement (comments, quotes, retweets) - Export full datasets to CSV **Instagram:** - Look up user profiles and statistics - Search posts by keywords in captions - Get comments and post engagement **Reddit:** - Search posts and comments by keywords across all subreddits - Pull full threads with comment trees - Find and explore subreddits **TikTok:** - Search posts by keywords and hashtags - Look up users and their posts - Get comments and engagement data ## Why Xpoz? - One subscription covers all four platforms - Pre-indexed data: fast keyword search over billions of posts, including historical - Natural language queries via any MCP client (Claude, ChatGPT, Cursor) - Free tier to start, no credit card required Get started at https://xpoz.ai

Backend & APIs Data & databases DevOps & cloud Security Marketing & SEO Research & science

Install ↓Smithery ↗Website ↗

Uses: 4.8k
Tools: 27
Runs: Hosted
Prompts: 2
Listed: 12mo ago

Get started

Add it to your agent

npx -y @smithery/cli@latest install net-service/xpoz --client claude

Swap --client claude for cursor, vscode, windsurf or another client. The CLI asks for any required settings.

claude mcp add --transport http xpoz https://server.smithery.ai/net-service/xpoz/mcp

A hosted server: nothing to install. Run /mcp in Claude Code to sign in if it asks.

[mcp_servers.xpoz]
url = "https://server.smithery.ai/net-service/xpoz/mcp"

Add to ~/.codex/config.toml.

{
  "mcpServers": {
    "xpoz": {
      "url": "https://server.smithery.ai/net-service/xpoz/mcp"
    }
  }
}

Add to ~/.cursor/mcp.json.

{
  "servers": {
    "xpoz": {
      "type": "http",
      "url": "https://server.smithery.ai/net-service/xpoz/mcp"
    }
  }
}

Add to .vscode/mcp.json.

gemini mcp add --transport http xpoz https://server.smithery.ai/net-service/xpoz/mcp

Saved to .gemini/settings.json.

What it can do

27 tools

getTwitterUserById4 paramsGet Twitter user profile by numeric ID. Use when you have exact user ID. NOT for username - use getTwitterUserByUsername. Optional fields…

Get Twitter user profile by numeric ID. Use when you have exact user ID. NOT for username - use getTwitterUserByUsername. Optional fields parameter for performance (default: ["id", "username", "name"]). Available fields: id, username, name, description, location, followersCount, followingCount, verified, profileImageUrl, and more. Returns: id, username, name, bio, followers_count, following_count, tweet_count, created_at, authenticity_score, inauthentic_type.

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "username", "name"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protecte
`userId`	string
`_requestId`	string
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec

getTwitterUserByUsername4 paramsGet user profile by EXACT Twitter handle/username ONLY. CRITICAL: Use ONLY when you have the precise Twitter username (e.g., "elonmusk", …

Get user profile by EXACT Twitter handle/username ONLY. CRITICAL: Use ONLY when you have the precise Twitter username (e.g., "elonmusk", "OpenAI"). DO NOT use for person names (e.g., "Elon Musk", "Sam Altman") - use searchTwitterUsers instead. DO NOT use for partial matches or fuzzy search - use searchTwitterUsers instead. When to use: User explicitly provides Twitter handle (@username), or you already know exact username from previous context. When NOT to use: Given person's name, searching by

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "username", "name"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protecte
`username`	string
`_requestId`	string
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec

searchTwitterUsers5 paramsSearch users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., …

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, discovering users. NOT for: Exact username lookup (use getTwitterUserByUsername when username is certain). Optional fields parameter for performance (default: ["id", "username", "name"]). Available fields: id, username, name,

Parameter	Type	Description
`name`	string
`limit`	number
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "username", "name"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protecte
`_requestId`	string
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec

getTwitterFollowers8 paramsGet all users that follow a Twitter user (who follows them) with server-side pagination (100 users per page). Returns operation ID - IMME…

Get all users that follow a Twitter user (who follows them) with server-side pagination (100 users per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "username", "name"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protecte
`username`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getTwitterFollowing8 paramsGet all users that a Twitter user is following (who they follow) with server-side pagination (100 users per page). Returns operation ID -…

Get all users that a Twitter user is following (who they follow) with server-side pagination (100 users per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 se

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "username", "name"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protecte
`username`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getTwitterPostById5 paramsGet single Twitter post by numeric ID. First searches database, then external API if not found. Use when you have exact post ID. NOT for …

Get single Twitter post by numeric ID. First searches database, then external API if not found. Use when you have exact post ID. NOT for search - use getTwitterPostsByKeywords. Optional fields parameter for performance: ["id", "text", "retweetCount"]. Returns: id, text, authorId, createdAt, metrics (retweets, replies, quotes).

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "text", "authorUsername", "createdAtDate"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, creat
`postId`	string
`_requestId`	string
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a

getTwitterPostsByAuthorId10 paramsGet posts from author by numeric ID with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperat…

Get posts from author by numeric ID with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Downl

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "text", "authorUsername", "createdAtDate"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, creat
`endDate`	string
`authorId`	string
`startDate`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getTwitterPostsByAuthorUsername10 paramsGet posts from author by username with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperatio…

Get posts from author by username with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Downloa

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "text", "authorUsername", "createdAtDate"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, creat
`endDate`	string
`startDate`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab
`authorUsername`	string

getTwitterPostsByKeywords12 paramsSearch posts by keywords with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus t…

Search posts by keywords with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Download CSV and

Parameter	Type	Description
`query`	string	Full-text search of post content ONLY. Searches the text/content of posts, NOT author information. EXACT PHRASES: Wrap in double quotes - "machine learning" matches that exact phrase. KEYWORDS: Withou
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "text", "authorUsername", "createdAtDate"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, creat
`endDate`	string
`authorId`	string	Filter posts by author ID (numeric string). Alternative to authorUsername.
`language`	string
`startDate`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getTwitterPostRetweets8 paramsGet retweets of specific post with server-side pagination (100 posts per page, database-only). Returns operation ID - IMMEDIATELY call ch…

Get retweets of specific post with server-side pagination (100 posts per page, database-only). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTI

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "text", "authorUsername", "createdAtDate"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, creat
`postId`	string
`startDate`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getTwitterPostQuotes9 paramsGet quote posts of specific post with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperation…

Get quote posts of specific post with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Download

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "text", "authorUsername", "createdAtDate"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, creat
`postId`	string
`startDate`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getTwitterPostComments9 paramsGet comments (replies) to specific post with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOp…

Get comments (replies) to specific post with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: D

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "text", "authorUsername", "createdAtDate"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, creat
`postId`	string
`startDate`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

countTweets5 paramsCount tweets containing a specific phrase within a date range. Returns operation ID - IMMEDIATELY call checkOperationStatus to get result…

Count tweets containing a specific phrase within a date range. Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. Returns the total count of matching tweets (int), or zero if none found. QUERY SYNTAX: Use double quotes for exact phrase match (e.g., "climate crisis"). Without quotes, matches any word. ALWAYS use quotes when user requests exact count or specific

Parameter	Type	Description
`phrase`	string	Count only tweets containing the phrase
`endDate`	string	End date in YYYY-MM-DD format. Default: current date
`startDate`	string	Start date in YYYY-MM-DD format. Default: 6 months ago
`_requestId`	string
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec

checkOperationStatus2 paramsCheck status and retrieve results from background operations. Required: operationId. HANDLES TWO TYPES: (1) Query operations (op_toolname…

Check status and retrieve results from background operations. Required: operationId. HANDLES TWO TYPES: (1) Query operations (op_toolname_xxx): returns paginated results + dataDumpExportOperationId. (2) Export operations (op_datadump_xxx): returns S3 signed URL for CSV download. CRITICAL: You MUST keep polling until operation finishes. DO NOT stop until status is completed/failed/cancelled. POLLING LOOP: (1) Call immediately after getting operation ID. (2) If status=running, wait exactly 5 secon

Parameter	Type	Description
`_requestId`	string
`operationId`	string	The operation ID

cancelOperation2 paramsCancel running operation. Required: operationId. Gracefully stops operation at next checkpoint. Returns confirmation. Use checkOperationS…

Cancel running operation. Required: operationId. Gracefully stops operation at next checkpoint. Returns confirmation. Use checkOperationStatus to verify cancellation completed.

Parameter	Type	Description
`_requestId`	string
`operationId`	string	The operation ID

getInstagramPostById5 paramsGet single Instagram post by ID. First searches database, then external API if not found or data is stale (>3 days). Use when you have ex…

Get single Instagram post by ID. First searches database, then external API if not found or data is stale (>3 days). Use when you have exact post ID. Optional fields parameter for performance: ["id", "caption", "likeCount"]. Returns: id, caption, userId, username, createdAtDate, engagement metrics (likes, comments, reshares, video plays).

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "caption", "username", "createdAtDate"]. AVAILABLE FIELDS: Core: id, postType, userId, username, fullName, caption, crea
`postId`	string
`_requestId`	string
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a

getInstagramPostsByUserId10 paramsGet posts by Instagram user ID with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationSt…

Get posts by Instagram user ID with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Download C

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "caption", "username", "createdAtDate"]. AVAILABLE FIELDS: Core: id, postType, userId, username, fullName, caption, crea
`userId`	string
`endDate`	string
`startDate`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getInstagramPostsByUsername10 paramsGet posts by Instagram username with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationS…

Get posts by Instagram username with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Download

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "caption", "username", "createdAtDate"]. AVAILABLE FIELDS: Core: id, postType, userId, username, fullName, caption, crea
`endDate`	string
`username`	string
`startDate`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getInstagramPostsByKeywords10 paramsSearch Instagram posts by keywords with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperati…

Search Instagram posts by keywords with server-side pagination (100 posts per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Downlo

Parameter	Type	Description
`query`	string	Search query string. Supports keywords and phrases for searching Instagram posts.
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "caption", "username", "createdAtDate"]. AVAILABLE FIELDS: Core: id, postType, userId, username, fullName, caption, crea
`endDate`	string
`startDate`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getInstagramUserById4 paramsGet Instagram user profile by numeric ID. Use when you have exact user ID. NOT for username - use getInstagramUserByUsername. Optional fi…

Get Instagram user profile by numeric ID. Use when you have exact user ID. NOT for username - use getInstagramUserByUsername. Optional fields parameter for performance (default: ["id", "username", "fullName"]). Available fields: id, username, fullName, biography, isPrivate, isVerified, followerCount, followingCount, mediaCount, profilePicUrl, and more. Returns: userId, username, fullName, followerCount, followingCount, mediaCount, biography, isVerified, isPrivate, profilePicUrl.

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "username", "fullName"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: f
`userId`	string	Instagram user ID
`_requestId`	string
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec

getInstagramUserByUsername4 paramsGet user profile by EXACT Instagram username ONLY. CRITICAL: Use ONLY when you have the precise Instagram username (e.g., "instagram", "c…

Get user profile by EXACT Instagram username ONLY. CRITICAL: Use ONLY when you have the precise Instagram username (e.g., "instagram", "cristiano"). DO NOT use for person names (e.g., "Cristiano Ronaldo") - use searchInstagramUsers instead. DO NOT use for partial matches or fuzzy search - use searchInstagramUsers instead. When to use: User explicitly provides Instagram username (@username), or you already know exact username from previous context. When NOT to use: Given person's name, searching

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "username", "fullName"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: f
`username`	string	Instagram username (without @ symbol)
`_requestId`	string
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec

searchInstagramUsers5 paramsSearch users by person name, partial username, or fuzzy match using real-time external API. PRIMARY USE: When given person's name (e.g., …

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 matching, discovering users. NOT for: Exact username lookup (use getInstagramUserByUsername when username is certain). Optional fields parameter for performance (default: ["id", "username", "fullName"]). Available fields: i

Parameter	Type	Description
`name`	string	Search query for Instagram users. Supports partial name or username matching.
`limit`	number	Maximum number of users to return. Default: 10, Max: 10.
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "username", "fullName"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: f
`_requestId`	string
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec

getInstagramFollowers8 paramsGet all users that follow an Instagram user (who follows them) with server-side pagination (100 users per page). Returns operation ID - I…

Get all users that follow an Instagram user (who follows them) with server-side pagination (100 users per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seco

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "username", "fullName"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: f
`username`	string	Instagram username (without @ symbol)
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getInstagramFollowing8 paramsGet all users that an Instagram user is following (who they follow) with server-side pagination (100 users per page). Returns operation I…

Get all users that an Instagram user is following (who they follow) with server-side pagination (100 users per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "username", "fullName"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: f
`username`	string	Instagram username (without @ symbol)
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getInstagramCommentsByPostId10 paramsGet comments for an Instagram post with server-side pagination (100 comments per page). Returns operation ID - IMMEDIATELY call checkOper…

Get comments for an Instagram post with server-side pagination (100 comments per page). Returns operation ID - IMMEDIATELY call checkOperationStatus to get results. CRITICAL: Results are ONLY available via checkOperationStatus - do not try other tools or wait for user prompt. CSV EXPORT: Response includes dataDumpExportOperationId for downloading COMPLETE dataset as CSV. Use checkOperationStatus with dataDumpExportOperationId to get S3 download link (ready in ~30-60 seconds). CODE EXECUTION: Dow

Parameter	Type	Description
`fields`	array	PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): ["id", "text", "username", "createdAtDate"]. AVAILABLE FIELDS: Core: id, text, parentPostId, type, parentCommentId, repliedToCo
`postId`	string
`endDate`	string
`startDate`	string
`tableName`	string	Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response.
`_requestId`	string
`pageNumber`	number	Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page.
`userPrompt`	string	CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detec
`forceLatest`	boolean	USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., "get the latest", "most recent", "real-time"). WARNING: Increases latency a
`pageNumberEnd`	number	Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tab

getUserAccessKey2 paramsRetrieve authenticated user access key. Required: authentication, confirmation. Returns: access key, metadata.

Parameter	Type	Description
`_requestId`	string
`confirmRetrieval`	boolean	Must be true to retrieve key. Security confirmation required.

checkAccessKeyStatus1 paramCheck access key status without revealing key. Required: authentication. Returns: status, metadata.

Parameter	Type	Description
`_requestId`	string

Ready-made

Prompts

system-instructionsCRITICAL: Instructions that MUST be followed when using tools
performance-testDemonstrates why userPrompt is critical for performance

Readable data

Resources

usage-instructionsMUST READ: Instructions for optimal tool usage and performance
schema-docsDocumentation of the SingleStore tables schema for tweets and users data