WorkMagic MCPサーバー
コミット 2026年11月13日Lets an AI assistant query marketing attribution, incrementality, and media budget planning data from your WorkMagic account.
別名 workmagicio/workmagic-agent-plugin, workmagic-agent-plugin
- スター
- 23
- ツール
- —
- ダウンロード数（30日間）
- —
- 最新バージョン
- 1.0.2
- 最終コミット
- 2026年11月13日
- ライセンス
- MIT
WorkMagic MCPとは
WorkMagicはMCPサーバーです。 Lets an AI assistant query marketing attribution, incrementality, and media budget planning data from your WorkMagic account.
プロジェクトのREADMEから生成された概要
WorkMagic MCP server について
Querying marketing attribution, incrementality, and media budget planning data from a WorkMagic account is what this MCP server enables for ecommerce and DTC brands. Marketing professionals can use it within AI clients like Claude, ChatGPT, Cursor, Gemini, and Copilot to ask questions about their performance in plain language. The server connects to your existing WorkMagic account to retrieve data across channels such as Meta, Google, and TikTok.
Users interact with the server through nine specific skills that handle tasks like comparing attribution models, diagnosing anomalies, or interpreting lift test results. The setup requires an active WorkMagic account, and you will be prompted to sign in during your first interaction. While most queries are for reading data, the server can also modify account settings, such as creating new Media Budget Optimizer scenarios, after receiving your explicit confirmation.
できること
- 1Compare attribution modelsAsk the assistant to show how revenue differs between data-driven, last-click, and first-click models.
- 2Diagnose performance changesInvestigate why specific attribution metrics suddenly spiked or dropped.
- 3Plan media budgetsRequest a new budget allocation strategy for your upcoming marketing spend.
- 4Analyze lift testsGet an interpretation of completed geo lift tests to determine incremental ROAS.
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
WorkMagic MCPのインストール方法
フォーマット検証日 2026年11月10日Claude CodeにWorkMagic MCPをインストール
$ claude mcp add --transport http workmagic-agent-plugin https://mcp.workmagic.io/mcpCursorにWorkMagic MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"workmagic-agent-plugin": {
"url": "https://mcp.workmagic.io/mcp"
}
}
}VS CodeにWorkMagic MCPをインストール
.vscode/mcp.json
{
"servers": {
"workmagic-agent-plugin": {
"type": "http",
"url": "https://mcp.workmagic.io/mcp"
}
}
}CodexにWorkMagic MCPをインストール
~/.codex/config.toml
[mcp_servers.workmagic-agent-plugin] url = "https://mcp.workmagic.io/mcp"
Gemini CLIにWorkMagic MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"workmagic-agent-plugin": {
"httpUrl": "https://mcp.workmagic.io/mcp"
}
}
}自動チェック
実行日 2026年11月14日詳細レポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能workmagicio/workmagic-agent-plugin is public and reachablegithub.com/workmagicio/workmagic-agent-plugin ↗合格
- パッケージがこのリポジトリをソースとして示している未チェック
- ビルドの来歴（Sigstore 証明）未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-13github.com/workmagicio/workmagic-agent-plugin ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージと依存関係に重大なアドバイザリがない未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモート endpoint が MCP ハンドシェイクに応答するHTTPS endpoint answered 401 (sign-in required)合格
README
GitHubで見るWorkMagic for AI assistants
Ask your marketing measurement data anything — in Claude, ChatGPT, Codex, Cursor, Copilot or Gemini. Attribution by channel and campaign, why a number moved, lift test results and media budget plans, answered from your own WorkMagic account.
⭐ Star this repo to follow new skills and platforms as they ship — see the changelog.
What is WorkMagic
WorkMagic is an AI-powered marketing measurement platform for ecommerce and DTC brands. It brings multi-touch attribution (MTA), incrementality (geo lift tests) and media mix modeling (MMM) / budget planning together — across Meta, Google, TikTok and more — so you can see what's actually driving sales and decide where to spend next.
This open-source (MIT) plugin lets your AI assistant ask that same data questions in plain language, using your own WorkMagic account — an open-source MCP server plus skills for marketing attribution, incrementality and MMM.
See it in action
You: Compare Meta and Google attributed revenue under data-driven, last click, first click and any-click attribution for the last 30 days, and explain why they differ.
Claude: (abridged — WorkMagic demo store, synthetic data)
Channel Data-driven Last click First click Any click Meta $10.2K $17.3K $27.1K $38.0K $12.7K $19.9K — $33.2K Meta looks strongest under first- and any-click because it starts most journeys: shoppers first arrive from a Meta ad, then come back through Google or direct before buying. Data-driven attribution splits each order's credit across those touchpoints, so both channels shrink. Any-click gives every touched channel full credit, which is why the two any-click figures add up to more than the store actually sold ($46.9K).
More sample conversations: readiness check · model comparison · best-selling products
What's included
The plugin has two parts: the WorkMagic MCP server (https://mcp.workmagic.io/mcp), which
reads and updates your WorkMagic account after you sign in, and nine skills that tell the
assistant how to use it well.
| Skill | Use it when you want to |
|---|---|
attribution-data-query |
Get attribution numbers — ROAS, CAC, revenue, orders by channel, campaign or period |
attribution-intent-clarification |
Ask a vague question; the assistant asks one focused follow-up, then answers |
attribution-model-comparison |
See iDDA, DDA, last-click and platform-reported numbers side by side, and why they differ |
attribution-anomaly-diagnosis |
Understand why attribution dropped, spiked or shows zero |
attribution-custom-dimension |
Break results down by audience, region, brand or another label in your campaign names |
attribution-edge-routing |
Get pointed to the right place when a question is outside attribution |
lift-test-readout |
Interpret a completed lift test (incremental ROAS, confidence) and decide what to do next |
mbo-read-scenario |
Read, compare or reconcile a Media Budget Optimizer scenario |
mbo-create-scenario |
Ask "how should I split my budget?" and get a configured MBO scenario |
Try asking:
- "What was my Meta ROAS last week?"
- "Why did Google attribution drop on Tuesday?"
- "Which products sold the most in the last 30 days?"
- "How should I split a $200K budget next month?"
- "Is my account ready to run a Meta lift test?"
Get WorkMagic
Using this plugin needs an active WorkMagic account.
- New to WorkMagic? See plans and pricing to get started.
- Already a customer? Install below and sign in with your WorkMagic account the first time the assistant uses it.
Questions about plans? Contact your WorkMagic CSM or support@workmagic.io. Lift test and budget optimizer skills need those features enabled on your account.
Install
Claude (claude.ai, desktop, Cowork)
- Open plugin settings (Settings → Plugins, or Plugins & skills), choose Add marketplace
→ GitHub repo, enter
workmagicio/workmagic-agent-plugin, then install WorkMagic. (Listing in the Claude plugin directory is coming soon.) - Open the plugin's Connectors tab and connect WorkMagic.
Only want the data connection? Add https://mcp.workmagic.io/mcp under Customize > Connectors
as a custom connector.
Claude Code
/plugin marketplace add workmagicio/workmagic-agent-plugin
/plugin install workmagic@workmagic-plugins
Codex
codex plugin marketplace add workmagicio/workmagic-agent-plugin
Then install workmagic from /plugins.
本地安装：下载 release 中的 workmagic-codex.zip，或在仓库中执行以下命令构建并安装：
python3 tools/build_zip.py codex
unzip dist/workmagic-codex.zip -d dist/workmagic-codex
codex plugin marketplace add ./dist/workmagic-codex
codex plugin add workmagic@workmagic-plugins
workmagic-chatgpt.zip 用于 ChatGPT 插件门户；Codex 本地安装使用 workmagic-codex.zip。
Gemini CLI
gemini extensions install https://github.com/workmagicio/workmagic-agent-plugin
ChatGPT, Cursor, GitHub Copilot
Directory listings are coming soon. Until then, connect the MCP server below; in Cursor you can also add this repository as a team marketplace.
Any other MCP client
Add https://mcp.workmagic.io/mcp as a remote (Streamable HTTP) MCP server. You get the tools;
the skills in skills/ are plain Markdown you can load as instructions.
The first time the assistant uses WorkMagic, sign in with your WorkMagic account. If you belong to several WorkMagic accounts, the assistant asks which one to use. Don't have an account yet? See Get WorkMagic above.
Data
The skills are instructions only; they don't run code or contact any other service. The assistant
reaches your data through the WorkMagic MCP server at https://mcp.workmagic.io/mcp, using the
account you sign in with. The server receives the requests the assistant makes on your behalf, such
as queries, filters and settings you ask to change, and returns your WorkMagic data. WorkMagic
logs those requests for security and support. Nothing is sent anywhere else.
Some skills can change settings in your WorkMagic account, such as creating or editing a budget scenario. The assistant shows what it will change and asks you to confirm first.
The tools/ folder holds scripts WorkMagic uses to maintain this repository. The plugin never runs
them.
Follow WorkMagic
New skills, platforms and product updates ship often — follow along:
- ⭐ Star this repo and watch releases for new versions.
Support
Contact your WorkMagic CSM or support@workmagic.io. Privacy policy: www.workmagic.io/privacy. Found a problem with a skill? Open an issue.
WorkMagic MCPのよくある質問
WorkMagic MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http workmagic-agent-plugin https://mcp.workmagic.io/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
WorkMagic MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
What can I ask the AI about my marketing data?
You can ask about attribution by channel and campaign, why specific numbers moved, lift test results, and media budget plans.
Do I need a WorkMagic account to use this plugin?
Yes, using this plugin requires an active WorkMagic account.
How does the assistant access my data?
The assistant reaches your data through the WorkMagic MCP server using the account you sign in with.
Can the AI change settings in my account?
Yes, some skills can change settings like creating or editing a budget scenario, but the assistant will ask for your confirmation first.