Documentation

DevX Viral API and MCP

A key created in the dashboard gives your AI, or your system, the same access you have, within its role and plan.

What you can do

1. Create a key

In the dashboard, under Settings → API keys, give it a name and pick a role. The key is shown only once: copy and store it. It starts with dvx_.

2. Connect via MCP

The server is at https://api.devxviral.com/mcp, over HTTP transport. In Claude Code:

claude mcp add --transport http devxviral https://api.devxviral.com/mcp \
  --header "Authorization: Bearer dvx_YOUR_KEY"

In Cursor (or any client that accepts a server by URL):

{
  "mcpServers": {
    "devxviral": {
      "url": "https://api.devxviral.com/mcp",
      "headers": { "Authorization": "Bearer dvx_YOUR_KEY" }
    }
  }
}

The dashboard shows these commands ready, with your key, for Claude Desktop too.

3. Or call the API directly

Routes live at https://api.devxviral.com/api/… and accept the same key in the header. The key acts as its creator, in their workspace, with the chosen role.

curl https://api.devxviral.com/api/accounts \
  -H "Authorization: Bearer dvx_YOUR_KEY"

Billing and referrals are read-only with a key; keys and administration don't accept any key.

Limits per plan

PlanCalls per minuteKeysAccess
Essential603Read
Pro1205Read and write
Agency30040Read and write

Some processing-heavy tools (view frame, export, transcribe, search references, upload and import) also have a daily cap per workspace.

Key roles

  • admin Everything: view, post, videos, accounts, members and settings.
  • editor View, post, and work on videos and accounts. No settings or billing.
  • analista Read only.

A key never has a role above its creator's.

Errors

  • 401 unauthorized The Authorization header is missing, or the key was revoked.
  • 402 feature_not_in_plan The plan doesn't include the API, or the action writes and the plan is read-only.
  • 403 forbidden The key's role can't perform this action.
  • 429 rate_limited Too many calls per minute. Wait the time in the Retry-After header.

The MCP tools

The main ones. Those marked E write and need Pro or Agency; those marked E! delete or cancel and need confirmar: true.

Account and dashboard

  • quem_sou_eu Who the key belongs to, which workspace and which plan.
  • listar_contas Connected pages, with search and network filter.
  • ver_saude_das_contas Each page's health, delivery and alerts.
  • ver_painel Dashboard numbers by period, network or page.
  • melhores_horarios The times your pages perform best.
  • listar_reels Published reels, sorted by virality.
  • ver_ranking The weekly, monthly or all-time ranking.
  • buscar_referencias Reference reels by niche or profile.

Library and upload

  • listar_biblioteca Videos, images and audio, with folders and search.
  • enviar_arquivoE Uploads a file from your computer.
  • importar_por_urlE Brings in a video from a direct link, YouTube or Google Drive.
  • buscar_imagens Searches free images to use in the video.
  • criar_pastaE Creates a folder in the library.
  • mover_para_pastaE Organizes videos into folders.
  • gerar_variacoesE Generates different versions of a video.
  • importar_reelE Brings a published reel into the library.

Post and schedule

  • agendar_publicacaoE One video on one page, at one time.
  • agendar_loteE Many videos on many pages, with spacing and per-account variation.
  • agendar_storiesE Story sequences on your pages.
  • agendar_fotoE A photo or carousel in the feed.
  • ver_agenda What's scheduled, posted or failed.
  • repetir_publicacaoE Retries what failed.
  • cancelar_publicacaoE! Cancels posts or a whole batch.
  • criar_rotina_de_storiesE Daily Stories, on their own, from a folder.

Clips and captions

  • gerar_cortesE Turns a long video into clips ready in the editor.
  • status_dos_cortes Tracks clip generation.
  • transcreverE Transcribes a project's speech.
  • gerar_legendasE Captions with style, position and highlights.

Editor

  • criar_projetoE Opens a project with the chosen videos.
  • descrever_projeto What's in the project: clips, text, sounds.
  • ver_quadro A frame of the video at a given second, for the AI to check.
  • remover_pausasE Cuts the silences out of speech.
  • dividir_clipe / aparar_clipeE Splits and trims clips.
  • adicionar_clipeE Puts a video on the timeline, including as b-roll.
  • adicionar_textoE A title, caption or highlight, with style and timing.
  • adicionar_audioE Music or a sound effect.
  • definir_transicaoE A transition between clips.
  • aplicar_efeitos_de_videoE Filter, color and motion.
  • animarE Keyframe animation on text and clips.
  • aplicar_formatoE Applies a saved format (frame, fixed text).
  • seguir_rostoE A camera that follows the face.
  • separar_vozE Separates the voice from the music.
  • desfazerE Undoes the AI's last action.
  • exportarE Renders the final video into the library.