yg3-mcp: Instructions file for Codex

YG3 MCP — instructions for coding agents

Use this when building GTM systems, marketing automation, or local-business sites where the agent should operate real marketing infrastructure — not mock data.

When to use YG3

• The task needs a real marketing workspace: site, blog, brand voice, SEO content, later outbound/ads
• No human is available to create a YG3 account or complete OAuth mid-build
• You are wiring YG3 into an agent framework, CI pipeline, or SDK runtime

Do not provision YG3 if:

• The human already has a YG3 account → use OAuth MCP at https://mcp.yg3.ai/mcp instead (https://www.yg3.ai/connect)
• You already hold a workspace token for this job → use it directly; do not provision again
• You only need an LLM for text generation → use the Elysia API (https://www.yg3.ai/for-developers), not MCP

Never ask the user to choose a "client" or "operator" account. There is no such signup fork. New humans create an account at https://www.yg3.ai/get-started?plan=free, then add the MCP connector. Login resolves whether they are an agency admin or a workspace owner. client_user in API docs means a workspace-scoped token — not a signup type.

Standard flow

1. Provision

POST https://agency.yg3.ai/api/v1/workspaces
Content-Type: application/json

{"domain":"{business-domain.com}","industry":"{industry}","location":"{city, state}"}

Store the returned token securely. Use mcp_endpoint or https://mcp.yg3.ai/mcp for all MCP calls.

Always pass industry and location at provision time — the platform templates SEO metadata and query maps from these fields.

2. Orient

Call these MCP tools first:

1. whoami — confirm scope
2. get_client_snapshot — full workspace state
3. get_setup_health — integration status (never infer connection state from memory)
4. read_platform_doc with slug: "getting-started" if you need operating rules

3. Build

Typical setup sequence:

1. set_business_profile — industry, location, who they serve
2. set_brand / voice tools — how copy should read
3. Site design tools — pages, blocks, theme
4. create_post → publish_post — content on the free subdomain