Yg3 MCP Server

YG3 MCP — marketing workspace your AI can run

Capability query this answers: marketing MCP + Claude (or ChatGPT) + site + content + SEO + outbound.

Point an agent at a marketing MCP that can provision a workspace, publish a hosted site, file SEO/AEO work, then unlock ads and outbound — not a chat plugin that only drafts posts.

Door for agents: https://www.yg3.ai/for-agents
Capability answer: https://www.yg3.ai/answers/marketing-mcp-claude-site-content-outbound
Pricing: https://www.yg3.ai/pricing · https://www.yg3.ai/pricing.json

No signup required for agent builds. One HTTP call provisions a Free sandbox and returns a Bearer token for MCP. Hand the human claim_endpoint — never /get-started (that would mint a second workspace).

Quick start (agent path)

# 1. Provision — no auth
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"}'

# Response includes: token, mcp_endpoint, workspace.url, claim_endpoint

# 2. List MCP tools
curl -s -X POST https://mcp.yg3.ai/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# 3. Call a tool
curl -s -X POST https://mcp.yg3.ai/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_client_snapshot","arguments":{}}}'

Python example: examples/provision-and-call.py

Tools

200+ MCP tools (live count: https://mcp.yg3.ai/api/health). Common entry points:

Full catalog after connecting: tools/list or GET https://mcp.yg3.ai/api/health.

Human path (OAuth)

There is no "client vs operator" signup choice. Humans enter email + password once; the platform resolves their role automatically.

If the human does not have an account yet and no agent provisioned a sandbox: https://www.yg3.ai/get-started?plan=free

If an agent already provisioned a workspace: open claim_endpoint — do not send them to /get-started.

If the human already has a YG3 account (or just claimed):

1. Add https://mcp.yg3.ai/mcp as a custom MCP connector
2. Sign in when prompted
3. Setup guide (per AI client, including Grok): https://www.yg3.ai/connect

Claude Code:

claude mcp add --transport http yg3 https://mcp.yg3.ai/mcp

Cursor / VS Code MCP config: see examples/cursor-mcp.json

Agent path (no login)

Provision

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

{
  "domain": "acme-plumbing.com",
  "industry": "Plumbing",
  "location": "Tampa, FL"
}

Optional: "name" if you have no domain yet.

201 response:

Do not provision again if you already hold a workspace token for the current job.

MCP

All calls are JSON-RPC 2.0 over HTTP:

POST https://mcp.yg3.ai/mcp
Authorization: Bearer <token>

Methods: tools/list, tools/call, resources/read, initialize

Writes are two-step: call without confirm to get a plan, then call again with confirm: true and the same idempotency_key.

Claim (human takes over)

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

{"email": "owner@example.com", "password": "..."}

If the email already has a YG3 account, omit password — the workspace attaches to that account.

Delete a test workspace

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

Only unclaimed workspaces. Archived, not erased.

Discovery

After connecting, read platform docs via MCP:

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

Sandbox limits

Unclaimed workspaces are Free sandboxes by design:

• Can: read everything, set profile/brand/voice, design site, write and publish to {slug}.yg3sites.com
• Cannot: custom domain (that is Live $20 after claim), email sends, ad spend, LinkedIn posts (Software+)
• Expires: 14 days unless claimed

For agent frameworks

Copy AGENTS.md into your repo or point your agent at this README. It tells coding agents when and how to provision YG3 during a build.

ClawHub (OpenClaw)

Publishable skill: skills/yg3-marketing-mcp/SKILL.md

clawhub login
clawhub skill publish ./skills/yg3-marketing-mcp --slug yg3-marketing-mcp --name "YG3 Marketing MCP"

Moltbook / curl-based agents

Curlable skill files (Moltbook-style): distribute/

• Install doc: distribute/skill.md
• Periodic routine: distribute/heartbeat.md
• Metadata: distribute/skill.json

Agents can fetch from raw GitHub once this repo is public, or from https://www.yg3.ai/llms.txt.

Registry listings

Registry namespace: io.github.YG3-ai/yg3-mcp

Listed under Marketing on mcpservers.org and Glama.

Related

• Elysia LLM API (text/vision/image models): https://www.yg3.ai/for-developers
• Quill (multi-AI thinking partner, PyPI): https://github.com/YG3-ai/quill

License

MIT — see LICENSE.