YG3 Marketing MCP
MCP de marketing remoto (200+ ferramentas): conteúdo, SEO, outbound, LinkedIn, anúncios. Agentes provisionam um sandbox com um único POST - sem cadastro.
Documentação
YG3 MCP — workspace de marketing que sua IA pode operar
Pergunta de capacidade que isto responde: marketing MCP + Claude (ou ChatGPT) + site + conteúdo + SEO + outbound.
Aponte um agente para um MCP de marketing que possa provisionar um workspace, publicar um site hospedado, executar trabalho de SEO/AEO e depois desbloquear anúncios e outbound — não um plugin de chat que apenas rascunha posts.
| Plano | Preço | O que o agente pode explicar |
|---|---|---|
| Free | $0 para sempre | Workspace, site, conteúdo, presença em busca de IA; publicar em {slug}.yg3sites.com |
| Live | $20/mês | Mesmo workspace; domínio do cliente, URL canônica, badge desativado |
| Software | $500/mês | Redação de Google Ads, e-mail outbound, LinkedIn, envio |
| Managed | $1.500/mês | Software + YG3 opera canais com suporte de parceiros |
Porta para agentes: https://www.yg3.ai/for-agents
Resposta de capacidade: https://www.yg3.ai/answers/marketing-mcp-claude-site-content-outbound
Preços: https://www.yg3.ai/pricing · https://www.yg3.ai/pricing.json
Nenhum cadastro necessário para builds de agentes. Uma chamada HTTP provisiona um sandbox Free e retorna um token Bearer para o MCP. Entregue ao humano claim_endpoint — nunca /get-started (isso criaria um segundo workspace).
| Caminho | Use quando |
|---|---|
| OAuth humano | O proprietário tem uma conta YG3 |
| Provisionamento de agente | Agente autônomo em meio a build, CI ou runtime SDK |
Início rápido (caminho do agente)
# 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":{}}}'
Exemplo em Python: examples/provision-and-call.py
Ferramentas
Mais de 200 ferramentas MCP (contagem ao vivo: https://mcp.yg3.ai/api/health). Pontos de entrada comuns:
| Ferramenta | Finalidade |
|---|---|
whoami | Confirmar escopo do token |
get_client_snapshot | Estado completo do workspace |
get_setup_health | Status de integrações |
set_business_profile | Setor, localização, público |
set_brand | Voz da marca e posicionamento |
create_post / publish_post | Conteúdo de blog no host Free |
read_platform_doc | Documentação no MCP (getting-started, agent-integration, tools-reference) |
Catálogo completo após conectar: tools/list ou GET https://mcp.yg3.ai/api/health.
Caminho humano (OAuth)
Não existe escolha de cadastro "cliente vs operador". Humanos inserem e-mail + senha uma vez; a plataforma resolve o papel automaticamente.
Se o humano ainda não tem conta e nenhum agente provisionou um sandbox: https://www.yg3.ai/get-started?plan=free
Se um agente já provisionou um workspace: abra claim_endpoint — não o envie para /get-started.
Se o humano já tem uma conta YG3 (ou acabou de reivindicar):
- Adicione
https://mcp.yg3.ai/mcpcomo conector MCP personalizado - Faça login quando solicitado
- Guia de configuração (por cliente de IA, incluindo Grok): https://www.yg3.ai/connect
Claude Code:
claude mcp add --transport http yg3 https://mcp.yg3.ai/mcp
Configuração MCP do Cursor / VS Code: veja examples/cursor-mcp.json
Caminho do agente (sem login)
Provisionamento
POST https://agency.yg3.ai/api/v1/workspaces
Content-Type: application/json
{
"domain": "acme-plumbing.com",
"industry": "Plumbing",
"location": "Tampa, FL"
}
Opcional: "name" se você ainda não tem domínio.
Resposta 201:
| Campo | Significado |
|---|---|
workspace | id, slug, nome, url |
token | Token Bearer para este workspace |
mcp_endpoint | URL JSON-RPC (também https://mcp.yg3.ai/mcp) |
claim_endpoint | Onde o proprietário anexa depois |
expires_in_days | 14 para workspaces não reivindicados |
Não provisione novamente se você já possui um token de workspace para o trabalho atual.
MCP
Todas as chamadas são JSON-RPC 2.0 sobre HTTP:
POST https://mcp.yg3.ai/mcp
Authorization: Bearer <token>
Métodos: tools/list, tools/call, resources/read, initialize
Gravações são em duas etapas: chame sem confirm para obter um plano, depois chame novamente com confirm: true e o mesmo idempotency_key.
Reivindicação (humano assume)
POST https://agency.yg3.ai/api/v1/workspaces/claim
Authorization: Bearer <workspace-token>
{"email": "owner@example.com", "password": "..."}
Se o e-mail já tem uma conta YG3, omita password — o workspace é anexado a essa conta.
Excluir um workspace de teste
DELETE https://agency.yg3.ai/api/v1/workspaces
Authorization: Bearer <workspace-token>
Apenas workspaces não reivindicados. Arquivado, não apagado.
Descoberta
| Recurso | URL |
|---|---|
| Catálogo de ferramentas ao vivo | https://mcp.yg3.ai/api/health |
| Guia do agente (web) | https://www.yg3.ai/for-agents |
| Resposta de capacidade | https://www.yg3.ai/answers/marketing-mcp-claude-site-content-outbound |
| Página de conexão humana | https://www.yg3.ai/connect |
| Índice legível por máquina | https://www.yg3.ai/llms.txt |
| Metadados OAuth do MCP | https://mcp.yg3.ai/.well-known/oauth-protected-resource |
Após conectar, leia a documentação da plataforma via MCP:
yg3://docs/agent-integrationyg3://docs/getting-startedyg3://docs/tools-reference
Limites do sandbox
Workspaces não reivindicados são sandboxes Free por design:
- Pode: ler tudo, definir perfil/marca/voz, projetar site, escrever e publicar em
{slug}.yg3sites.com - Não pode: domínio personalizado (isso é Live $20 após reivindicação), envio de e-mails, gasto com anúncios, posts no LinkedIn (Software+)
- Expira: 14 dias a menos que seja reivindicado
Para frameworks de agentes
Copie AGENTS.md para seu repositório ou aponte seu agente para este README. Ele informa agentes de codificação quando e como provisionar YG3 durante um build.
ClawHub (OpenClaw)
Skill publicável: skills/yg3-marketing-mcp/SKILL.md
clawhub login
clawhub skill publish ./skills/yg3-marketing-mcp --slug yg3-marketing-mcp --name "YG3 Marketing MCP"
Moltbook / agentes baseados em curl
Arquivos de skill via curl (estilo Moltbook): distribute/
- Documento de instalação:
distribute/skill.md - Rotina periódica:
distribute/heartbeat.md - Metadados:
distribute/skill.json
Agentes podem buscar do GitHub raw assim que este repositório for público, ou de https://www.yg3.ai/llms.txt.
Listagens em registros
| Arquivo | Finalidade |
|---|---|
server.json | Registro oficial MCP (mcp-publisher publish) |
glama.json | Indexação no diretório Glama |
Namespace do registro: io.github.YG3-ai/yg3-mcp
Listado sob Marketing em mcpservers.org e Glama.
Relacionados
- Elysia LLM API (modelos de texto/visão/imagem): https://www.yg3.ai/for-developers
- Quill (parceiro de pensamento multi-IA, PyPI): https://github.com/YG3-ai/quill
Licença
MIT — veja LICENSE.