Documentation

Connect an AI assistant with MCP

Updated 17 Nov 2026

An admin creates a token in the Velotrak admin. The client sends Authorization: Bearer vtmcp_… to POST /mcp on the tracker origin. Edits and deletes return a diff and wait for the same call with diff_token. Free tokens are read-only.

Create a token

Only an admin can create MCP tokens (GET, POST, and DELETE /api/mcp-tokens). The plaintext token is shown once. It starts with vtmcp_. The server stores a SHA-256 hash, the scope JSON, the creator, and an expiry. If you omit days, expiry is 90 days. The maximum is 365. If you omit scopes, the token is {"reports":{"read":true}}.

The creator must stay an active admin. Disabling that user, or changing their role, makes the token fail authentication. The row can remain in the database. Free and Pro allow one unexpired token (counted for active admin creators). Team stores an unlimited cap. The pricing page describes Team as one token per teammate; the entitlement the app enforces is unlimited. See plans.

Point the client at POST https://<your host>/mcp. The path is the site root, not under /admin/. The header is Authorization: Bearer <token>. The protocol version the server announces is 2025-03-26.

Scopes and confirmation

Scopes are { "<domain>": { "read": true, "write": true } }. The admin groups domains as campaigns, offers, landers, flows, sources, networks, domains, reports, and logs; alerts, backups, migration, system, and admin; and the sensitive domains integrations, license, and lander files. A scope of * does not cover the sensitive domains, and it never grants tools marked explicit-only (branding changes, restore, and clearing demo data are in that set). A token without write on a domain sees redacted credentials.

Write tools require Pro or above (mcp_write). On Free they are rejected, except activate_license. A destructive call does not run on the first request. The response includes requires_confirmation, a diff_token, and expires_in_seconds of 600. Send the same tool and the same arguments again with that diff_token.

The tool list

The table below is generated at build time from Registry() in the tracker source. The pricing page and the homepage still say 90 tools. This table is the list the registry and the CI check keep in sync with the tools the server actually registers. One admin route has no tool: PATCH /api/integrations/{id} updates an integration, and the registry only has create, delete, list, and sync_costs.

MCP tools

