Bud Financial Limited Drive MCP API

Connection URLs for Drive's remote Model Context Protocol servers, for use with AI/LLM driven agents — the general Drive copilot, and dedicated servers for segments and campaigns. They authenticate the same way as the rest of the Drive API. **Connecting a client**: these endpoints are the MCP servers themselves, not a URL-minting step — point your MCP client directly at the endpoint's URL, configuring it to send an OAuth2 access token (see Authentication) as a bearer token and `X-Client-Id` as a static header on every request, the same as any other Drive API call.

Operations 3

POST /drive-mcp/v1/campaigns Campaigns MCP Server #
POST /drive-mcp/v1/copilot Copilot MCP Server #
POST /drive-mcp/v1/segments Segments MCP Server #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/thisisbud:thisisbud-drive-mcp-api-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

thisisbud-drive-mcp-api-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Drive MCP API
  version: 1.0.0
  contact:
    name: API Support
    url: http://www.thisisbud.com/support
    email: contact@thisisbud.com
  x-logo:
    url: data:image/png;base64,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
  description: 'Drive lets you understand your customers using the flags it compiles from data across every

    source you bring in — not just transactions — build segments from those flags, and run

    personalized campaigns against them. Drive works in a loop: **understand** your customers (via

    the flags that make up Drive''s criteria), **segment** them (Drive Segments API), and **engage**

    them (Drive Campaigns API). Measuring a campaign''s performance feeds back into segmentation, so

    the next audience is sharper than the last.


    Campaigns don''t have to be built step by step, either: describe the outcome you want in plain

    language and Drive''s campaign agent finds the matching audience, writes the copy, generates the

    artwork, and estimates the opportunity for you.


    Segments V2 endpoints return non-standard vendor content types

    (`application/vnd.bud.drive.notification+json`, `.criteria+json`, `.visualisation+json`,

    `.criteria-options+json`) rather than plain `application/json` — check the `Content-Type` of

    these responses rather than assuming JSON.'
servers:
- url: https://api-sandbox.thisisbud.com
  description: Bud sandbox
tags:
- name: Drive MCP API
  x-displayName: Drive MCP API
  description: 'Connection URLs for Drive''s remote Model Context Protocol servers, for use with AI/LLM driven agents — the general Drive copilot, and dedicated servers for segments and campaigns. They authenticate the same way as the rest of the Drive API.


    **Connecting a client**: these endpoints are the MCP servers themselves, not a URL-minting step — point your MCP client directly at the endpoint''s URL, configuring it to send an OAuth2 access token (see Authentication) as a bearer token and `X-Client-Id` as a static header on every request, the same as any other Drive API call.'
