SENDS an email (Amazon SES) with the SEO Planner of a month (month_key YYYY-MM): every action of the month with its type, status, description and sub-actions, plus a status summary; with format pdf the month's PDF is attached too. All recipients go in one email (to up to 20, cc up to 20). sender_id picks the From among the senders this person can use (an item of senders in branding.email_domain.get: the organization's verified domain or, for an Account, its workspace's; none or __system__ = MB Suite); 403 sender_not_allowed otherwise. locale (es, en, pt-BR; default es) is the language of the email: texts, month, action types and statuses. The send is recorded in the share history (seo_planner.shares.list). It reaches real inboxes: confirm the recipients first. Errors: 503 pdf_unavailable when the PDF service is not available (format pdf; nothing is sent, retry later); when SES does not send the email, 429 external_rate_limited, 409 external_rejected (its reason in details.provider_message), 503 external_unavailable (it surely did not reach SES: retry) or 409 external_outcome_unknown (no answer: the email may have gone out; check with the recipients before sending it again), all with details.platform ses. Viewers cannot share (403 role_required). Requires full access to the SEO Planner.
Pide confirmación: primero dry_run: true (vista previa y confirm_token, que vale 10 minutos y una sola vez), después el mismo cuerpo con confirm_token. En unas pocas, solo con ciertos datos: la descripción dice cuándo. Por qué y cómo: Vista previa y confirmación.
Alcance
seo_planner:write
Permiso
Editar en el módulo
Tool del MCP
seo_planner_shares_sendEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_planner.shares.send".
Costo declarado: hasta 520 lecturas y 1 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (ses): cuenta en el cupo de operaciones externas.
Parámetros
month_keystringcuerporequerido
The month to share (YYYY-MM).
formatenumcuerporequerido
html: the email with the month's actions; pdf: the same email with the month's PDF attached.
Valores: pdf, html
toarray<string>cuerporequerido
Recipients (1 to 20 addresses).
subjectstringcuerporequerido
The subject (1 to 200 characters).
ccarray<string>cuerpoopcional
Copies (up to 20).
personal_notestringcuerpoopcional
A personal note shown at the top of the email, signed by the sender (up to 2,000 characters).
sender_idstringcuerpoopcional
The From: the id of a sender this person can use (an item of senders in branding.email_domain.get, of the organization or, for an Account, of its workspace); __system__ or nothing sends as MB Suite. 403 sender_not_allowed otherwise.
localeenumcuerpoopcional
Language of the email (texts, month name, type and status labels): es (default), en or pt-BR.
Valores: es, en, pt-BR
Respuesta
share_idstring
The share record (seo_planner.shares.list).
action_countnumber
Planner actions (cards) of the month.
effective_action_countnumber
The «Total actions» the email shows: each sub-action counts as one when the card has a checklist.
Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.
GET/v1/seo-planner/shares
List the SEO planning emails sent
seo_planner.shares.list
LecturaIdempotenteDesde 2026-11-01
Lists the emails that shared the SEO planning, newest first, paginated by cursor: month, format, recipients (to, cc), subject, personal note, sender, who sent it (sent_by with sent_by_name, the person's current name) and how many actions it carried. With month_key (YYYY-MM), only that month's. Viewers cannot see the history (403 role_required). Requires view access to the SEO Planner.
Alcance
seo_planner:read
Permiso
Ver el módulo
Tool del MCP
seo_planner_shares_listEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_planner.shares.list".
Costo declarado: hasta 202 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).
Parámetros
limitintegerqueryopcional
How many items this page brings at most (see the maximum and the default in the schema).
Por defecto: 50
cursorstringqueryopcional
The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.
Builds, without sending anything, the HTML of the email that seo_planner.shares.send would send for a month (month_key YYYY-MM) in a format (html by default, or pdf: the email that goes with the PDF, without building the PDF), with the branding of the sender it would use (sender_id), the optional personal note and the locale (es by default, as the send). Returns html, action_count (the planner actions of the month) and effective_action_count (the «Total actions» the email shows, where each sub-action counts as one). Viewers cannot preview (403 role_required). Requires view access to the SEO Planner.
Alcance
seo_planner:read
Permiso
Ver el módulo
Tool del MCP
seo_planner_shares_previewEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_planner.shares.preview".
Costo declarado: hasta 510 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).
Parámetros
month_keystringqueryrequerido
The month (YYYY-MM).
formatenumqueryopcional
html (default) or pdf: the email of each format (the PDF itself is not built).
Valores: pdf, html · Por defecto: "html"
personal_notestringqueryopcional
A personal note shown at the top of the email, signed by the sender (up to 2,000 characters).
sender_idstringqueryopcional
The From: the id of a sender this person can use (an item of senders in branding.email_domain.get, of the organization or, for an Account, of its workspace); __system__ or nothing sends as MB Suite. 403 sender_not_allowed otherwise.
localeenumqueryopcional
Language of the email (texts, month name, type and status labels): es (default), en or pt-BR.
Valores: es, en, pt-BR
Respuesta
htmlstring
The email's HTML.
action_countnumber
Planner actions (cards) of the month.
effective_action_countnumber
The «Total actions» the email shows: each sub-action counts as one when the card has a checklist.
