Marketing & SocialMCP Registrynpm23 toolsA · 82

Ads Uploader MCP server

com.adsuploader · Updated today

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.

Source 1

One-click install

VS Code VS Code Insiders Cursor

Opens your editor and pre-fills the config. Your editor will ask before adding it.

How to install Ads Uploader in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install Ads Uploader in Claude CodeAnthropic's agentic CLI

Add the server

bash

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

2
Verify it's connected
bash
```
claude mcp list
```
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).
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 DesktopDesktop app (MCP config)

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

Add this server

json

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

Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.

How to install Ads Uploader in CursorAI-first code editor

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

json

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

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

How to install Ads Uploader in Codex CLIOpenAI coding agent

Add to ~/.codex/config.toml

toml

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

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

How to install Ads Uploader in WindsurfCodeium's agentic IDE

Edit ~/.codeium/windsurf/mcp_config.json

json

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

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

How to install Ads Uploader in ClineVS Code autonomous agent

Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.

Add the server

json

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

How to install Ads Uploader in VS CodeCopilot / MCP support

Create .vscode/mcp.json

json

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

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

What tools does Ads Uploader expose? (23)

Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.

ads_whoamiShow which Ads Uploader user this session is authenticated as
ads_list_accountsList Meta ad accounts available to you
ads_list_campaignsList campaigns in an ad account (name/status filters)
ads_list_adsetsList ad sets in a campaign
ads_list_adsList ads in an ad set
ads_get_adGet one ad with its creative details
ads_list_pagesList Facebook Pages and their connected Instagram accounts
ads_search_targetingSearch Meta targeting values for a build
ads_list_presetsBrowse saved API and ad-text presets
ads_save_presetSave an existing ad as a reusable preset
ads_list_buildsBrowse saved uploader builds
ads_save_buildCreate or edit a durable saved build
ads_fork_buildFork a saved build into a new draft
ads_delete_buildDelete a saved build
ads_uploadUpload media from URLs, a Google Drive folder, or disk
ads_upload_finalizeFinalize a presigned upload batch
ads_list_uploadsList batches or poll an ingest job
ads_createCreate ads from a full AdSpec or saved build, incl. partnership ads
ads_previewResolve a spec, check Meta permissions and partnership sponsors, without creating anything
ads_duplicate_by_postDuplicate ads by Page post ID, preserving social proof
ads_duplicate_by_post_previewPreview a post-ID duplication
ads_get_jobPoll or resume a running job
ads_cancel_jobCancel a creation or ingest job

What the code can do

Read from the published package source — never executed. Parsed 1 of 1 source file.

The code this server ships can read and write files, execute code it builds at runtime and read your environment variables.

This package ships bundled code— its dependencies are compiled into the published files. The capabilities below are really in what runs on your machine, but they may come from a bundled library rather than the author's own source.

How it was published

Published by a verified CI identity (github trusted publishing) rather than a personal token.
1 npm maintainer — a single point of compromise · last published by GitHub Actions.

Maintainer of this package and think something here is wrong? Tell us and we'll correct it.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

What it can reach

Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
Downloads at launch — The package is fetched from its registry each run unless you pin a version.

Last commit 1 month ago — Actively maintained.
Repository created 1 month ago — Very new project with little track record yet.
1 GitHub stars — Very little community usage so far.

Client compatibility

Claude Code: NativeClaude Desktop: NativeCursor: NativeCodex CLI: NativeWindsurf: NativeCline: NativeVS Code: Native

Health score

A · 82

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

Maintenance30%99%
Last commit 36 days ago.
Adoption20%9%
1 stars.
Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
Provenance15%100%
Package and registry entry point at the same repository.
Packaging15%100%
Publishes a pinned version (0.3.3).

Documentation

Full README

Ads Uploader — Meta Ads MCP

The <strong>Meta Ads MCP</strong> server by Ads Uploader helps you launch and manage Meta (Facebook & Instagram) ads from Claude, ChatGPT, Cursor, and Codex.

Ads Uploader takes an existing ad you already run, turns its settings into a reusable template, and builds brand-new ads on top of it — new media, copy, CTA, and targeting — in bulk. It also duplicates existing ads by post so social proof is preserved. Point your AI agent at it and describe the ads you want.

Agent-assisted vs fully agentic. For agent-assisted launches, we recommend having your agent assemble a saved build rather than creating ads headlessly — the build is accessible, editable, and launchable from the Ads Uploader web app, so you keep a human review-and-launch step in the polished UI.

Requires an existing paid Ads Uploader account with MCP access and a connected Meta account with the necessary permissions. MCP access is not included in trials.

This repository contains public documentation and connector configuration. Ads Uploader is a proprietary product; its application, backend and MCP server implementation are not included here. See License for the scope of reuse permissions.

What it does

Build ads from a template — copy settings from any existing ad, then swap in new media, text, CTA, links, and targeting.
Bulk creation — many ads across campaigns and ad sets in one job, with per-ad text and creative options.
Duplicate by post — clone existing ads by Page post ID so the original post's likes, comments, and shares carry into new campaigns.
Partnership (branded content) ads — run ads as a partnership with a creator or brand, from your own uploaded media or an imported Instagram post, with shared or per-ad/ad-set sponsors. *(See below.)*
Media pipeline — import creatives from public URLs, a Google Drive folder, or local files.
Preview before launch — resolve a spec, check Meta permissions, and see exactly what would be created.
Multi-account — list and work across every Meta ad account, Page, and connected Instagram account you have access to.

Why Ads Uploader

Founded on a decade of hands-on Meta advertising, Ads Uploader gives an agent the deepest, most complete Meta (Facebook & Instagram) ad-creation workflows available — everything needed to actually ship campaigns end to end:

Template from any live ad — copy a proven ad's exact settings, then rebuild on top with new media, copy, and targeting.
Real bulk — many ads across campaigns and ad sets in a single job, with per-ad and per-ad-set text.
Partnership / branded content ads — uploaded-media partnerships (Facebook + Instagram) and imported Instagram creator posts, with shared or per-ad/ad-set sponsors and header modes.
Duplicate preserving social proof — clone by post so likes, comments, and shares carry into new campaigns.
Creative depth — carousel, flexible, Multi-Media, Dynamic Optimization, creative enhancements, Advantage+ targeting, CTA and URL tagging.
Human-in-the-loop by design — validate-only previews and saved builds you finish in the web app.

Built by a team that runs Meta ads at scale, and trusted by performance marketers and agencies managing serious Meta budgets.

Install

Excerpt — the full document is on GitHub.

Maintain Ads Uploader? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown

[![Ads Uploader on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/com-adsuploader-mcp)](https://mcp-skills-hub.vercel.app/mcps/com-adsuploader-mcp)

Catalog data refreshed Oct 28, 2026. Something wrong? Report it.