Drive Model Context Protocol Servers

We supply Model Context Protocol (MCP) Servers to expose Drive functionality to your Agents.


⚠️

Be extremely careful of which MCP servers you use in conjunction with Drive MCP Servers

These MCP servers expose tools which may return PII and confidential customer and business information. Only use in conjunction with MCP servers from trusted providers and limited ingress/egress routes to avoid data exfiltration due to prompt injection attacks.


There are three servers grouping drive functionality:

  • Copilot /drive-mcp/v1/copilot
  • Segments /drive-mcp/v1/segments
  • Campaigns /drive-mcp/v1/campaigns

You can use them together or individually depending on your usecase.

Tools


Copilot:

ToolDescription
ask_copilotAsks Drive Copilot a question; generates a SQL query and explanation server-side when the question resolves to one, or respond helpfully to questions on how to use copilot.
run_copilot_queryRuns a SQL query against Drive's customer data warehouse and returns a bounded preview of the results.
interpret_copilot_query_resultsSummarises a query's results in plain language.
visualize_copilot_queryProduces chart data for a query's results, when the data is visualisable.

Segments:

ToolDescription
list_segmentsReturns all Drive segments the calling user can access.
get_segmentReturns the details of a single Drive segment (name, source, tags, download fields).
get_segment_criteriaReturns the criteria of a single Drive segment.
get_segment_statisticsRetrieves a segment's current statistics, such as total customers and category spend.
get_segment_download_linksCreates and returns pre-signed CSV download URLs for all customers matched by a segment.
create_segmentCreates a new segment, either empty or seeded from an existing draft criteria.
update_segmentPartially updates a segment's metadata.
delete_segmentPermanently deletes a segment. Destructive, irreversible, idempotent.
run_segmentExecutes the criteria of a saved segment and returns the number of matching customers.
create_criteria_draftCreates a new, empty draft criteria to build up before referencing it as a segment's source.
update_criteria_draftUpdates the definition of a draft criteria; re-runs it as a test of the new definition.
run_criteriaRuns a criteria definition directly, without saving it as a segment first.
get_criteria_optionsReturns the flags, segment dependencies, and custom criteria available to build a new criteria from.

Campaigns:

ToolDescription
list_campaignsReturns a paginated list of campaigns created for this organisation.
get_campaignReturns the full details of a single Drive campaign.
get_campaign_contentReturns a campaign's current live content and, if one exists, its latest unpublished draft.
get_campaign_performance_trendsReturns time-series performance metrics for a campaign (audience size, impressions, clicks, etc).
create_campaignCreates a new campaign in a pending state; must be published to go live. Irreversible.
update_campaign_contentUpdates a campaign's content; not made live until the campaign is (re)published.
update_campaign_statusUpdates a campaign's status (live, paused, ended).
delete_campaignPermanently deletes a campaign, its promotions, segments, and triggers. Destructive, irreversible, idempotent.
create_campaign_agent_runStarts a campaign-agent run from a plain-language business goal, returning immediately with an id to poll. This is a long running process.
get_campaign_agent_runRetrieves a campaign-agent run's progress, and the drafted campaign (audience, copy, template) once it completes.



Did this page help you?