YG3 Marketing MCP

السجل الرسمي التسويق والمبيعات

Marketing MCP: content, SEO, outbound, LinkedIn, ads. Agents provision a sandbox with one POST.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http yg3-marketing-mcp 'https://mcp.yg3.ai/mcp' --header 'Authorization: <Agent path: Bearer token from POST https://agency.yg3.ai/api/v1/workspaces. Human path: OAuth session from https://www.yg3.ai/connect.>'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "yg3-marketing-mcp": {
            "type": "http",
            "url": "https://mcp.yg3.ai/mcp",
            "headers": {
                "Authorization": "<Agent path: Bearer token from POST https://agency.yg3.ai/api/v1/workspaces. Human path: OAuth session from https://www.yg3.ai/connect.>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. YG3 MCP — marketing workspace your AI can run
  2. Quick start (agent path)
  3. Tools
  4. Human path (OAuth)
  5. Agent path (no login)
  6. Discovery
  7. Sandbox limits
  8. For agent frameworks
  9. Registry listings
  10. Related
  11. License

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.

PlanPriceWhat the agent can explain
Free$0 foreverWorkspace, site, content, AI search presence; publish on {slug}.yg3sites.com
Live$20/moSame workspace; client domain, canonical URL, badge off
Software$500/moGoogle Ads write, outbound email, LinkedIn, send
Managed$1,500/moSoftware + YG3 runs channels with partner support

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).

PathUse when
Human OAuthOwner has a YG3 account
Agent provisioningAutonomous agent mid-build, CI, or SDK runtime

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:

ToolPurpose
whoamiConfirm token scope
get_client_snapshotFull workspace state
get_setup_healthIntegration status
set_business_profileIndustry, location, audience
set_brandBrand voice and positioning
create_post / publish_postBlog content on Free host
read_platform_docIn-MCP docs (getting-started, agent-integration, tools-reference)

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:

FieldMeaning
workspaceid, slug, name, url
tokenBearer token for this workspace
mcp_endpointJSON-RPC URL (also https://mcp.yg3.ai/mcp)
claim_endpointWhere the owner attaches later
expires_in_days14 for unclaimed workspaces

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

FilePurpose
server.jsonOfficial MCP Registry (mcp-publisher publish)
glama.jsonGlama directory indexing

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

Listed under Marketing on mcpservers.org and Glama.

License

MIT — see LICENSE.

الأسئلة الشائعة

ما هو YG3 Marketing MCP؟

Marketing MCP: content, SEO, outbound, LinkedIn, ads. Agents provision a sandbox with one POST.

كيف أثبّت YG3 Marketing MCP؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http yg3-marketing-mcp 'https://mcp.yg3.ai/mcp' --header 'Authorization: <Agent path: Bearer token from POST https://agency.yg3.ai/api/v1/workspaces. Human path: OAuth session from https://www.yg3.ai/connect.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج YG3 Marketing MCP إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل YG3 Marketing MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون YG3 Marketing MCP؟

ينشره YG3-ai. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.