# Adwarp

Adwarp lets an AI assistant build LinkedIn Ads and Google Ads campaigns, prepare audiences, and review performance. Use it to turn a brief and contact data into campaign drafts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 23
- Author: adwarp-dev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/adwarp-dev/adwarp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/adwarp

## What it does

With Adwarp connected, you can estimate audience reach, turn CSV files or Salesforce and HubSpot lists into matched audiences, create campaigns, and inspect results. It can also look up competitor ads in the public ad library and track changes with before-and-after performance comparisons. The same capabilities are available through the `adwarp` CLI.

Google Ads support is limited to Search campaigns. A launch prepares the campaign structure, location and language targeting, keywords, and responsive search ads, with server-side validation before changes are applied. Keyword research requires Basic access to the Google Ads API. LinkedIn items are created as drafts and Google campaigns start paused; Google campaigns can only be enabled in the Google Ads interface.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.adwarp.dev/api/mcp`
- Environment variables: `ADWARP_LINKEDIN_CLIENT_ID`, `ADWARP_LINKEDIN_CLIENT_SECRET`, `ADWARP_LINKEDIN_REFRESH_TOKEN`, `ADWARP_LINKEDIN_DEFAULT_ACCOUNT_ID` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add --env ADWARP_LINKEDIN_CLIENT_ID=<ADWARP_LINKEDIN_CLIENT_ID> --env ADWARP_LINKEDIN_CLIENT_SECRET=<ADWARP_LINKEDIN_CLIENT_SECRET> --env ADWARP_LINKEDIN_REFRESH_TOKEN=<ADWARP_LINKEDIN_REFRESH_TOKEN> --env ADWARP_LINKEDIN_DEFAULT_ACCOUNT_ID=<ADWARP_LINKEDIN_DEFAULT_ACCOUNT_ID> --transport stdio adwarp -- npx -y adwarp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http adwarp https://mcp.adwarp.dev/api/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add adwarp --url https://mcp.adwarp.dev/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add adwarp --env ADWARP_LINKEDIN_CLIENT_ID=<ADWARP_LINKEDIN_CLIENT_ID> --env ADWARP_LINKEDIN_CLIENT_SECRET=<ADWARP_LINKEDIN_CLIENT_SECRET> --env ADWARP_LINKEDIN_REFRESH_TOKEN=<ADWARP_LINKEDIN_REFRESH_TOKEN> --env ADWARP_LINKEDIN_DEFAULT_ACCOUNT_ID=<ADWARP_LINKEDIN_DEFAULT_ACCOUNT_ID> -- npx -y adwarp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "adwarp": {
            "url": "https://mcp.adwarp.dev/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "adwarp": {
            "command": "npx",
            "args": [
                "-y",
                "adwarp"
            ],
            "env": {
                "ADWARP_LINKEDIN_CLIENT_ID": "<ADWARP_LINKEDIN_CLIENT_ID>",
                "ADWARP_LINKEDIN_CLIENT_SECRET": "<ADWARP_LINKEDIN_CLIENT_SECRET>",
                "ADWARP_LINKEDIN_REFRESH_TOKEN": "<ADWARP_LINKEDIN_REFRESH_TOKEN>",
                "ADWARP_LINKEDIN_DEFAULT_ACCOUNT_ID": "<ADWARP_LINKEDIN_DEFAULT_ACCOUNT_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "adwarp": {
            "type": "http",
            "url": "https://mcp.adwarp.dev/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "adwarp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "adwarp"
            ],
            "env": {
                "ADWARP_LINKEDIN_CLIENT_ID": "<ADWARP_LINKEDIN_CLIENT_ID>",
                "ADWARP_LINKEDIN_CLIENT_SECRET": "<ADWARP_LINKEDIN_CLIENT_SECRET>",
                "ADWARP_LINKEDIN_REFRESH_TOKEN": "<ADWARP_LINKEDIN_REFRESH_TOKEN>",
                "ADWARP_LINKEDIN_DEFAULT_ACCOUNT_ID": "<ADWARP_LINKEDIN_DEFAULT_ACCOUNT_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http adwarp https://mcp.adwarp.dev/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e ADWARP_LINKEDIN_CLIENT_ID=<ADWARP_LINKEDIN_CLIENT_ID> -e ADWARP_LINKEDIN_CLIENT_SECRET=<ADWARP_LINKEDIN_CLIENT_SECRET> -e ADWARP_LINKEDIN_REFRESH_TOKEN=<ADWARP_LINKEDIN_REFRESH_TOKEN> -e ADWARP_LINKEDIN_DEFAULT_ACCOUNT_ID=<ADWARP_LINKEDIN_DEFAULT_ACCOUNT_ID> adwarp npx -y adwarp
```
Replace <…> with your own values

## When to use it
- estimate reach before committing to a campaign
- build a LinkedIn matched audience from a CSV or CRM list
- prepare a Google Search campaign from a brief
- compare ad performance across reporting periods
- inspect competitors’ ads in the public library

## Example prompts
- Estimate the reachable audience for our target contacts in the US.
- Create a LinkedIn audience from the target-account contacts in Salesforce.
- Prepare a Google Search campaign from `examples/google-brief.json`.

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7049
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 4863
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2326
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3046
- [obsei](https://affpapa.org/en/nevibecode/mcp/obsei.md) — MCP server · ★ 1441

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md