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.
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
| Plan | Calls per minute | Keys | Access |
|---|---|---|---|
| Essential | 60 | 3 | Read |
| Pro | 120 | 5 | Read and write |
| Agency | 300 | 40 | Read and write |
Some processing-heavy tools (view frame, export, transcribe, search references, upload and import) also have a daily cap per workspace.
Key roles
adminEverything: view, post, videos, accounts, members and settings.editorView, post, and work on videos and accounts. No settings or billing.analistaRead only.
A key never has a role above its creator's.
Errors
- 401
unauthorizedThe Authorization header is missing, or the key was revoked. - 402
feature_not_in_planThe plan doesn't include the API, or the action writes and the plan is read-only. - 403
forbiddenThe key's role can't perform this action. - 429
rate_limitedToo 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_euWho the key belongs to, which workspace and which plan.listar_contasConnected pages, with search and network filter.ver_saude_das_contasEach page's health, delivery and alerts.ver_painelDashboard numbers by period, network or page.melhores_horariosThe times your pages perform best.listar_reelsPublished reels, sorted by virality.ver_rankingThe weekly, monthly or all-time ranking.buscar_referenciasReference reels by niche or profile.
Library and upload
listar_bibliotecaVideos, 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_imagensSearches 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_agendaWhat'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_cortesTracks 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_projetoWhat's in the project: clips, text, sounds.ver_quadroA 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.