94 tools, read from the product registry in this repository.
FeatureRESTTool
Click logGET /api/logs/clicksget_click_log
Conversion logGET /api/logs/conversionsget_conversion_log
Postback logGET /api/logs/postbacksget_postback_log
Outbound logGET /api/logs/outboundget_outbound_log
Report queryPOST /api/reports/queryreport_query
Dashboard summaryGET /api/dashboarddashboard_summary
Export report csvPOST /api/reports/exportexport_report_csv
List report viewsGET /api/reports/viewslist_report_views
Save report viewPOST /api/reports/viewssave_report_view
Delete report viewDELETE /api/reports/views/{id}delete_report_view
Clone campaignPOST /api/campaigns/{id}/cloneclone_campaign
Clone offerPOST /api/offers/{id}/cloneclone_offer
Clone flowPOST /api/flows/{id}/cloneclone_flow
Campaigns: listGET /api/campaignslist_campaigns
get_campaignGET /api/campaigns/{id}get_campaign
create_campaignPOST /api/campaignscreate_campaign
update_campaignPATCH /api/campaigns/{id}update_campaign
delete_campaignDELETE /api/campaigns/{id}delete_campaign
Offers: listGET /api/offerslist_offers
get_offerGET /api/offers/{id}get_offer
create_offerPOST /api/offerscreate_offer
update_offerPATCH /api/offers/{id}update_offer
delete_offerDELETE /api/offers/{id}delete_offer
Landers: listGET /api/landerslist_landers
get_landerGET /api/landers/{id}get_lander
create_landerPOST /api/landerscreate_lander
update_landerPATCH /api/landers/{id}update_lander
delete_landerDELETE /api/landers/{id}delete_lander
Sources: listGET /api/traffic-sourceslist_traffic_sources
get_traffic_sourceGET /api/traffic-sources/{id}get_traffic_source
create_traffic_sourcePOST /api/traffic-sourcescreate_traffic_source
update_traffic_sourcePATCH /api/traffic-sources/{id}update_traffic_source
delete_traffic_sourceDELETE /api/traffic-sources/{id}delete_traffic_source
Networks: listGET /api/networkslist_networks
get_networkGET /api/networks/{id}get_network
create_networkPOST /api/networkscreate_network
update_networkPATCH /api/networks/{id}update_network
delete_networkDELETE /api/networks/{id}delete_network
rotate_network_keyPOST /api/networks/{id}/rotate-keyrotate_network_key
Domains: listGET /api/domainslist_domains
get_domainGET /api/domains/{id}get_domain
create_domainPOST /api/domainscreate_domain
update_domainPATCH /api/domains/{id}update_domain
delete_domainDELETE /api/domains/{id}delete_domain
Flows: listGET /api/flowslist_flows
get_flowGET /api/flows/{id}get_flow
create_flowPOST /api/flowscreate_flow
update_flowPATCH /api/flows/{id}update_flow
delete_flowDELETE /api/flows/{id}delete_flow
Get flow docGET /api/flows/{id}/docget_flow_doc
Set flow docPUT /api/flows/{id}/docset_flow_doc
Simulate flowPOST /api/flows/{id}/simulatesimulate_flow
List lander filesGET /api/landers/{id}/fileslist_lander_files
Read lander fileGET /api/landers/{id}/files/{path}read_lander_file
Write lander filePUT /api/landers/{id}/files/{path}write_lander_file
Delete lander fileDELETE /api/landers/{id}/files/{path}delete_lander_file
Lander preview linkPOST /api/landers/{id}/preview-linkget_lander_preview_link
License statusGET /api/licenselicense_status
Activate licensePOST /api/license/activateactivate_license
License heartbeatPOST /api/license/heartbeatlicense_heartbeat
List integrationsGET /api/integrationslist_integrations
Create integrationPOST /api/integrationscreate_integration
Delete integrationDELETE /api/integrations/{id}delete_integration
Sync costsPOST /api/integrations/{id}/syncsync_costs
Enter manual campaign spendPOST /api/campaigns/{id}/costrecord_campaign_cost
List manual campaign spendGET /api/campaigns/{id}/costlist_campaign_cost
Check domainPOST /api/domains/{id}/checkcheck_domain
List alertsGET /api/alertslist_alerts
Create alertPOST /api/alertscreate_alert
Update alertPUT /api/alerts/{id}update_alert
Delete alertDELETE /api/alerts/{id}delete_alert
List alert eventsGET /api/alerts/eventslist_alert_events
List backupsGET /api/backupslist_backups
Create backupPOST /api/backupscreate_backup
Restore backupPOST /api/backups/restorerestore_backup
System healthGET /healthzsystem_health
List usersGET /api/userslist_users
Audit logGET /api/auditaudit_log
Get brandingGET /api/bootstrapget_branding
List bot rulesGET /api/bot-ruleslist_bot_rules
Get custom metricsGET /api/settings/custom-metricsget_custom_metrics
Set custom metricsPUT /api/settings/custom-metricsset_custom_metrics
Get update statusGET /api/system/updateget_update_status
Check for updatePOST /api/system/update/checkcheck_for_update
Download updatePOST /api/system/update/downloaddownload_update
Create bot rulePOST /api/bot-rulescreate_bot_rule
Delete bot ruleDELETE /api/bot-rules/{id}delete_bot_rule
Set brandingPUT /api/settings/brandingset_branding
Migration: export configGET /api/exportexport_config
Migration: import configPOST /api/importimport_config
Migration: list templatesGET /api/templateslist_templates
Migration: apply templatePOST /api/templates/applyapply_template
Migration: generate demoPOST /api/demo/generategenerate_demo
Migration: clear demoPOST /api/demo/clearclear_demo