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 ServersThese 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:
| Tool | Description |
|---|---|
| ask_copilot | Asks 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_query | Runs a SQL query against Drive's customer data warehouse and returns a bounded preview of the results. |
| interpret_copilot_query_results | Summarises a query's results in plain language. |
| visualize_copilot_query | Produces chart data for a query's results, when the data is visualisable. |
Segments:
| Tool | Description |
|---|---|
| list_segments | Returns all Drive segments the calling user can access. |
| get_segment | Returns the details of a single Drive segment (name, source, tags, download fields). |
| get_segment_criteria | Returns the criteria of a single Drive segment. |
| get_segment_statistics | Retrieves a segment's current statistics, such as total customers and category spend. |
| get_segment_download_links | Creates and returns pre-signed CSV download URLs for all customers matched by a segment. |
| create_segment | Creates a new segment, either empty or seeded from an existing draft criteria. |
| update_segment | Partially updates a segment's metadata. |
| delete_segment | Permanently deletes a segment. Destructive, irreversible, idempotent. |
| run_segment | Executes the criteria of a saved segment and returns the number of matching customers. |
| create_criteria_draft | Creates a new, empty draft criteria to build up before referencing it as a segment's source. |
| update_criteria_draft | Updates the definition of a draft criteria; re-runs it as a test of the new definition. |
| run_criteria | Runs a criteria definition directly, without saving it as a segment first. |
| get_criteria_options | Returns the flags, segment dependencies, and custom criteria available to build a new criteria from. |
Campaigns:
| Tool | Description |
|---|---|
| list_campaigns | Returns a paginated list of campaigns created for this organisation. |
| get_campaign | Returns the full details of a single Drive campaign. |
| get_campaign_content | Returns a campaign's current live content and, if one exists, its latest unpublished draft. |
| get_campaign_performance_trends | Returns time-series performance metrics for a campaign (audience size, impressions, clicks, etc). |
| create_campaign | Creates a new campaign in a pending state; must be published to go live. Irreversible. |
| update_campaign_content | Updates a campaign's content; not made live until the campaign is (re)published. |
| update_campaign_status | Updates a campaign's status (live, paused, ended). |
| delete_campaign | Permanently deletes a campaign, its promotions, segments, and triggers. Destructive, irreversible, idempotent. |
| create_campaign_agent_run | Starts 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_run | Retrieves a campaign-agent run's progress, and the drafted campaign (audience, copy, template) once it completes. |
Updated about 22 hours ago
Did this page help you?

