Getting Started

The Getting Started skill guides you through setting up Xpoz with your preferred integration, verifying your account, and discovering what you can do. Follow the steps below to get up and running.

Choose Your Integration

MCP Server (Recommended)
Python SDK
TypeScript SDK
CLI

For Claude Code, add the Xpoz MCP server to ~/.claude.json:

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

OAuth authentication happens automatically on first use.

pip install xpoz
export XPOZ_API_KEY=your-key-here

npm install @xpoz/xpoz
export XPOZ_API_KEY=your-key-here

brew install xpoz-ai/tap/xpoz-cli
xpoz-cli auth login

Get a free access key at xpoz.ai/get-token.

Verify Your Setup

Check access key status

Run checkAccessKeyStatus to confirm your key is valid and see your current usage.

Get account details

Run getAccountDetails to see your plan, remaining quota, and tracked items.

Run a test query

Try a simple search like “Search Twitter for posts about AI agents” to confirm everything works end-to-end.

Set Up Tracking

Tracking gives you fresher data by continuously collecting results for your keywords, users, and hashtags. We recommend starting by tracking your brand name and key competitors. See Social Tracking for full details on how to configure and manage tracked items.

Skill Routing

If you want to…	Use this skill
Analyze sentiment around a brand or topic	Sentiment Analyzer
Export Twitter data to CSV	Twitter Data Export
Find influencers in a niche	Influencer Discovery
Research what Reddit thinks about something	Reddit Research
Compare brands head-to-head	Competitive Intelligence
Monitor security threats and CVEs	Security OSINT
Learn query syntax and best practices	Best Practices
Track keywords, users, or hashtags	Social Tracking

Getting Started

Choose Your Integration

Verify Your Setup

Set Up Tracking

Skill Routing

Next Steps

Browse All Skills

MCP Tools Reference

Query Syntax Guide

Response Modes

​Choose Your Integration

​Verify Your Setup

​Set Up Tracking

​Skill Routing

​Next Steps

Browse All Skills

MCP Tools Reference

Query Syntax Guide

Response Modes

Choose Your Integration

Verify Your Setup

Set Up Tracking

Skill Routing

Next Steps