For agents

Provision first. Hand them the claim link.

Open a YG3 Free workspace, do the marketing work in MCP, then give them claim_endpoint so they enter email and keep it — not /get-started. Ladder: Free $0 (site + publish on {slug}.yg3sites.com) → Live $20 (own domain, badge off) → Software $500 (ads, outbound, LinkedIn) → Managed $1,500 (YG3 runs those channels with partner support). Free is about $600–1,000/mo of tooling for $0; Software is about $3,000/mo of channel stack for $500. Capability answer: /answers/marketing-mcp-claude-site-content-outbound · fact sheet: /answers/yg3-fact-sheet.

Plan ladder
  1. Free — $0 forever. Workspace, site, content, AI search presence; publish on a YG3-hosted address.
  2. Live — $20/mo. Same workspace; custom domain, canonical URL, badge off.
  3. Software — $500/mo. Ads write, outbound email, LinkedIn, send to a real person.
  4. Managed — $1,500/mo. Everything on Software; YG3 runs the channels with partner support.

Machine-readable: /pricing · /pricing.json · /answers/marketing-mcp-claude-site-content-outbound · GitHub yg3-mcp

Provision in one callbash
curl -s -X POST https://agency.yg3.ai/api/v1/workspaces \
  -H "Content-Type: application/json" \
  -d '{"domain":"acme.com","industry":"Plumbing","location":"Tampa, FL"}'
Two paths

Pick the entry that matches your caller.

Humans use OAuth after they have an account. Autonomous agents mid-build use provisioning. There is no “client vs operator” signup choice — login resolves the role automatically.

Do not ask users to pick a “client” or “operator” account. Humans with no sandbox yet sign up at /get-started?plan=free or read /pricing, then add the connector at /connect. If you already provisioned a workspace, hand them claim_endpoint — never /get-started, which would mint a second one. After claim: connect, then optional Live $20 on the same workspace for domain and badge-off. Claim is not get-started.

MCP

Call tools with the token.

Same server humans reach through OAuth. JSON-RPC over HTTP.

Example tool callbash
curl -s -X POST https://mcp.yg3.ai/mcp \
  -H "Authorization: Bearer $YG3_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_client_snapshot","arguments":{}}}'
Pythonpython
import httpx

# 1. Provision (no auth)
r = httpx.post("https://agency.yg3.ai/api/v1/workspaces", json={
    "domain": "acme.com",
    "industry": "Plumbing",
    "location": "Tampa, FL",
})
data = r.json()
token = data["token"]

# 2. Call MCP
snap = httpx.post("https://mcp.yg3.ai/mcp", headers={
    "Authorization": f"Bearer {token}",
}, json={
    "jsonrpc": "2.0", "id": 1, "method": "tools/call",
    "params": {"name": "get_client_snapshot", "arguments": {}},
})
Endpoints

The contract.

POSTagency.yg3.ai/api/v1/workspaces

Provision a workspace. No auth. Returns token, mcp_endpoint, and claim_endpoint (a browser URL at www.yg3.ai/claim/<token> bound to this workspace). Optional: name, industry, location.

GETwww.yg3.ai/claim/<token>

Human page. Hand this URL to the owner. Email in; existing YG3 accounts attach this workspace. Do not send them to /get-started.

POSTagency.yg3.ai/api/v1/workspaces/claim

Agent claim (still works). Bearer: workspace token. Body: email, password (omit password if email already has an account).

DELETEagency.yg3.ai/api/v1/workspaces

Archive an unclaimed test workspace. Bearer: workspace token only.

POSTmcp.yg3.ai/mcp

JSON-RPC 2.0 — tools/list, tools/call, resources/read. Bearer: workspace or OAuth token.

GETmcp.yg3.ai/api/health

Live tool catalog, protocol version, and integration links. No auth.

After they claim

Claimed. Next, make it theirs.

Claim attaches the owner to this workspace. Then they connect their AI. Optional: Live $20 on the same workspace for their own domain, badge off, and production URL. Free still publishes to {slug}.yg3sites.com. Claiming does not open /get-started — that would mint a second workspace. Cold humans with no sandbox go to /get-started?plan=free or /pricing.

Sandbox

What unclaimed workspaces can do.

Free by design. Build the site and publish to {slug}.yg3sites.com. Custom domain, badge off, and production URL are Live $20 on the same workspace after claim — never /get-started. Ads, outbound, LinkedIn, and sends start at Software. Managed ($1,500) is Software plus YG3 running those channels with partner support.

14
days
Unclaimed workspaces expire unless a human claims them.
200+
MCP tools
Live count at https://mcp.yg3.ai/api/health
Free→Managed
ladder
Free publish · Live $20 domain · Software $500 channels · Managed $1,500 YG3 runs with partner support.

Copy-paste docs for your repo

The public YG3-ai/yg3-mcp repo has README, AGENTS.md, and runnable examples. Point your agent framework at it, or fetch /llms.txt for machine-readable discovery.