# YG3 — marketing operations for AI agents

> Run content, SEO, outbound, LinkedIn, and paid ads from any AI agent or assistant.

YG3 is a marketing platform with a remote MCP server. Humans connect with OAuth; autonomous agents provision a sandbox workspace with one HTTP call — no signup required.

## Human path (existing YG3 account)

- MCP connector URL: https://mcp.yg3.ai/mcp
- Setup guide: https://www.yg3.ai/connect
- Claude Code: claude mcp add --transport http yg3 https://mcp.yg3.ai/mcp

## Agent path (no account, no OAuth)

Provision a workspace and receive a Bearer token:

- POST https://agency.yg3.ai/api/v1/workspaces
- Body: {"domain":"acme.com","industry":"Plumbing","location":"Tampa, FL"}
- Optional fields: "name" (if no domain)
- Returns: workspace, token, mcp_endpoint, claim_endpoint, expires_in_days (14)

Call MCP tools with the token:

- POST https://mcp.yg3.ai/mcp
- Header: Authorization: Bearer <token>
- Body: JSON-RPC 2.0 — e.g. {"jsonrpc":"2.0","id":1,"method":"tools/list"}

Claim (when a human is ready):

- POST https://agency.yg3.ai/api/v1/workspaces/claim
- Header: Authorization: Bearer <workspace-token>
- Body: {"email":"owner@example.com","password":"..."}

Remove an unclaimed test workspace:

- DELETE https://agency.yg3.ai/api/v1/workspaces
- Header: Authorization: Bearer <workspace-token>

## Discovery

- Live tool catalog: https://mcp.yg3.ai/api/health
- Agent integration guide: https://www.yg3.ai/for-agents
- Public docs + examples: https://github.com/slamdunkboy17/yg3-mcp
- MCP OAuth metadata: https://mcp.yg3.ai/.well-known/oauth-protected-resource

## Sandbox limits (unclaimed / free tier)

- Builds site, voice, and articles; publishes to blog-{slug}.yg3.ai
- Cannot attach custom domain, send email, spend on ads, or post to social
- Unclaimed workspaces expire in 14 days unless claimed

## Docs inside MCP (after connecting)

Read via MCP resource or the read_platform_doc tool:

- yg3://docs/getting-started
- yg3://docs/connecting
- yg3://docs/agent-integration
- yg3://docs/tools-reference