Skip to main content
Claude Code connects to the Xpoz MCP server over HTTP, giving you access to all 48 tools directly from your terminal. Bearer token auth is the fastest path; OAuth is also supported for interactive workflows.

​
Setup

1

Get your access key

Sign up at xpoz.ai and copy your access key from the Get Token page.
2

Add the MCP server

Run a single command:
claude mcp add xpoz-mcp https://mcp.xpoz.ai/mcp \
  -t http \
  -H "Authorization: Bearer YOUR_API_KEY"
This registers the Xpoz MCP server with Claude Code. All 48 tools are discovered automatically on the next conversation.
3

Verify the connection

Start a new Claude Code session and ask:
Search Twitter for posts about "artificial intelligence" from the last week
If Claude calls getTwitterPostsByKeywords and returns results, the connection is working.

​
Alternative: Manual Configuration

Instead of the CLI command, you can add the server directly to your ~/.claude.json configuration file: 
{
  "mcpServers": {
    "xpoz-mcp": {
      "url": "https://mcp.xpoz.ai/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Restart Claude Code after editing the configuration file.

​
OAuth Authentication

If you prefer OAuth over a static bearer token, add the server without an authorization header: 
claude mcp add xpoz-mcp https://mcp.xpoz.ai/mcp -t http
Claude Code will initiate the OAuth 2.1 flow automatically when it first connects to the server. You authenticate with your Google account, and subsequent requests are handled with the issued JWT token.
OAuth requires the Xpoz MCP server to have Google OAuth enabled. See the Authentication page for details on configuring OAuth 2.1 with Google SSO.

​
What You Can Do

Once connected, ask Claude to perform any social media research task:
  • Search posts by keyword across Twitter, Instagram, Reddit, and TikTok
  • Look up user profiles and follower counts
  • Analyze engagement metrics and trends
  • Track keywords and users for continuous monitoring
  • Export large datasets in CSV format
See the full list of available tools in the MCP Tools reference, or explore pre-built research workflows in Agent Skills.

​
Next Steps

MCP Tools

Browse all 48 tools across 4 platforms

Query Syntax

Write effective search queries with boolean operators