paths:
  /drive-mcp/v1/campaigns:
    post:
      tags:
      - Drive MCP API
      summary: Campaigns MCP Server
      operationId: v1_drive_mcp_campaigns_post
      description: 'The connection URL for Drive''s Campaigns Model Context Protocol server.


        **Connecting a client**: this endpoint is the MCP server itself, not a URL-minting step — point your MCP client directly at it, configuring it to send an OAuth2 access token (see Authentication) as a bearer token and `X-Client-Id` as a static header on every request, the same as any other Drive API call. Many MCP clients accept a config file for this, for example:


        ```json

        {

        "mcpServers": {

        "drive-campaigns": {

        "url": "https://api-sandbox.thisisbud.com/drive-mcp/v1/campaigns",

        "headers": {

        "Authorization": "Bearer ",

        "X-Client-Id": ""

        }

        }

        }

        }

        ```'
      security:
      - OAuth2: []
      parameters:
      - $ref: '#/paths/~1drive-api~1v1~1tags/get/parameters/0'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/paths/~1drive-mcp~1v1~1copilot/post/requestBody/content/application~1json/schema'
      responses:
        '200':
          description: A JSON-RPC response from the MCP server.
          content:
            application/json:
              schema:
                $ref: '#/paths/~1drive-mcp~1v1~1copilot/post/responses/200/content/application~1json/schema'
        '401':
          description: An unauthenticated request was received.
        5XX:
          $ref: '#/components/responses/ServerError'
  /drive-mcp/v1/copilot:
    post:
      tags:
      - Drive MCP API
      summary: Copilot MCP Server
      operationId: v1_drive_mcp_copilot_post
      description: 'The connection URL for Drive''s general copilot Model Context Protocol server.


        **Connecting a client**: this endpoint is the MCP server itself, not a URL-minting step — point your MCP client directly at it, configuring it to send an OAuth2 access token (see Authentication) as a bearer token and `X-Client-Id` as a static header on every request, the same as any other Drive API call. Many MCP clients accept a config file for this, for example:


        ```json

        {

        "mcpServers": {

        "drive-copilot": {

        "url": "https://api-sandbox.thisisbud.com/drive-mcp/v1/copilot",

        "headers": {

        "Authorization": "Bearer ",

        "X-Client-Id": ""

        }

        }

        }

        }

        ```'
      security:
      - OAuth2: []
      parameters:
      - $ref: '#/paths/~1drive-api~1v1~1tags/get/parameters/0'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              title: MCP JSON-RPC Request
              description: A [JSON-RPC 2.0](https://www.jsonrpc.org/specification) request, per the Model Context Protocol specification.
              type: object
              required:
              - jsonrpc
              - method
              properties:
                jsonrpc:
                  type: string
                  enum:
                  - '2.0'
                id:
                  oneOf:
                  - type: string
                  - type: integer
                method:
                  type: string
                params:
                  type: object
              example:
                jsonrpc: '2.0'
                id: 1
                method: tools/list
      responses:
        '200':
          description: A JSON-RPC response from the MCP server.
          content:
            application/json:
              schema:
                title: MCP JSON-RPC Response
                description: A [JSON-RPC 2.0](https://www.jsonrpc.org/specification) response, per the Model Context Protocol specification.
                type: object
                required:
                - jsonrpc
                - id
                properties:
                  jsonrpc:
                    type: string
                    enum:
                    - '2.0'
                  id:
                    oneOf:
                    - type: string
                    - type: integer
                  result:
                    type: object
                  error:
                    type: object
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
        '401':
          description: An unauthenticated request was received.
        5XX:
          $ref: '#/components/responses/ServerError'
  /drive-mcp/v1/segments:
    post:
      tags:
      - Drive MCP API
      summary: Segments MCP Server
      operationId: v1_drive_mcp_segments_post
      description: 'The connection URL for Drive''s Segments Model Context Protocol server.


        **Connecting a client**: this endpoint is the MCP server itself, not a URL-minting step — point your MCP client directly at it, configuring it to send an OAuth2 access token (see Authentication) as a bearer token and `X-Client-Id` as a static header on every request, the same as any other Drive API call. Many MCP clients accept a config file for this, for example:


        ```json

        {

        "mcpServers": {

        "drive-segments": {

        "url": "https://api-sandbox.thisisbud.com/drive-mcp/v1/segments",

        "headers": {

        "Authorization": "Bearer ",

        "X-Client-Id": ""

        }

        }

        }

        }

        ```'
      security:
      - OAuth2: []
      parameters:
      - $ref: '#/paths/~1drive-api~1v1~1tags/get/parameters/0'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/paths/~1drive-mcp~1v1~1copilot/post/requestBody/content/application~1json/schema'
      responses:
        '200':
          description: A JSON-RPC response from the MCP server.
          content:
            application/json:
              schema:
                $ref: '#/paths/~1drive-mcp~1v1~1copilot/post/responses/200/content/application~1json/schema'
        '401':
          description: An unauthenticated request was received.
        5XX:
          $ref: '#/components/responses/ServerError'
components:
  responses:
    ServerError:
      description: An unexpected error occurred on the server side.
      content:
        application/json:
          schema:
            title: Server Error Response
            type: object
            required:
            - operation_id
            - code_id
            - message
            properties:
              operation_id:
                $ref: '#/paths/~1drive-api~1v1~1tags/get/responses/200/content/application~1json/schema/properties/operation_id'
              code_id:
                type: string
                description: A descriptive enough string that is linked to the reason for the error.
              message:
                type: string
                description: An actual user friendly error message.
              errors:
                anyOf:
                - title: Error Object
                  type:
                  - object
                  - 'null'
                  description: Contains a field specific error message
                  additionalProperties:
                    type: string
                - title: Array of Error Object
                  description: Contains a list of error messages
                  type: object
                  additionalProperties:
                    type: array
                    items:
                      type: string
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: /v1/oauth/token
          scopes: {}
      description: "\nAuthentication flow:\n\n1. Perform OAuth2 Client Credentials authentication using API Credentials (`client_id`,`client_secret`) to obtain an `access_token` against `/v1/oauth/token` endpoint,\n2. Use `access_token` as Bearer Authorisation for every other API request,\n3. Include `X-Client-Id` (=client_id) within the header of every API request,\n4. Note that some of the requests may also require `X-Customer-Id` to be provided within the request header.\n\n### Examples\nObtain OAuth2 `access_token` and `refresh_token` using `grant_type=client_credentials` and HTTP Basic auth header\n\n```\ncurl --basic --user {{client_id}}:{{client_secret}} \\\n  -X POST https://api-sandbox.thisisbud.com/v1/oauth/token \\\n  -H 'Content-Type: application/x-www-form-urlencoded' \\\n  -d grant_type=client_credentials\n```\n\nSuccessful response:\n```\n{\n  \"operation_id\": \"oauth_token_post\",\n  \"data\": {\n    \"access_token\": \"dd0c17e3fd6d2ce94aa091257a3ea393b4f9b5cf3d3e998f07dc9826da86ff15\",\n    \"token_type\": \"bearer\",\n    \"expires_in\": 3600,\n    \"refresh_token\": \"fac32cca7559d9f6e8f1dfe9a99c71fa1dcfeb482bedf287d7934d2667ae54b3\"\n  }\n}\n```\n\nRefresh `access_token` token using `refresh_token` against `/v1/oauth/token` endpoint with `grant_type=refresh_token`\n\n```\ncurl -X POST \\\n  https://api-sandbox.thisisbud.com/v1/oauth/token \\\n  -H 'Content-Type: application/x-www-form-urlencoded' \\\n  -H 'X-Client-Id: {{client_id}}' \\\n  -d 'grant_type=refresh_token&refresh_token={{refresh_token}}'\n```\n\nSuccessful response:\n```\n{\n    \"operation_id\": \"oauth_token_post\",\n    \"data\": {\n        \"access_token\": \"cc0c17e3fd6d2ce94aa091257a3ea393b4f9b5cf3d3e998f07dc9826da86ff94\",\n        \"token_type\": \"bearer\",\n        \"expires_in\": 3600,\n        \"refresh_token\": \"ffc30cca7559d9f6e8f1dfe9a99c71fa1dcfeb482bedf287d7934d2667ae54b3\"\n    }\n}\n```\n"
x-provenance:
  method: searched
  source: https://docs-us.thisisbud.com/reference
  harvested: '2026-10-21'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs-us.thisisbud.com/reference/drive_campaign_insights_performance_trends_get.md
  - https://docs-us.thisisbud.com/reference/drive_v1_campaign_content_get.md
  - https://docs-us.thisisbud.com/reference/drive_v1_campaign_content_put.md
  - https://docs-us.thisisbud.com/reference/drive_v1_campaign_delete.md
  - https://docs-us.thisisbud.com/reference/drive_v1_campaign_get.md
  - https://docs-us.thisisbud.com/reference/drive_v1_campaign_status_put.md
  - https://docs-us.thisisbud.com/reference/drive_v1_campaigns_agent_get.md
  - https://docs-us.thisisbud.com/reference/drive_v1_campaigns_agent_post.md
  - https://docs-us.thisisbud.com/reference/drive_v1_campaigns_banner_widgets_get.md
  - https://docs-us.thisisbud.com/reference/drive_v1_campaigns_content_variables_get.md
  - https://docs-us.thisisbud.com/reference/drive_v1_campaigns_get.md
  - https://docs-us.thisisbud.com/reference/drive_v1_campaigns_post.md
  - https://docs-us.thisisbud.com/reference/v1_client_campaign_templates_delete.md
  - https://docs-us.thisisbud.com/reference/v1_compare_segments_get.md
  - https://docs-us.thisisbud.com/reference/v1_compiled_templates_get.md
  - https://docs-us.thisisbud.com/reference/v1_drive_mcp_campaigns_post.md
  - https://docs-us.thisisbud.com/reference/v1_drive_mcp_copilot_post.md
  - https://docs-us.thisisbud.com/reference/v1_drive_mcp_segments_post.md
  - https://docs-us.thisisbud.com/reference/v1_segment_delete.md
  - https://docs-us.thisisbud.com/reference/v1_segment_from_existing_criteria_post.md
  - https://docs-us.thisisbud.com/reference/v1_segment_from_existing_fixed_customers_post.md
  - https://docs-us.thisisbud.com/reference/v1_segment_get.md
  - https://docs-us.thisisbud.com/reference/v1_segment_patch.md
  - https://docs-us.thisisbud.com/reference/v1_segment_query_post.md
  - https://docs-us.thisisbud.com/reference/v1_segment_statistics_overview_get.md
  - https://docs-us.thisisbud.com/reference/v1_segment_tags_get.md
  - https://docs-us.thisisbud.com/reference/v1_segments_upload.md
  - https://docs-us.thisisbud.com/reference/v2_criteria_draft_get.md
  - https://docs-us.thisisbud.com/reference/v2_criteria_draft_put.md
  - https://docs-us.thisisbud.com/reference/v2_criteria_draft_run_post.md
  - https://docs-us.thisisbud.com/reference/v2_criteria_drafts_post.md
  - https://docs-us.thisisbud.com/reference/v2_criteria_options_get.md
  - https://docs-us.thisisbud.com/reference/v2_criteria_run_post.md
  - https://docs-us.thisisbud.com/reference/v2_criteria_suggestions_segment_name_post.md
  - https://docs-us.thisisbud.com/reference/v2_segment_criteria_active_options_get.md
  - https://docs-us.thisisbud.com/reference/v2_segments_criteria_get.md
  - https://docs-us.thisisbud.com/reference/v2_segments_criteria_put.md
  - https://docs-us.thisisbud.com/reference/v2_segments_criteria_run_post.md
  - https://docs-us.thisisbud.com/reference/v2_segments_get.md
  - https://docs-us.thisisbud.com/reference/v2_segments_post.md
  - https://docs.thisisbud.com/reference/drive_campaign_insights_performance_trends_get.md
  - https://docs.thisisbud.com/reference/drive_v1_campaign_content_get.md
  - https://docs.thisisbud.com/reference/drive_v1_campaign_content_put.md
  - https://docs.thisisbud.com/reference/drive_v1_campaign_delete.md
  - https://docs.thisisbud.com/reference/drive_v1_campaign_get.md
  - https://docs.thisisbud.com/reference/drive_v1_campaign_status_put.md
  - https://docs.thisisbud.com/reference/drive_v1_campaigns_agent_get.md
  - https://docs.thisisbud.com/reference/drive_v1_campaigns_agent_post.md
  - https://docs.thisisbud.com/reference/drive_v1_campaigns_banner_widgets_get.md
  - https://docs.thisisbud.com/reference/drive_v1_campaigns_content_variables_get.md
  - https://docs.thisisbud.com/reference/drive_v1_campaigns_get.md
  - https://docs.thisisbud.com/reference/drive_v1_campaigns_post.md
  - https://docs.thisisbud.com/reference/v1_client_campaign_templates_delete.md
  - https://docs.thisisbud.com/reference/v1_compare_segments_get.md
  - https://docs.thisisbud.com/reference/v1_compiled_templates_get.md
  - https://docs.thisisbud.com/reference/v1_drive_mcp_campaigns_post.md
  - https://docs.thisisbud.com/reference/v1_drive_mcp_copilot_post.md
  - https://docs.thisisbud.com/reference/v1_drive_mcp_segments_post.md
  - https://docs.thisisbud.com/reference/v1_segment_delete.md
  - https://docs.thisisbud.com/reference/v1_segment_from_existing_criteria_post.md
  - https://docs.thisisbud.com/reference/v1_segment_from_existing_fixed_customers_post.md
  - https://docs.thisisbud.com/reference/v1_segment_get.md
  - https://docs.thisisbud.com/reference/v1_segment_patch.md
  - https://docs.thisisbud.com/reference/v1_segment_query_post.md
  - https://docs.thisisbud.com/reference/v1_segment_statistics_overview_get.md
  - https://docs.thisisbud.com/reference/v1_segment_tags_get.md
  - https://docs.thisisbud.com/reference/v1_segments_upload.md
  - https://docs.thisisbud.com/reference/v2_criteria_draft_get.md
  - https://docs.thisisbud.com/reference/v2_criteria_draft_put.md
  - https://docs.thisisbud.com/reference/v2_criteria_draft_run_post.md
  - https://docs.thisisbud.com/reference/v2_criteria_drafts_post.md
  - https://docs.thisisbud.com/reference/v2_criteria_options_get.md
  - https://docs.thisisbud.com/reference/v2_criteria_run_post.md
  - https://docs.thisisbud.com/reference/v2_criteria_suggestions_segment_name_post.md
  - https://docs.thisisbud.com/reference/v2_segment_criteria_active_options_get.md
  - https://docs.thisisbud.com/reference/v2_segments_criteria_get.md
  - https://docs.thisisbud.com/reference/v2_segments_criteria_put.md
  - https://docs.thisisbud.com/reference/v2_segments_criteria_run_post.md
  - https://docs.thisisbud.com/reference/v2_segments_get.md
  - https://docs.thisisbud.com/reference/v2_segments_post.md
  merge:
    pages: 80
    deduped: 324
    conflicts_kept_first: 45