MCP server
You can also use ChatGPT directly inside the dashboard: open Ask Capve, connect your ChatGPT account, and follow the callback instructions. The assistant uses your selected account and asks you to confirm every change. This is separate from connecting an external MCP client below.
Capve is a remote Model Context Protocol server. Connect an AI assistant and it can do everything the dashboard does: create campaigns, set up paths and rotations, add offers and landers, read reports and pause losers.
https://capve.app/mcp
Connect with OAuth
Add the server URL above to your MCP client and select OAuth. Capve supports OAuth authorization code flow with PKCE (S256), automatic discovery and dynamic client registration. Sign in with your existing Capve account and review the app before allowing access.
OAuth grants access to your personal account for up to 30 days. Team accounts and platform administration are excluded. Disconnect apps from API & MCP; signing out everywhere or resetting your password also revokes their access.
API tokens (manual setup)
In the dashboard open AI / MCP and create a token. It starts with capve_ and is shown once. The token acts as you, with your team role: viewers can read, owners and admins can change things. Revoke it any time from the same page.
Connect with an API token
Claude Code
claude mcp add --transport http capve \ https://capve.app/mcp \ --header "Authorization: Bearer capve_YOUR_TOKEN"
Cursor, Windsurf, VS Code and other HTTP clients
Add to mcp.json (Cursor: ~/.cursor/mcp.json):
{
"mcpServers": {
"capve": {
"url": "https://capve.app/mcp",
"headers": {
"Authorization": "Bearer capve_YOUR_TOKEN"
}
}
}
}OpenAI API
In the Responses API, add an MCP tool with server_url set to the URL above and authorization set to your Capve token. Use allowed_tools to select the tools your assistant needs. For interactive MCP clients, choose the OAuth connection flow described above. See the OpenAI MCP guide.
Clients that only support stdio
Use mcp-remote as a bridge, for example in the Claude Desktop config file:
{
"mcpServers": {
"capve": {
"command": "bunx",
"args": [
"mcp-remote",
"https://capve.app/mcp",
"--header",
"Authorization: Bearer capve_YOUR_TOKEN"
]
}
}
}Ask
- Which campaigns lost money last week, and on which countries?
- Create a campaign for my new offer, split 50/50 between my two landers.
- Pause every campaign with ROI below -30% over the last 7 days.
- Group yesterday's conversions by sub1 and tell me which placements to cut.
Tools
Each tool calls the same API as the dashboard, with the same validation and permissions. Money is in cents. Report dates accept ISO dates or Unix milliseconds; date-only ranges use the account timezone. Use whoami to confirm the connected account before making changes.
| Area | Tools |
|---|---|
| Billing | get_billing_status |
| Platform admin (admin accounts only) | get_stripe_setup_status |
| Campaigns | list_campaigns, get_campaign, create_campaign, update_campaign, delete_campaign, bulk_update_campaigns, clone_campaign, get_campaign_tracking, get_campaign_stats, list_clicks, list_conversions |
| Affiliates | list_affiliates, create_affiliate |
| Routing | get_rotation, set_rotation, create_path, update_path, delete_path, list_rules, create_rule, update_rule, delete_rule |
| Anti-fraud | get_traffic_filter, set_traffic_filter, list_blocklist, add_to_blocklist, remove_from_blocklist |
| Entities | list_groups, create_group, delete_group, list_traffic_sources, create_traffic_source, update_traffic_source, delete_traffic_source, list_networks, create_network, update_network, delete_network, list_landers, create_lander, update_lander, delete_lander, list_offers, create_offer, update_offer, delete_offer |
| Postbacks | list_postbacks, create_postback, update_postback, delete_postback, get_postback_key, set_postback_key_required, rotate_postback_key, list_postback_deliveries |
| Sources & cost | list_source_templates, create_traffic_source_from_template, create_network_from_template, get_traffic_source_settings, update_traffic_source_settings, sync_traffic_source_cost, get_campaign_source_link, list_cost_updates, update_campaign_cost |
| Platform management (beta) | list_platform_integrations, get_platform_connection, configure_platform_connection, read_platform_data, execute_platform_action, list_platform_operations |
| AI bidding (beta) | get_bidding_settings, set_bidding_settings, analyze_bidding, get_bid_recommendations |
| Reports | report_campaigns, report_grouped, report_drilldown, report_trends |
| Automation | list_triggers, create_trigger, delete_trigger, list_notes, add_note |
| Zone rules & alerts | list_automation_rules, create_automation_rule, set_automation_rule_enabled, run_automation_rule, delete_automation_rule, list_zone_blacklist, add_zones_to_blacklist, remove_blacklisted_zone |
| Settings & domains | get_settings, update_settings, list_tracking_domains, add_tracking_domain, delete_tracking_domain, set_campaign_tracking_domain |
| Team | whoami, list_team, invite_team_member, remove_team_member, list_activity |
Protocol
Streamable HTTP transport, JSON responses, stateless. Send Authorization: Bearer <access_token> on every request. Requests without a valid token get 401 with OAuth discovery in the WWW-Authenticate header. The same token works on the REST API (/api/*), except for managing tokens.
curl https://capve.app/mcp \
-H "Authorization: Bearer capve_YOUR_TOKEN" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'