Connect your agent to OnlyChat

Connect your AI agent (Claude, ChatGPT, Cursor, n8n, your own agent…) to OnlyChat and

let it manage your creators: scripts, media, fans, automated messages and analytics.

1. Create an API key

1. In OnlyChat, open Account › API Keys (organization owner only).
2. Click Create API key, give it a name (e.g. "Sales agent — Italy team").
3. Copy the key (oc_live_…). It is shown only once. Store it in a password manager.

You can have up to 5 active keys. Revoke a key at any time: the agent loses access

immediately. A key only gives access to your own organization.

2. Connect your agent

Live documentation: https://mcp.only-chat.ai/docs

Claude Desktop / Claude Code example:

{
  "mcpServers": {
    "onlychat": {
      "type": "http",
      "url": "https://mcp.only-chat.ai/mcp",
      "headers": { "Authorization": "Bearer oc_live_..." }
    }
  }
}

Ask the agent to call get_organization to check the connection.

3. Tools

Every tool that works on a creator takes a creatorId and a platform

(onlyfans or telegram), as returned by list_creators.

Read (no risk)

get_organization, list_transactions, list_creators, get_creator, list_scripts,

get_script, list_script_folders, list_folders, list_vault_lists, list_media, get_media_batch,

get_import_quota, list_importable_scripts, list_importable_folders, get_stats,

get_script_stats, get_creator_settings, list_fans, get_fan_messages, get_fan_note,

list_tags, list_fan_lists, list_schedules, list_welcome_messages

Scripts

create_script, duplicate_script, update_script, set_script_active, set_first_script,

move_script_to_folder, ensure_group (versioning), toggle_wait_before_video, toggle_send_as_video_note,

create_script_folder, update_script_folder, set_script_folder_active

Media and copies between creators (Telegram)

create_folder, update_media, upload_media (from a URL), import_media_folder,

import_script

Media on OnlyFans

list_vault_lists, sync_media (import the OnlyFans vault into OnlyChat),

duplicate_script (copy a script to another creator, with a media mapping)

Persona

update_creator_settings, rename_creator, toggle_creator_ai

Fans — act on real fans

send_message (OnlyFans and Telegram), toggle_fan_ai, bulk_toggle_ai, set_fan_tags, set_fan_note,

sync_messages

Automations

create_schedule, update_schedule, set_schedule_enabled, create_welcome_message,

update_welcome_message, set_welcome_messages_enabled, set_relances_enabled,

import_fan_lists, set_fan_list_status

Playground — only when your server has MCP_ENABLE_PLAYGROUND_TOOLS=true

list_playground_conversations, create_conversation, send_user_message, set_parameters,

get_playground_credits

4. Safety rules

• Scripts created or imported by an agent are always inactive. A human (or an

explicit set_script_active) must turn them on.

• Nothing can be deleted through the MCP server, and payments, licenses, members and

API keys are not reachable.

• send_message, bulk_toggle_ai and the automation switches act on real fans right

away.

• The playground never reaches a real fan, but every AI reply spends one playground

credit. Agents cannot buy credits: only a member with the right permission can, from

the app. Check get_playground_credits before a long test.

5. Limits

When a limit is reached the tool answers rate_limited with the number of seconds to

wait. Only the playground tools consume credits, from a dedicated pack; every other tool

is free.

Not available yet

Webhooks, OAuth sign-in and Telegram bot connection.