xpoz-getting-started

Getting Started with Xpoz

Overview

Xpoz is a social media intelligence platform providing access to Twitter/X, Instagram, Reddit, and TikTok data — no social media API keys required. This plugin connects Cursor to Xpoz via MCP, giving you 48 tools for searching posts, looking up users, tracking keywords, and exporting data.

When to Use

Activate when the user asks:

• "Help me set up Xpoz"
• "What's my Xpoz account status?"
• "Connect to Xpoz social media data"
• "What can I do with Xpoz?"
• "Set up tracking for my brand"
• "I'm new to Xpoz, where do I start?"

Step 1: Check MCP Connection

Try calling checkAccessKeyStatus to verify the Xpoz MCP server is connected.

If it returns hasAccessKey: true, skip to Step 3.

Step 2: Configure MCP Connection

If the MCP server is not connected, guide the user:

Get an Access Token

Ask the user:

"Go to https://xpoz.ai/get-token (free, no credit card) and paste the token here."

WAIT for the user to reply with the token. Do not proceed until they respond.

Add to Cursor MCP Settings

Add this to Cursor's MCP settings (~/.cursor/mcp.json or via Cursor Settings → MCP):

{
  "mcpServers": {
    "xpoz": {
      "url": "https://mcp.xpoz.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Replace YOUR_TOKEN_HERE with the token from the user.

After saving, reload Cursor or restart the MCP server.

Auth Errors

Problem	Solution
"Unauthorized"	Verify token at xpoz.ai/settings
Token exchange fails	Ask user to re-authorize — codes are single-use

Step 3: Verify Your Setup

Call getAccountDetails to retrieve the user's account information. Present a summary:

## Your Xpoz Account

**Plan:** [plan name]
**Billing period:** [start] – [end]
**Next renewal:** [date]

### Usage
- Subscription credits remaining: [X]
- Extra credits: [X]
- Tracked items: [X] / [limit]