Uber External Ads API MCP Server

An MCP (Model Context Protocol) server that provides access to Uber's External Ads API for campaign management.

Features

• Get Campaigns: Retrieve campaigns for an ad account with optional filtering

• Get Campaign: Get details for a specific campaign

• Create Campaign: Create new advertising campaigns

• Update Campaign: Modify existing campaigns

• Delete Campaign: Remove campaigns

Installation

Usage

Development

Production

Available Tools

get_campaigns

Retrieve campaigns for an ad account.

Parameters:

• auth_token (required): Bearer token for authentication

• ad_account_id (required): The ad account UUID

• filters (optional): Object with filtering options

  • status: Filter by campaign status (ACTIVE, PAUSED, DELETED)

  • limit: Number of campaigns to return (1-100, default: 20)

  • offset: Number of campaigns to skip (default: 0)

get_campaign

Get details for a specific campaign.

Parameters:

• auth_token (required): Bearer token for authentication

• ad_account_id (required): The ad account UUID

• campaign_id (required): The campaign UUID

create_campaign

Create a new campaign.

Parameters:

• auth_token (required): Bearer token for authentication

• ad_account_id (required): The ad account UUID

• campaign_data (required): Campaign configuration object

  • name (required): Campaign name

  • budget_amount (required): Budget amount in USD

  • status: Campaign status (ACTIVE, PAUSED) - default: ACTIVE

  • budget_type: Budget type (DAILY, LIFETIME) - default: DAILY

  • start_time: Campaign start time (ISO 8601)

  • end_time: Campaign end time (ISO 8601)

  • objective: Campaign objective (AWARENESS, CONSIDERATION, CONVERSION) - default: CONVERSION

update_campaign

Update an existing campaign.

Parameters:

• auth_token (required): Bearer token for authentication

• ad_account_id (required): The ad account UUID

• campaign_id (required): The campaign UUID

• campaign_data (required): Updates to apply

  • name: Campaign name

  • status: Campaign status (ACTIVE, PAUSED)

  • budget_amount: Budget amount in USD

  • end_time: Campaign end time (ISO 8601)

delete_campaign

Delete a campaign.

Parameters:

• auth_token (required): Bearer token for authentication

• ad_account_id (required): The ad account UUID

• campaign_id (required): The campaign UUID

Example Usage

Using the provided curl request as an example:

Configuration

The server uses the Uber External Ads API base URL: https://api.uber.com/v1/ads

All requests require a valid Bearer token for authentication.

Error Handling

The server provides detailed error messages for:

• Authentication failures

• Invalid parameters

• API errors

• Network issues

Errors are returned with isError: true and descriptive messages.

Security

• All authentication tokens are validated

• Input parameters are validated using Zod schemas

• API responses are properly formatted and sanitized