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. Available via MCP tools, Python SDK, TypeScript SDK, and CLI.

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: Choose Your Integration Path

Situation	Path
Using an MCP-compatible AI agent (Claude Code, Cursor, Windsurf, etc.)	MCP
Building a Python application	Python SDK
Building a TypeScript/Node.js application	TypeScript SDK
Running from terminal	CLI

Quick check — already set up?

• MCP: call checkAccessKeyStatus — if it returns hasAccessKey: true, skip to Step 4
• SDK: try importing XpozClient — if no error, skip to Step 4

Step 2: Set Up Authentication

Recommended: a free access key

Real results need a real key: get a free access key (free tier, up to 75K results, no credit card), then follow your integration path (MCP, SDK, or CLI, below). MCP connections sign in with the same account via OAuth on first tool call.

MCP

Add the Xpoz MCP server to your agent's config. The server URL is https://mcp.xpoz.ai/mcp. Most MCP clients handle OAuth automatically on first tool call.

Example for Claude Code (~/.claude.json):

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

For other MCP clients, consult your agent's documentation for how to add an MCP server by URL.

Python SDK

pip install xpoz

Ask the user:

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

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

from xpoz import XpozClient
client = XpozClient("THE_KEY_FROM_USER")