YG3 Marketing MCP

YG3 MCP — integración con agentes

Conecta agentes autónomos a las operaciones de marketing de YG3: contenido y SEO, correo saliente, LinkedIn y anuncios pagados.

No se requiere registro para builds de agentes. Una llamada HTTP aprovisiona un workspace sandbox y devuelve un token Bearer para MCP.

Ruta	Úsala cuando
OAuth humano	El propietario tiene una cuenta YG3
Aprovisionamiento de agentes	Agente autónomo en medio del build, CI o runtime SDK

Inicio rápido (ruta de 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":{}}}'

Ejemplo en Python: examples/provision-and-call.py

Herramientas

Más de 197 herramientas MCP (conteo en vivo: https://mcp.yg3.ai/api/health). Puntos de entrada comunes:

Herramienta	Propósito
whoami	Confirmar alcance del token
get_client_snapshot	Estado completo del workspace
get_setup_health	Estado de integraciones
set_business_profile	Industria, ubicación, audiencia
set_brand	Voz de marca y posicionamiento
create_post / publish_post	Contenido de blog en subdominio gratuito
read_platform_doc	Documentación dentro de MCP (getting-started, agent-integration, tools-reference)

Catálogo completo después de conectar: tools/list o GET https://mcp.yg3.ai/api/health.

Ruta humana (OAuth)

Si el humano ya tiene una cuenta YG3:

1. Agrega https://mcp.yg3.ai/mcp como conector MCP personalizado
2. Inicia sesión cuando se te solicite
3. Guía de configuración: https://www.yg3.ai/connect

Claude Code:

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

Configuración MCP de Cursor / VS Code: consulta examples/cursor-mcp.json

Ruta de agente (sin inicio de sesión)

Aprovisionamiento

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

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

Opcional: "name" si aún no tienes un dominio.

Respuesta 201:

Campo	Significado
workspace	id, slug, nombre, url
token	Token Bearer para este workspace
mcp_endpoint	URL JSON-RPC (también https://mcp.yg3.ai/mcp)
claim_endpoint	Donde el propietario se vincula más tarde
expires_in_days	14 para workspaces no reclamados

No vuelvas a aprovisionar si ya tienes un token de workspace para el trabajo actual.

MCP

Todas las llamadas son JSON-RPC 2.0 sobre HTTP:

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

Métodos: tools/list, tools/call, resources/read, initialize

Las escrituras son de dos pasos: llama sin confirm para obtener un plan, luego llama de nuevo con confirm: true y el mismo idempotency_key.

Reclamación (el humano toma el control)

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

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

Si el correo ya tiene una cuenta YG3, omite password — el workspace se vincula a esa cuenta.

Eliminar un workspace de prueba

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

Solo workspaces no reclamados. Archivados, no borrados.

Descubrimiento

Recurso	URL
Catálogo de herramientas en vivo	https://mcp.yg3.ai/api/health
Guía de agente (web)	https://www.yg3.ai/for-agents
Página de conexión humana	https://www.yg3.ai/connect
Índice legible por máquina	https://www.yg3.ai/llms.txt
Metadatos OAuth de MCP	https://mcp.yg3.ai/.well-known/oauth-protected-resource

Después de conectar, lee la documentación de la plataforma vía MCP:

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

Límites del sandbox

Los workspaces no reclamados son sandboxes de nivel gratuito por diseño:

• Puede: leer todo, configurar perfil/marca/voz, diseñar sitio, escribir y publicar artículos en blog-{slug}.yg3.ai
• No puede: dominio personalizado, envío de correos, gasto en anuncios, publicaciones en LinkedIn
• Expira: 14 días a menos que se reclame

Para frameworks de agentes

Copia AGENTS.md en tu repositorio o apunta tu agente a este README. Le indica a los agentes de codificación cuándo y cómo aprovisionar YG3 durante un build.

ClawHub (OpenClaw)

Skill publicable: 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 basados en curl

Archivos de skill curlables (estilo Moltbook): distribute/

• Documento de instalación: distribute/skill.md
• Rutina periódica: distribute/heartbeat.md
• Metadatos: distribute/skill.json

Los agentes pueden obtenerlos desde raw GitHub una vez que este repositorio sea público, o desde https://www.yg3.ai/llms.txt.

Listados en registros

Archivo	Propósito
server.json	Registro MCP oficial (mcp-publisher publish)
glama.json	Indexación en directorio Glama

Espacio de nombres del registro: io.github.YG3-ai/yg3-mcp

Relacionados

• Elysia LLM API (modelos de texto/visión/imagen): https://www.yg3.ai/for-developers
• Quill (socio de pensamiento multi-IA, PyPI): https://github.com/YG3-ai/quill

Licencia

MIT — consulta LICENSE.