Xpoz

You can connect to the Xpoz MCP Server to run natural language queries across social platforms and export results for analysis, all without managing API keys. This remote MCP server is accessed via a Streamable HTTP endpoint and uses Google OAuth for authentication, making it easy to integrate into your existing MCP client workflows.

How to use

To use the Xpoz MCP Server, configure your MCP client to point to the remote HTTP endpoint and authenticate with Google OAuth. You can perform natural language queries to retrieve social posts from Twitter, Instagram, Reddit, and TikTok, then export large result sets and apply server-side pagination to manage big data.

How to install

Prerequisites: ensure you have an MCP client installed or access via your preferred client integration. You will add the remote MCP server configuration to your MCP settings to connect to the server.

{
  "mcpServers": {
    "xpoz": {
      "type": "streamable-http",
      "url": "https://mcp.xpoz.ai/mcp"
    }
  }
}

Additional configuration and notes

Key features you can leverage after connecting include natural language queries, large CSV exports (up to 500K rows) via async operations, server-side pagination for handling large datasets, and field selection to retrieve only the data you need. Real-time data can be accessed with the forceLatest option to bypass caching when you require the freshest results. Authentication is handled via OAuth 2.1 through Google, so you won’t manage API keys directly.

Security: authenticate using Google OAuth when prompted by your MCP client. No API keys are required to access the MCP server.

Troubleshooting and tips

If you encounter issues with long-running exports, check the operation status through your client’s monitoring tools or any status polling APIs provided by the MCP client. Ensure you have network connectivity to the remote endpoint and that your OAuth session is active.

When you need up-to-date results, enable forceLatest to bypass any local cache and fetch real-time data from the remote server.

Available tools

searchTwitterUsers

Find users by name, bio, or keywords across Twitter to locate relevant profiles.

getTwitterUser

Retrieve a Twitter profile's details, including followers, biography, and metrics.

getTwitterUsersByKeywords

Discover Twitter users actively posting about specific topics using keywords.

getTwitterUserConnections

Fetch a Twitter user’s followers or the accounts they follow.

getTwitterPostsByKeywords

Search Twitter posts by keywords, hashtags, or mentions.

getTwitterPostsByAuthor

Retrieve tweets from a specific Twitter user.

getTwitterPostsByIds

Fetch specific tweets by their ID.

getTwitterPostComments

Obtain replies to a particular tweet.

getTwitterPostRetweets

Get the retweets of a tweet.

getTwitterPostQuotes

Retrieve quote tweets for a given post.

getTwitterPostInteractingUsers

Identify users who liked or retweeted a post.

countTweets

Count tweets that match a query, with hourly or daily aggregations.

checkOperationStatus

Poll the status of asynchronous export operations.

cancelOperation

Cancel a running export operation.

searchInstagramUsers

Find Instagram users by name or username.

getInstagramUser

Get Instagram profile details and metrics.

getInstagramUsersByKeywords

Discover Instagram users posting about certain topics.

getInstagramUserConnections

Retrieve followers or following lists.

getInstagramPostsByKeywords

Search Instagram posts by keywords or hashtags.

getInstagramPostsByUser

Get posts from a specific Instagram user.

getInstagramPostsByIds

Fetch specific Instagram posts by ID.

getInstagramPostInteractingUsers

Retrieve users who liked or commented on a post.

getInstagramCommentsByPostId

Get comments on a specific Instagram post.

searchRedditUsers

Find Reddit users by name.

getRedditUser

Get a Reddit user’s profile and karma.

getRedditUsersByKeywords

Discover Reddit users active in certain topics.

getRedditPostsByKeywords

Search Reddit posts across subreddits using keywords.

getRedditPostWithCommentsById

Retrieve a Reddit post with its full comment tree.

getRedditCommentsByKeywords

Search Reddit comments by keywords.