Skip to content

MCP server

Use ROI.me from AI clients that support the Model Context Protocol. Ask about performance, build audiences and draft campaigns in conversation, under the same rules as everything else.

In development

The ROI.me API is in development. Resource names and shapes below reflect the v1 design and may change before general availability.

How it works

The ROI.me MCP server is a thin layer over the same services as the REST API. It authenticates with a scoped API key, and every tool call is checked against that key's scopes and your organization's permissions.

Tools are grouped by what they can change. Read tools only look. Write tools create drafts and assets. Spend-affecting tools request launches and budget changes, and those requests go through your approval policy exactly as they would in the portal: an AI client can't approve its own request.

We'll list specific AI clients as supported once we've tested them against the released server.

Tools

Read

16 tools
  • roi_list_brandsList brands in the organization
  • roi_get_brandGet a brand's Brand Brain
  • roi_list_productsList a brand's products
  • roi_list_visitorsList visitors with filters
  • roi_get_visitorGet a visitor and timeline
  • roi_get_high_intent_visitorsVisitors above an intent threshold
  • roi_list_audiencesList audiences
  • roi_list_creativeList creative and scores
  • roi_list_campaignsList campaigns
  • roi_get_campaignGet a campaign with channels
  • roi_get_performanceAccount performance for a range
  • roi_get_channel_performancePerformance by channel
  • roi_get_creative_performancePerformance by creative
  • roi_get_audience_performancePerformance by audience
  • roi_analyze_accountRun an ROI Agent analysis
  • roi_get_recommendationsCurrent recommendations

Write

8 tools
  • roi_analyze_brandStart a Brand Brain analysis
  • roi_create_audienceCreate an audience
  • roi_sync_audienceSync an audience to destinations
  • roi_generate_imageGenerate image creative
  • roi_generate_videoGenerate video creative
  • roi_generate_variationsGenerate variations of a creative
  • roi_score_creativeScore a creative
  • roi_create_campaignCreate a draft campaign

Spend-affecting

3 tools
  • roi_launch_campaignRequest a launch; follows your approval policy
  • roi_pause_campaignPause a campaign
  • roi_change_budgetRequest a budget change; follows your approval policy

Client configuration

MCP clients that support remote servers connect over streamable HTTP with your API key as a bearer token.

mcp.json
{
  "mcpServers": {
    "roi": {
      "type": "http",
      "url": "https://mcp.roi.me/mcp",
      "headers": { "Authorization": "Bearer roi_live_…" }
    }
  }
}