PropellerAds MCP Server
PropellerAds MCPサーバー
AIによるプログラマティック広告の民主化
ClaudeのようなAIアシスタントに、PropellerAdsの広告キャンペーンを自動管理させましょう。
クイックスタート • 利用可能なツール • 使用例 • MCP設定
これは何ですか?
PropellerAds MCPは、AIアシスタント(ClaudeおよびMCP互換クライアント)をPropellerAds広告プラットフォームAPIに直接接続するModel Context Protocolサーバーです。手動でダッシュボードにログインしたり、レポートを抽出したり、設定画面をクリックして回ったりする必要はありません。AIアシスタントに自然な日本語で話しかけるだけで、すべてを処理してくれます。
キャンペーンの作成、パフォーマンス分析、パフォーマンスの低いゾーンのブラックリスト登録、スケーリングの機会の発見、期間比較など、すべて自然な会話を通じて行えます。
対象ユーザー:
メディアバイヤーおよびパフォーマンスマーケター
iGamingおよびアプリインストールのアフィリエイト
グロースハッカーおよびデジタルエージェンシー
PropellerAdsキャンペーンを運用し、効率化したいすべての方
Related MCP server: Google Ad Manager MCP Server
機能
キャンペーンの全ライフサイクル管理 -- チャットを離れることなく、キャンペーンの作成、更新、開始、停止、複製が可能
リアルタイムのパフォーマンス分析 -- インプレッション、クリック、コンバージョン、CTR、CVR、CPC、CPA、ROIを自動計算
期間比較 -- 任意の2つの期間をトレンド指標とともに並べて比較
ゾーンレベルの最適化 -- 予算を浪費しているパフォーマンスの低いゾーンを特定し、ホワイトリストに登録すべき優良ゾーンを発見
自動ブラックリスト登録 -- コマンド1つで不正なゾーンを特定し、ブラックリストに登録(ドライラン安全モード付き)
スケーリングのインテリジェンス -- 高いROIとコンバージョン数を持ち、スケーリング準備が整ったキャンペーンを自動的に発見
クリエイティブのパフォーマンス分析 -- どのクリエイティブが成果を上げ、どれを差し替えるべきかを把握
セキュアな設計 -- APIトークンは環境変数に保存され、会話中に露出することはありません
ドライラン(テスト実行)の安全性 -- 破壊的な操作は、実行前にプレビューモードで確認可能
利用可能なツール
キャンペーン管理
ツール | 説明 | 必須パラメータ |
| フィルタ付きで全キャンペーンを一覧表示 | -- |
| キャンペーンの詳細情報(ターゲティング、クリエイティブ、設定)を取得 |
|
| 新しい広告キャンペーンを作成 |
|
| キャンペーン設定(予算、入札、名前、ステータス)を変更 |
|
| 一時停止中のキャンペーンを1つ以上開始 |
|
| アクティブなキャンペーンを1つ以上一時停止 |
|
| 既存のキャンペーンを複製 |
|
list_campaignsのフィルタ: status (active/paused/pending/rejected), ad_format (push/onclick/interstitial/in-page-push), name (部分一致)
統計・分析
ツール | 説明 | 必須パラメータ |
| 計算済み指標(CTR, CVR, CPC, CPA, ROI)を含む詳細統計 | -- |
| 特定キャンペーンのパフォーマンス概要 |
|
| 2つの期間を変化指標とともに比較 |
|
| ゾーン/プレースメントレベルの分析(ソート可能) | -- |
| クリエイティブレベルのパフォーマンス分析 | -- |
一般的なオプションパラメータ: date_from, date_to (YYYY-MM-DD, デフォルトは過去7日間), campaign_id, group_by (date/campaign/zone/country/creative/device_type/browser/os)
最適化
ツール | 説明 | 必須パラメータ |
| コンバージョンなしで予算を消費しているゾーンを特定(ブラックリスト候補) |
|
| パフォーマンスの高いゾーンを特定(ホワイトリスト候補) |
|
| スケーリング準備が整ったキャンペーンを特定(高ROI + ボリューム) | -- |
| 不正なゾーンを特定し、ワンステップでブラックリスト登録(デフォルトはドライラン) |
|
ターゲティング
ツール | 説明 | 必須パラメータ |
| キャンペーンのホワイトリストにゾーンを追加 |
|
| キャンペーンのブラックリストにゾーンを追加 |
|
アカウント
ツール | 説明 | 必須パラメータ |
| 現在のアカウント残高を確認 | -- |
| ターゲティング可能な全国を一覧表示 | -- |
| 利用可能な広告フォーマット(push, onclick等)を一覧表示 | -- |
技術スタック
コンポーネント | 技術 |
ランタイム | Python 3.10+ |
プロトコル | |
HTTPクライアント | |
バリデーション | Pydantic v2 |
API | |
ビルドシステム | |
トランスポート | stdio (標準MCPトランスポート) |
クイックスタート
前提条件
APIアクセス権を持つPropellerAdsアカウント
最低条件: 総利用額またはデポジットが$1,000以上
APIトークンの取得: https://ssp.propellerads.com/#/app/profile
Python 3.10+
Claude Desktop または Claude Code (またはMCP互換クライアント)
インストール
オプション1: PyPIからインストール(推奨)
pip install propellerads-mcpオプション2: ソースからインストール
git clone https://github.com/JanNafta/propellerads-mcp.git
cd propellerads-mcp
pip install -e .APIトークンの設定
プロジェクトルートに.envファイルを作成するか、環境変数をエクスポートしてください:
export PROPELLERADS_API_TOKEN="your_api_token_here"使用例
キャンペーン管理
"Show me all my active campaigns sorted by ROI"
"Create a push campaign for gaming offers in Brazil with $100 daily budget"
"Pause all campaigns with negative ROI in the last 7 days"
"Clone my best performing campaign to Mexico, Colombia, and Peru"パフォーマンス分析
"What's my campaign performance for the last week?"
"Compare this week's performance vs last week"
"Show me the top 10 zones by conversions for campaign 12345"
"Which creatives have CTR below 0.5%?"最適化ワークフロー
"Find all zones spending over $50 without conversions and blacklist them"
"Show me campaigns ready for scaling -- ROI above 50% with at least 10 conversions"
"Find top performing zones for my dating campaigns and add them to a whitelist"日次最適化ルーチン
1. "Show me yesterday's performance for all campaigns"
2. "Find and blacklist underperforming zones across all campaigns"
3. "Which campaigns are ready for scaling?"
4. "Increase budget by 50% for profitable campaigns"MCP設定
Claude Desktop
Claude Desktopの設定ファイルに追加してください:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"propellerads": {
"command": "python",
"args": ["-m", "propellerads_mcp"],
"env": {
"PROPELLERADS_API_TOKEN": "your_api_token_here"
}
}
}
}設定を保存した後、Claude Desktopを再起動してください。
Claude Code
CLIを使用してClaude CodeにMCPサーバーを追加します:
claude mcp add propellerads -- python -m propellerads_mcpClaude Codeを起動する前に、シェル環境でPROPELLERADS_API_TOKENが設定されていることを確認してください。
その他のMCPクライアント
このサーバーは、標準的なMCP通信方式であるstdioトランスポートを使用します。MCP互換クライアントは、プロセスを起動することで接続できます:
python -m propellerads_mcpサーバーは環境変数からPROPELLERADS_API_TOKENを読み取ります。MCPクライアントのenv設定で渡すか、シェルで設定してください。
プロジェクト構造
propellerads-mcp/
├── src/
│ └── propellerads_mcp/
│ ├── __init__.py # Package init, version, exports
│ ├── __main__.py # Module entry point (python -m)
│ ├── client.py # PropellerAds API client (httpx-based)
│ └── server.py # MCP server, tool definitions & handlers
├── .env.example # Environment variable template
├── .gitignore
├── LICENSE # MIT License
├── pyproject.toml # Build config, dependencies, metadata
└── README.mdセキュリティと権限
項目 | 詳細 |
認証 | 環境変数経由のBearerトークン(ハードコード不可) |
読み取り操作 | 追加確認なしで実行 |
書き込み操作 | 明示的なユーザーの意図が必要(作成、更新、開始、停止、ブラックリスト登録) |
自動ブラックリスト | デフォルトで |
レート制限 | PropellerAds APIのレート制限を遵守 |
データ保存なし | サーバーはステートレスであり、ローカルにデータは保持されません |
貢献
貢献を歓迎します!以下の手順で協力いただけます:
リポジトリをフォーク
フィーチャーブランチを作成 (
git checkout -b feature/my-feature)変更をコミット (
git commit -m "Add my feature")ブランチにプッシュ (
git push origin feature/my-feature)プルリクエストをオープン
バグ報告や機能リクエストは、issueを作成してください。
作者
Jan Naftanaila -- メディアバイヤー兼AI自動化スペシャリスト
AIとプログラマティック広告の架け橋となるツールを開発。アドテクをより身近で、自動化された、インテリジェントなものにすることに注力しています。
ライセンス
このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルを参照してください。
PropellerAds MCP -- オープンソース。プログラマティック広告コミュニティのために構築されました。
Available Tools
21 toolsadd_to_blacklistC
Add zones to campaign blacklist.
Inputs: campaign_id (required), zone_ids (required).
add_to_whitelistC
Add zones to campaign whitelist.
Inputs: campaign_id (required), zone_ids (required).
auto_blacklist_zonesC
Automatically find and blacklist underperforming zones for a campaign.
Inputs: campaign_id (required), min_spend, max_conversions, date_from, +2 more.
clone_campaignC
Create a copy of an existing campaign.
Inputs: campaign_id (required), new_name.
compare_periodsC
Compare performance between two time periods.
Inputs: period1_from (required), period1_to (required), period2_from (required), period2_to (required), +1 more.
create_campaignC
Create a new advertising campaign with specified settings.
Inputs: name (required), ad_format (required), countries (required), daily_budget (required), +4 more.
find_scaling_opportunitiesC
Find campaigns ready for scaling based on ROI and conversion volume.
Inputs: min_roi, min_conversions, date_from, date_to.
find_top_zonesC
Find best performing zones. Useful for whitelist candidates.
Inputs: campaign_id (required), min_conversions, min_roi, limit, +2 more.
find_underperforming_zonesB
Find zones that are spending money but not converting. Useful for blacklist candidates.
Inputs: campaign_id (required), min_spend, max_conversions, date_from, +1 more.
get_ad_formatsB
Get list of available ad formats.
Inputs: no named parameters.
get_available_countriesB
Get list of available countries for targeting.
Inputs: no named parameters.
get_balanceB
Get current account balance.
Inputs: no named parameters.
get_campaign_detailsB
Get complete details for a specific campaign including targeting, creatives, and settings.
Inputs: campaign_id (required).
get_campaign_performanceC
Get performance summary for a specific campaign with calculated metrics and insights.
Inputs: campaign_id (required), date_from, date_to.
get_creative_performanceC
Get performance statistics for creatives.
Inputs: campaign_id, date_from, date_to.
get_performance_reportC
Get detailed performance statistics with metrics like impressions, clicks, conversions, spend, CTR, CVR, CPC, CPA, and ROI.
Inputs: date_from, date_to, group_by, campaign_id.
get_zone_performanceB
Get performance statistics grouped by zone/placement. Useful for whitelist/blacklist optimization.
Inputs: campaign_id, date_from, date_to, limit, +1 more.
list_campaignsB
List all campaigns with optional filters. Returns campaign ID, name, status, ad format, and basic metrics.
Inputs: status, ad_format, name.
start_campaignsC
Activate/start one or more campaigns.
Inputs: campaign_ids (required).
stop_campaignsC
Pause/stop one or more campaigns.
Inputs: campaign_ids (required).
update_campaignC
Update campaign settings like budget, bid, targeting, or status.
Inputs: campaign_id (required), name, daily_budget, total_budget, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Most tools have distinct purposes with clear boundaries, such as campaign management (create, clone, update, start, stop), performance analysis (get_campaign_performance, get_performance_report), and zone optimization (find_top_zones, find_underperforming_zones). However, some overlap exists between get_campaign_performance and get_performance_report, which could cause confusion about which to use for campaign-specific metrics.
Tool names follow a highly consistent verb_noun pattern throughout, such as create_campaign, list_campaigns, get_balance, and find_top_zones. All tools use snake_case without deviation, making them predictable and easy to parse for agents.
With 21 tools, the count is slightly high but reasonable for the comprehensive advertising campaign management domain. It covers campaign lifecycle, performance reporting, and optimization tasks, though it borders on being heavy compared to typical well-scoped servers (3-15 tools).
The toolset provides complete coverage for the advertising campaign domain, including CRUD operations (create, list, get, update, clone), lifecycle management (start, stop), performance analysis (various get and compare tools), and optimization features (blacklist/whitelist, scaling, zone analysis). No obvious gaps are present, enabling agents to handle end-to-end workflows.
Maintenance
Related MCP Connectors
Build, edit and sync Google, Microsoft, Reddit and Meta ad campaigns from your assistant.
Manage and optimize your ads on Meta, Google, TikTok, X, ChatGPT Ads, Reddit and LinkedIn from chat.
Manage Google, Meta, TikTok, Microsoft, Pinterest, Amazon, LinkedIn & Reddit ads from your AI
Run Google Ads and Meta Ads from ChatGPT or Claude: audit wasted spend, create and manage campaigns.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage TikTok advertising campaigns through the TikTok Ads API. Supports campaign creation, performance analytics, audience management, creative operations, and custom reporting through natural language interactions.54MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Google Ad Manager campaigns, line items, creatives, and advertisers through natural language, automating ad operations that normally require countless clicks through the UI.3558 PyPI20MIT
- FlicenseNot gradedqualityDmaintenanceEnables comprehensive management of Google Ads campaigns through natural language, including campaign creation, ad group management, keyword operations, Performance Max campaigns, conversion tracking, and performance insights with support for multiple accounts.3-

AdButler MCP Serverofficial
AlicenseCqualityCmaintenanceEnables managing your entire AdButler advertising account from any AI assistant, exposing over 600 tools covering the full AdButler v2 API for display ads, video, targeting, reporting, programmatic, and more, plus pre-built workflow prompts.100150 npm1MIT