Uber External Ads

You have an MCP server that exposes Uber's External Ads API for managing advertising campaigns. It lets you fetch campaigns, create, update, and delete campaigns for a given ad account, all through a consistent MCP interface.

How to use

Use this MCP server with your MCP client to perform common campaign management tasks. You can retrieve campaigns for an ad account, get details for a single campaign, create new campaigns, update existing ones, and delete campaigns. Each tool requires you to provide authentication and the relevant identifiers for the ad account and campaigns. You can optionally filter campaigns when listing them to limit results or focus on a specific status.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

# Install dependencies
npm install

# Build the project
npm run build

Configuration and usage notes

Configuration and runtime behavior are driven by standard MCP server conventions. The server communicates with Uber’s External Ads API at the base URL https://api.uber.com/v1/ads. All requests require a valid Bearer token for authentication.

Error handling is designed to be explicit. You will receive detailed error messages for authentication failures, invalid parameters, API errors, and network issues. Errors are structured with isError: true and include descriptive messages to help you diagnose problems.

Security considerations include validating all authentication tokens and validating input parameters against defined schemas to ensure clean, well-formed requests and responses.

Tools and endpoints overview

The MCP server exposes tools to manage campaigns. Here are the available endpoints and their responsibilities.

Example usage patterns

To list campaigns for an ad account, supply the authentication token, the ad account identifier, and any desired filters such as status or pagination. To create or modify a campaign, provide the required campaign data including the name, budget, and time window. When deleting, specify the campaign you want to remove.

Notes on development and production runs

During development you can start the server with a development command, and in production use the production start command. Ensure you have built the project before attempting to run it in production.

Available tools

get_campaigns

Retrieve campaigns for an ad account with optional filters such as status, limit, and offset.

get_campaign

Get details for a specific campaign by its ID within an ad account.

create_campaign

Create a new campaign with required fields like name and budget, and optional fields such as start_time, end_time, and objective.

update_campaign

Update an existing campaign with changes to name, status, budget, or end_time.

delete_campaign

Delete a campaign by its ID within an ad account.