# Ads Uploader MCP server

Meta ads bulk launcher: upload creatives, edit builds, preview, and create paused ads.

## At a glance

Ads Uploader is an MCP server in the Marketing & Social category. It runs locally over stdio via `npx -y @adsuploader/mcp`, and declares no required credentials. It exposes 23 tools, including ads_whoami, ads_list_accounts and ads_list_campaigns. It scores A (82/100) on the MCP Skills Hub health score as of Oct 28, 2026.

## Install

### How to install Ads Uploader in Claude Code

1. Add the server

```bash
claude mcp add adsuploader -- npx -y @adsuploader/mcp
```

2. Verify it's connected

```bash
claude mcp list
```

3. Sharing it with your team?

   Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

4. Use it in a session

   Ask Claude to use the tools this server exposes (e.g. ads_whoami, ads_list_accounts, ads_list_campaigns). It discovers them automatically.

### How to install Ads Uploader in Claude Desktop

1. Open your MCP config

   macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add this server

```json
{
  "mcpServers": {
    "adsuploader": {
      "command": "npx",
      "args": [
        "-y",
        "@adsuploader/mcp"
      ]
    }
  }
}
```

3. Restart Claude Desktop

   The tools appear under the 🔌 menu once the app reloads.

### How to install Ads Uploader in Cursor

1. Create / edit .cursor/mcp.json in your project

```json
{
  "mcpServers": {
    "adsuploader": {
      "command": "npx",
      "args": [
        "-y",
        "@adsuploader/mcp"
      ]
    }
  }
}
```

2. Enable it

   Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.

### How to install Ads Uploader in Codex CLI

1. Add to ~/.codex/config.toml

```toml
[mcp_servers.adsuploader]
command = "npx"
args = ["-y", "@adsuploader/mcp"]
```

2. Run Codex

   Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.

### How to install Ads Uploader in Windsurf

1. Edit ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "adsuploader": {
      "command": "npx",
      "args": [
        "-y",
        "@adsuploader/mcp"
      ]
    }
  }
}
```

2. Reload

   Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.

### How to install Ads Uploader in Cline

1. Open Cline → MCP Servers → Configure

   Adds to cline_mcp_settings.json.

2. Add the server

```json
{
  "mcpServers": {
    "adsuploader": {
      "command": "npx",
      "args": [
        "-y",
        "@adsuploader/mcp"
      ]
    }
  }
}
```

### How to install Ads Uploader in VS Code

1. Create .vscode/mcp.json

```json
{
  "servers": {
    "adsuploader": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@adsuploader/mcp"
      ]
    }
  }
}
```

2. Start it

   VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.

## Tools

- `ads_whoami` — Show which Ads Uploader user this session is authenticated as
- `ads_list_accounts` — List Meta ad accounts available to you
- `ads_list_campaigns` — List campaigns in an ad account (name/status filters)
- `ads_list_adsets` — List ad sets in a campaign
- `ads_list_ads` — List ads in an ad set
- `ads_get_ad` — Get one ad with its creative details
- `ads_list_pages` — List Facebook Pages and their connected Instagram accounts
- `ads_search_targeting` — Search Meta targeting values for a build
- `ads_list_presets` — Browse saved API and ad-text presets
- `ads_save_preset` — Save an existing ad as a reusable preset
- `ads_list_builds` — Browse saved uploader builds
- `ads_save_build` — Create or edit a durable saved build
- `ads_fork_build` — Fork a saved build into a new draft
- `ads_delete_build` — Delete a saved build
- `ads_upload` — Upload media from URLs, a Google Drive folder, or disk
- `ads_upload_finalize` — Finalize a presigned upload batch
- `ads_list_uploads` — List batches or poll an ingest job
- `ads_create` — Create ads from a full AdSpec or saved build, incl. partnership ads
- `ads_preview` — Resolve a spec, check Meta permissions and partnership sponsors, without creating anything
- `ads_duplicate_by_post` — Duplicate ads by Page post ID, preserving social proof
- `ads_duplicate_by_post_preview` — Preview a post-ID duplication
- `ads_get_job` — Poll or resume a running job
- `ads_cancel_job` — Cancel a creation or ingest job

Source repository: https://github.com/adsuploader/meta-ads-mcp

---

Source: https://mcp-skills-hub.vercel.app/mcps/com-adsuploader-mcp · MCP Skills Hub · data as of 2026-10-28T12:31:05Z