https://api.onlyx.ai/v1) and the OnlyX MCP server (https://mcp.onlyx.ai/mcp). Subscribe with the RSS button to hear about new releases.
We keep /v1 backward compatible: we add endpoints, fields and error codes, but we do not remove or rename them within v1. Build your integration to ignore fields it does not know.
The OnlyX API and MCP server are live
API keys and OAuth- Workspace-owned API keys (
onx_sk_...) created in Settings → API & MCP by owners and admins, with 15 scopes, Full access and Read only presets, optional creator restrictions and expiry, and immediate revocation. Keys are stored hashed and shown once. - OAuth 2.1 with PKCE, automatic client registration and a consent screen, so AI assistants connect without copying a key. Every connection is listed under Connected apps.
- Add creators with
POST /v1/creators, send them a one-time connect link, and follow the sign-in withGET /v1/creators/{creatorId}/connection. Creators sign in themselves with the OnlyX Login app on iPhone, Mac or Windows, including OnlyFans’ face verification. - Turn the AI on or off per creator.
- Conversations with filters and counts, message history, hand-offs.
- Send text, free vault media and paid messages with a required
Idempotency-Key, and follow delivery (queued,sent,failed,unconfirmed,not_sent). - Take over, release, and turn the AI on or off per chat; mark read and unread; resolve hand-offs.
- Fans with segments (whales, lapsing, win-back and more), purchase history, notes, custom names and fan lists.
- Vault media lists and thumbnails.
- Today, revenue (by type, day and seller), audience, the cached overview report, and each creator’s transaction ledger.
- AI persona: read and update every field, with readiness.
- AI content: folders, ladders, levels with floor prices, preview and paid media, ordering.
- AI settings: follow-ups, review mode, and the OnlyFans welcome message with dry runs.
- Clicks, subscribers, earnings, cost and ROI per link; record cost and source; create tracking and trial links.
- 60 tools and 6 prompts at
https://mcp.onlyx.ai/mcp, with one-click setup for Claude, Cursor and VS Code, and guides for ChatGPT, Claude Code, Windsurf, Gemini CLI and Codex.
- Consistent error envelope and codes, rate limits with
X-RateLimit-*headers, cursor pagination, idempotent writes, and a public OpenAPI schema athttps://api.onlyx.ai/v1/openapi.json.