# KeyesCode Marketing OS

> The multi-channel marketing OS: AI search visibility, paid and organic publishing, and an
> agent that acts inside your approvals. Every AI client connects over one remote MCP URL —
> https://marketing-api.keyescode.com/mcp — and every change that spends money or leaves the product waits for a
> human in the approvals inbox.

## MCP

- [Connect an AI client (MCP)](https://marketing.keyescode.com/docs/mcp-client-setup): 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 reference](https://marketing.keyescode.com/docs/mcp/tools): Every 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 Code](https://marketing.keyescode.com/docs/mcp/clients/claude-code): Connect Claude Code to Marketing OS over the remote MCP endpoint — one command, OAuth in the browser, no local process.
- [Claude Desktop and claude.ai](https://marketing.keyescode.com/docs/mcp/clients/claude-desktop): Add Marketing OS as a custom connector in Claude Desktop or on claude.ai — paste one URL and approve the scopes in the browser.
- [ChatGPT](https://marketing.keyescode.com/docs/mcp/clients/chatgpt): Add Marketing OS to ChatGPT as a developer-mode connector over OAuth.
- [Cursor](https://marketing.keyescode.com/docs/mcp/clients/cursor): Point Cursor at the Marketing OS MCP endpoint with a three-line mcp.json, over OAuth or an API key.
- [VS Code (GitHub Copilot)](https://marketing.keyescode.com/docs/mcp/clients/vs-code): Add Marketing OS to VS Code's Copilot agent mode with a workspace .vscode/mcp.json.
- [Gemini CLI](https://marketing.keyescode.com/docs/mcp/clients/gemini-cli): Add Marketing OS to the Gemini CLI with a one-key httpUrl entry in settings.json.
- [Windsurf](https://marketing.keyescode.com/docs/mcp/clients/windsurf): Add Marketing OS to Windsurf's Cascade with a serverUrl entry in mcp_config.json.

## REST API

- [REST API reference](https://marketing.keyescode.com/docs/api): Every REST route an organization API key can call — 393 operations, generated from the API's own controllers.

## Skills

- [Marketing OS — foundation](https://marketing.keyescode.com/docs/skills/marketing-os): Start 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 visibility](https://marketing.keyescode.com/docs/skills/ai-search-visibility): Find out whether a business gets recommended by AI assistants and in local search, and do something about it.
- [Audit](https://marketing.keyescode.com/docs/skills/marketing-audit): Audit a whole marketing account and report what state it is in.
- [Creative testing](https://marketing.keyescode.com/docs/skills/creative-testing): Decide what creative to run next and prove what actually worked.
- [Cross-channel playbooks](https://marketing.keyescode.com/docs/skills/cross-channel-playbooks): Run a marketing job that crosses channels in one pass — paid ads, organic social, content, local SEO and AI-search visibility together.
- [Diagnose](https://marketing.keyescode.com/docs/skills/marketing-diagnose): Find out why a marketing number moved, or why something stopped working.
- [Launch](https://marketing.keyescode.com/docs/skills/marketing-launch): Launch something new — a Meta campaign, a social post or schedule, a blog post, email or ad copy.
- [Scale](https://marketing.keyescode.com/docs/skills/marketing-scale): Move money toward what is working and away from what is not.

## Setup guides

- [Social publishing setup](https://marketing.keyescode.com/docs/social-publishing-setup): Everything 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 setup](https://marketing.keyescode.com/docs/shopify-setup): Create the Shopify app behind the store integration, set the API environment, and know what a Shopify app review will ask for.
- [Billing setup (Stripe)](https://marketing.keyescode.com/docs/billing-setup): 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)](https://marketing.keyescode.com/docs/affiliate-program): 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 setup](https://marketing.keyescode.com/docs/tiktok-ads-setup): Create 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 setup](https://marketing.keyescode.com/docs/google-ads-setup): Get 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 setup](https://marketing.keyescode.com/docs/klaviyo-setup): Create 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.
- [Webhooks](https://marketing.keyescode.com/docs/webhooks): Send 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.
- [Promotions](https://marketing.keyescode.com/docs/promotions): Promo 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 recovery](https://marketing.keyescode.com/docs/DISASTER_RECOVERY): How 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 setup](https://marketing.keyescode.com/docs/google-gbp-setup): Google Business Profile (GBP) connects each business's locations for three things:
- [SOC 2 readiness assessment](https://marketing.keyescode.com/docs/security/soc2-readiness): This 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