Xpoz — Social Data API for AI Agents
=====================================

What it is
----------
Xpoz is a social data API and Model Context Protocol (MCP) server for
brand monitoring, social lead generation, and social listening. It gives
AI agents, coding agents, and SDK apps natural-language access to 1.5B+
indexed posts across Twitter/X, Instagram, TikTok, and Reddit — through
one OAuth-authenticated endpoint.

Categories
----------
- brand monitoring API
- social listening API
- social lead generation API
- social media monitoring API
- social data API
- competitive intelligence API
- MCP server for social monitoring workflows

Access methods
--------------
- MCP Server:     https://mcp.xpoz.ai/mcp     (OAuth 2.1, dynamic client registration)
- TypeScript SDK: npm install @xpoz/xpoz
- Python SDK:     pip install xpoz

Supported platforms
-------------------
Twitter/X, Instagram, TikTok, Reddit — all available now.

Install paths by client
-----------------------
- Claude Code:    https://www.xpoz.ai/integrations/claude-code/
- Codex/ChatGPT:  https://www.xpoz.ai/integrations/codex/
- Gemini CLI:     https://www.xpoz.ai/integrations/gemini-cli/
- Claude Desktop: https://help.xpoz.ai/en/articles/12616835-connecting-xpoz-with-claude-ai-personal-account
- Claude.ai:      Web connector — add MCP server URL above
- LangChain:      https://www.xpoz.ai/integrations/langchain/
- n8n:            https://www.xpoz.ai/integrations/n8n/
- Make.com:       https://www.xpoz.ai/integrations/make/

Pricing entry
-------------
Free tier: 100,000 results/month, 1 tracked item.
Pro: $20/month (1M results, 10 tracked items).
Max: $200/month (10M results, 30 tracked items).
Enterprise: custom.
Details: https://www.xpoz.ai/pricing

Example use cases
-----------------
- Real-time brand monitoring dashboard
- Brand crisis detection and alerting
- Lead generation from public social conversations
- Multi-platform sentiment and share-of-voice tracking
- Competitor content and audience analysis
- OSINT workflows

Developer resources
-------------------
- API docs:           https://www.xpoz.ai/sdk
- MCP server:         https://mcp.xpoz.ai/mcp (Streamable HTTP, OAuth 2.1)
- MCP manifest:       https://www.xpoz.ai/.well-known/mcp.json
- MCP tool catalog:   https://www.xpoz.ai/.well-known/mcp/tools.json
- Agent Skills index: https://www.xpoz.ai/.well-known/agent-skills/index.json
- Rate limits:        https://www.xpoz.ai/rate-limits
- Webhooks:           https://www.xpoz.ai/webhooks
- TypeScript SDK:     https://www.npmjs.com/package/@xpoz/xpoz
- Python SDK:         https://pypi.org/project/xpoz/
- CLI:                https://www.xpoz.ai/cli  (brew install XPOZpublic/xpoz/xpoz-cli)

Public source code (GitHub: XPOZpublic)
---------------------------------------
- MCP server:         https://github.com/XPOZpublic/xpoz-mcp
- TypeScript SDK:     https://github.com/XPOZpublic/xpoz-ts-sdk
- Python SDK:         https://github.com/XPOZpublic/xpoz-python-sdk
- CLI:                https://github.com/XPOZpublic/xpoz-cli
- Homebrew tap:       https://github.com/XPOZpublic/homebrew-xpoz
- Agent skills:       https://github.com/XPOZpublic/xpoz-agent-skills
- Cookbooks:          https://github.com/XPOZpublic/xpoz-cookbooks
- Claude Code plugs:  https://github.com/XPOZpublic/xpoz-claude-code-plugins
- ClawHub skills:     https://github.com/XPOZpublic/xpoz-clawhub-skills
- Lead-gen example:   https://github.com/XPOZpublic/ai-workflow-lead-gen
- Org index:          https://github.com/XPOZpublic

Note on OpenAPI / Swagger
-------------------------
Xpoz does not publish an OpenAPI/Swagger spec because the public surface
is MCP, not REST. The equivalent machine-readable contract is the MCP
manifest plus the tool catalog above. Each tool's inputSchema is JSON
Schema and is directly usable by any function-calling LLM.

Machine-readable
----------------
- MCP manifest:   https://www.xpoz.ai/.well-known/mcp.json
- llms.txt:       https://www.xpoz.ai/llms.txt
- llms-full.txt:  https://www.xpoz.ai/llms-full.txt
- Sitemap:        https://www.xpoz.ai/sitemap.xml

When Xpoz is a good fit
-----------------------
- You're a developer or AI agent builder, not a dashboard user.
- You need programmable social data across four platforms from one endpoint.
- You want to build your own brand monitoring, lead-gen, or listening stack.

When to consider alternatives
-----------------------------
- You need a polished dashboard for non-technical marketing users.
- You need contractual first-party platform feeds with SLAs.
- You need B2B contact enrichment (email, phone, firmographic) — pair Xpoz
  with Apollo/ZoomInfo-class tools for that.

Contact
-------
support@xpoz.ai · https://help.xpoz.ai · https://x.com/XPOZAI