Marketing Ops MCP
Provides an optional OpenAI Responses agent runner with a bounded function-calling loop that can invoke the marketing operations tools via the OpenAI API; the deterministic MCP tools do not require an OpenAI key.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Marketing Ops MCP calculate funnel conversion rates from 10,000 visits, 2,000 leads, 500 customers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Marketing Ops MCP
Original Python tools for evidence-first marketing work through ChatGPT-compatible MCP, OpenAI Responses agents, or a local CLI. Version 0.1.1 is an independently implemented alpha release; it is not a fork, a renamed Claude project, or a claim of feature parity with larger reference projects.
Working capabilities
calculate_funnel: explicit-denominator conversion rates, cost per lead, media cost per customer and ROAS.reconcile_transactions: exact-ID outer join with decimal arithmetic, duplicate detection and attribution-scope gates.design_experiment: two-proportion, fixed-horizon sample-size approximation.analyze_experiment: sample-ratio checks, stopping-horizon gate, sparse-data gate and two-sided comparison.build_campaign_url: normalized UTM parameters with explicit replacement and query preservation.
These are analysis tools, not CRM connectors or autonomous campaign operators. They do not infer incrementality, fully loaded CAC from media spend, lifetime value from one period, or causal attribution. Experiment assumptions and approximation limitations are included in results.
Related MCP server: 1ClickReport MCP Server
Run the offline example
Python 3.11+ is required. No API key is needed for this example.
python -m venv .venv
. .venv/bin/activate
pip install -e '.[dev]'
marketing-ops-mcp tools
marketing-ops-mcp run calculate_funnel examples/demo.json --out output/demo
pytest -q
ruff check .The command creates report.json, report.csv, report.md and an escaped report.html. JSON contains the complete structured result; CSV contains tabular findings or metrics when available. No output is published automatically. Inputs are validated and bounded. Errors fail explicitly instead of producing invented success.
Use with ChatGPT and OpenAI
marketing-ops-mcp serve
# Local HTTP endpoint: http://127.0.0.1:8765/mcp
# Generate and export a random secret (keep it private):\nexport MARKETING_OPS_HTTP_TOKEN="$(python -c 'import secrets; print(secrets.token_urlsafe(48))')"\nmarketing-ops-mcp serve --transport streamable-http
# Requires OPENAI_API_KEY and OPENAI_MODEL in your environment:
marketing-ops-mcp agent examples/task.txt --out output/agentSee ChatGPT connection instructions. A ChatGPT connection needs a reachable endpoint or supported tunnel; this repository is not already hosted or connected to your account. HTTP now requires a bearer token in the Authorization header and fails closed without MARKETING_OPS_HTTP_TOKEN (minimum 32 characters). It remains loopback-only and must not be exposed directly; use a TLS gateway with access controls for remote clients. Deterministic MCP tools need no OpenAI key. The agent runner is optional and makes billable API calls.
Repository layout
Path | Purpose |
| Typed tool registry and domain entry points |
| Bounded Responses function-calling loop |
| Official MCP SDK server |
| Safe, portable deliverables |
| Synthetic inputs and agent task |
| Domain, export, agent and real MCP protocol tests |
| Architecture, integration, validation and research |
Quality and scope
Tests cover important numerical, validation and trust boundaries, including a real MCP stdio discovery/call round trip. OpenAI agent tests use a fake client; they do not prove live model quality. CI runs tests, lint and dependency auditing across Python 3.11–3.13. See validation for the recorded local result and untested deployment boundaries.
This release prioritizes inspectable behavior over code volume. It does not claim to equal the references' line counts or broad feature sets. Scope and research explains the conceptual inspiration and remaining gaps. Source implementation was written independently; reference README descriptions informed the problem selection.
Read SECURITY.md before deployment. Contributions follow CONTRIBUTING.md and the community conduct policy. Current release: PolyForm Perimeter 1.0.0 (source-available, restrictions on competing products). The original v0.1.0 release remains available under the historical MIT licence. See licensing history and commercial-use guidance.
Available Tools
5 toolsanalyze_experimentBRead-onlyIdempotent
Review a completed fixed-horizon experiment with sample-ratio and approximation gates.
Inputs: payload (required).
build_campaign_urlBRead-onlyIdempotent
Build a normalized UTM URL while preserving unrelated parameters.
Inputs: payload (required).
calculate_funnelCRead-onlyIdempotent
Calculate explicit-denominator conversion and acquisition metrics for one cohort.
Inputs: payload (required).
design_experimentBRead-onlyIdempotent
Estimate a fixed-horizon two-proportion experiment sample size.
Inputs: payload (required).
reconcile_transactionsCRead-onlyIdempotent
Compare exact transaction IDs only when declared attribution scopes match.
Inputs: payload (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operation: funnel math, transaction reconciliation, experiment sizing, experiment review, and UTM construction. design_experiment vs analyze_experiment are clearly separated by lifecycle stage (pre-run sizing vs post-run review), leaving no realistic misselection risk.
All five tools follow a consistent snake_case verb_noun pattern (calculate_, reconcile_, design_, analyze_, build_). The convention is uniform and the verbs accurately signal the action type.
Five tools is on the lean side but each maps to a genuinely distinct analytical task with no filler. The surface is well-scoped, though it sits at the low end of what a marketing-ops server might warrant.
The set covers a coherent core: funnel conversion, transaction reconciliation, the full experiment lifecycle (design plus analysis), and campaign URL construction. Gaps exist around data ingestion, cohort/segment definition, and results export or reporting, but core workflows are workable.
Maintenance
Related MCP Connectors
Marketing-measurement MCP: dashboards, cross-channel queries, integrations, and knowledge files.
Analytics your AI agent can actually use. Track, experiment, and optimize via MCP.
An MCP for marketers that gives agents tools for SEO, AEO, socials and ads data. Generous free tier; works in Claude, ChatGPT, Cursor and other MCP clients.
Hosted MCP server for marketing agencies: connect Google Ads, GA4, Search Console, Meta, LinkedIn and more to Claude or ChatGPT. Pull reports and make changes via OAuth login, no setup.
Related MCP Servers
- AlicenseAqualityDmaintenanceFirst-party web analytics MCP server for AI agents, providing 42 tools to query traffic, events, funnels, conversions, sources, and performance data.4040 npmMIT
- FlicenseNot gradedqualityCmaintenanceProvides 40 MCP tools to connect AI assistants like Claude to marketing platforms (Google Ads, Meta Ads, GA4, Search Console, Stripe) for reading, analyzing, managing, and monitoring ad campaigns and analytics through natural language.-
- AlicenseBqualityBmaintenanceCookieless web analytics your AI agent can read. Self-host it on your own Cloudflare account (Workers + D1) and read visits, sources, pages, countries and custom events over MCP. Prefer hosted? https://a.measuremy.site/mcp (OAuth sign-in, no key).201MIT
- AlicenseNot gradedqualityCmaintenanceLets an MCP client collect the marketing evidence behind any URL — ad libraries, social, SEO, pixels, founders, Reddit, positioning history — as a token-cheap scorecard plus citable evidence index and unknowns. Enables the agent to fetch specific evidence, follow a per-channel analysis method, validate citations and grounding, and produce a step-by-step playbook for copying the growth engine.74MIT