OnlyFans API
and MCP server for agencies

curl -X POST "https://api.onlyx.ai/v1/conversations/cnv_3d9e7b1a5c2f4e8d6a0b/messages" \
  -H "Authorization: Bearer $ONLYX_API_KEY" \
  -H "Idempotency-Key: 5f1c2a9e-7b1d-4c0e-9a4f-2d8e6b3c1a70" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Made this one just for you",
    "previewMediaIds": ["4012345678"],
    "mediaIds": ["4012345679"],
    "priceCents": 1500
  }'

Answers 202 Accepted. Send the same Idempotency-Key again and you get the first answer back, not a second message.

import os, uuid
import requests

r = requests.post(
    "https://api.onlyx.ai/v1/conversations/cnv_3d9e7b1a5c2f4e8d6a0b/messages",
    headers={
        "Authorization": f"Bearer {os.environ['ONLYX_API_KEY']}",
        "Idempotency-Key": str(uuid.uuid4()),  # keep it for retries
    },
    json={
        "text": "Made this one just for you",
        "previewMediaIds": ["4012345678"],
        "mediaIds": ["4012345679"],
        "priceCents": 1500,
    },
)
print(r.status_code)  # 202

Reuse the same key when you retry, so a timeout never becomes a double send.

# Fans waiting on a reply, biggest spenders first
curl "https://api.onlyx.ai/v1/conversations?unread=true&sort=spend&limit=20" \
  -H "Authorization: Bearer $ONLYX_API_KEY"

import os
import requests

API = "https://api.onlyx.ai/v1"
headers = {"Authorization": f"Bearer {os.environ['ONLYX_API_KEY']}"}

# Fans waiting on a reply, biggest spenders first
page = requests.get(
    f"{API}/conversations",
    params={"unread": "true", "sort": "spend", "limit": 20},
    headers=headers,
).json()

for c in page["data"]:
    print(c["fan"]["displayName"], c["unreadCount"])

const API = 'https://api.onlyx.ai/v1'

// Fans waiting on a reply, biggest spenders first
const res = await fetch(`${API}/conversations?unread=true&sort=spend&limit=20`, {
  headers: { Authorization: `Bearer ${process.env.ONLYX_API_KEY}` }
})
const { data, hasMore, nextCursor } = await res.json()

for (const c of data) {
  console.log(c.fan.displayName, c.unreadCount)
}