YG3 Marketing MCP

YG3 MCP — integração com agentes

Conecte agentes autônomos às operações de marketing da YG3: conteúdo e SEO, e-mail de prospecção, LinkedIn e anúncios pagos.

Nenhum cadastro necessário para builds de agentes. Uma chamada HTTP provisiona um workspace de sandbox e retorna um token Bearer para o MCP.

Caminho	Use quando
OAuth humano	O proprietário tem uma conta YG3
Provisionamento de agente	Agente autônomo em construção, CI ou runtime de 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

197+ 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 da integração
set_business_profile	Setor, localização, público
set_brand	Voz da marca e posicionamento
create_post / publish_post	Conteúdo de blog em subdomínio gratuito
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)

Se o humano já tem uma conta YG3:

1. Adicione https://mcp.yg3.ai/mcp como um conector MCP personalizado
2. Faça login quando solicitado
3. Guia de configuração: 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 um 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 se conecta 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

Escritas 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 será vinculado 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. Arquivados, não apagados.

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
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-integration
• yg3://docs/getting-started
• yg3://docs/tools-reference

Limites do sandbox

Workspaces não reivindicados são sandboxes de nível gratuito por design:

• Pode: ler tudo, definir perfil/marca/voz, projetar site, escrever e publicar artigos em blog-{slug}.yg3.ai
• Não pode: domínio personalizado, envio de e-mails, gastos com anúncios, posts no LinkedIn
• Expira: 14 dias, a menos que seja reivindicado

Para frameworks de agentes

Copie AGENTS.md para o seu repositório ou aponte seu agente para este README. Ele informa aos agentes de codificação quando e como provisionar a YG3 durante uma 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 MCP oficial (mcp-publisher publish)
glama.json	Indexação no diretório Glama

Namespace do registro: io.github.YG3-ai/yg3-mcp

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.