Documentation
30 pages: how to connect an AI client to your account over MCP, what every tool the agent can call actually does, the open-source skills that teach a client how to use them, and what each channel needs before it will publish.
Machine-readable index: /docs/llms.txt
MCP
- Connect an AI client (MCP)One remote URL connects Claude, ChatGPT, Cursor, VS Code, Gemini CLI or Windsurf to your Marketing OS account — nothing to install, and every change still waits for your approval.
- MCP tool referenceEvery one of the 128 tools the Marketing OS MCP endpoint exposes — what each one does, its risk tier and its arguments. Generated from the registry itself.
MCP clients
- Claude CodeConnect Claude Code to Marketing OS over the remote MCP endpoint — one command, OAuth in the browser, no local process.
- Claude Desktop and claude.aiAdd Marketing OS as a custom connector in Claude Desktop or on claude.ai — paste one URL and approve the scopes in the browser.
- ChatGPTAdd Marketing OS to ChatGPT as a developer-mode connector over OAuth.
- CursorPoint Cursor at the Marketing OS MCP endpoint with a three-line mcp.json, over OAuth or an API key.
- VS Code (GitHub Copilot)Add Marketing OS to VS Code's Copilot agent mode with a workspace .vscode/mcp.json.
- Gemini CLIAdd Marketing OS to the Gemini CLI with a one-key httpUrl entry in settings.json.
- WindsurfAdd Marketing OS to Windsurf's Cascade with a serverUrl entry in mcp_config.json.
REST API
Skills
- Marketing OS — foundationStart here for any Marketing OS work, and load this before any other marketing-os skill — it is the prerequisite that fetches the account context every other one grades against.
- AI search and local visibilityFind out whether a business gets recommended by AI assistants and in local search, and do something about it.
- AuditAudit a whole marketing account and report what state it is in.
- Creative testingDecide what creative to run next and prove what actually worked.
- Cross-channel playbooksRun a marketing job that crosses channels in one pass — paid ads, organic social, content, local SEO and AI-search visibility together.
- DiagnoseFind out why a marketing number moved, or why something stopped working.
- LaunchLaunch something new — a Meta campaign, a social post or schedule, a blog post, email or ad copy.
- ScaleMove money toward what is working and away from what is not.
Setup guides
- Social publishing setupEverything that has to happen in a developer portal before Facebook Pages, Instagram, TikTok and YouTube publishing works for a real business — and how to verify each one.
- Shopify setupCreate the Shopify app behind the store integration, set the API environment, and know what a Shopify app review will ask for.
- Billing setup (Stripe)The runbook a deployment follows before it can take money: the plan ladder, the Stripe products and prices, the webhook, and the environment it all reads.
- Affiliate program setup (Rewardful)The runbook for turning on the affiliate program: the Rewardful account, the Stripe connection, the tracking script and the four pieces that live in this repo.
- TikTok Ads setupCreate the TikTok Marketing API app behind the TikTok Ads channel, set the API environment, get the app approved, and know what a sandbox can and cannot prove.
- Google Ads setupGet Google Ads API access for the Cloud project behind the OAuth client now that developer tokens are gone, register the callback, set the API environment, and connect a first account.
- Klaviyo setupCreate the Klaviyo OAuth app behind the email channel, set the API environment, and know exactly what Marketing OS reads from Klaviyo and writes to it.
- WebhooksSend a project's alerts and instant-form leads to Zapier, Make, n8n, your CRM or your own service as signed JSON: the headers, the signature, the retry schedule, the exact event for every alert kind and lead event, and a Node verification snippet.
- PromotionsPromo codes you run with partners: create one, put it on your Shopify store, share its link, launch a Campaign Wizard campaign around it, drop it into a social post, and see the orders and revenue it brought in.
Guides
- Disaster recoveryHow to get Marketing OS back after the production database, Redis or a secret is lost, how much data that costs, and how long it takes. Each number here was either read from the Railway project or mea
- Google Business Profile setupGoogle Business Profile (GBP) connects each business's locations for three things:
- SOC 2 readiness assessmentThis is a self-assessment, not a certification. Marketing OS holds no SOC 2 attestation — not Type I, not Type II, and no auditor is engaged. This document exists so that the gap between "we take secu