Perfil

Get the brand voice profile

social_brand_voice.profile.get

Returns the organization's Brand Voice, the guide MB Suite's AI follows when it writes captions, video scripts, post ideas and inbox replies: personality (tones, custom_tone_note, communication_style), vocabulary (preferred_words, avoided_words, jargon_level), format (emoji_usage, hashtag_usage, post_structure), audience (audience_persona, tone_adaptation_note), per-network adjustments (platform_adjustments for instagram, facebook, linkedin and tiktok: tone_note, max_caption_length, include_hashtags) and ai_summary, the short description shown on the Brand Voice screen. configured=false and profile=null when it was never set or was reset. Values: tones formal, casual, friendly, authoritative, inspirational, humorous or educational; communication_style descriptive, narrative, direct or conversational; jargon_level avoid, moderate or technical; emoji_usage none, minimal, moderate or free; hashtag_usage none, moderate or per_platform. Requires view access to Brand Voice.

Alcance

social_brand_voice:read

Permiso

Ver el módulo

Tool del MCP

social_brand_voice_profile_getEn la superficie completa; en la compacta, mb_execute_operation con id: "social_brand_voice.profile.get".

Costo declarado: hasta 2 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Sin parámetros.

Respuesta

Errores

Ejemplo

curl "https://api.mb-suite.com/v1/social-brand-voice/profile" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl "https://api.mb-suite.com/v1/social-brand-voice/profile" \
  -H "Authorization: Bearer $MB_TEST_KEY"

Update the brand voice profile

social_brand_voice.profile.update

Changes one or more fields of the Brand Voice (updates object) and creates the profile if there was none. Only what is sent changes: tones, preferred_words and avoided_words replace the whole list ([] empties it); null clears a text or option field; platform_adjustments replaces all the per-network adjustments (keys instagram, facebook, linkedin, tiktok; null removes them). Values: tones formal, casual, friendly, authoritative, inspirational, humorous or educational; communication_style descriptive, narrative, direct or conversational; jargon_level avoid, moderate or technical; emoji_usage none, minimal, moderate or free; hashtag_usage none, moderate or per_platform. Through the API and the MCP it never spends AI: when a field that ai_summary describes changes (tones, communication style, tone note, emojis, hashtags, preferred or avoided words, audience) the summary is cleared, and the screen writes it again the next time someone saves there, unless updates.ai_summary brings one written by hand (up to 1,000 characters): then it is saved as sent even if those fields change in the same request (null clears it), and it stays until someone changes a field it describes without sending a new one, or saves on the screen after changing one. On the screen the summary is rewritten with AI and uses the AI credits of the person who saves; with no credits left the profile is still saved, without a new summary. ai_summary_status says what happened (provided, regenerated, kept, cleared, failed, or no_credits when the screen could not rewrite it for lack of AI credits); a hand-written summary that changed also comes in changed_fields as ai_summary. Sending the same values changes nothing (changed_fields comes back empty). Every change fires social_brand_voice.profile.updated. If someone else saved at the same instant it fails with brand_voice_profile_changed (409): read the profile again and retry. Returns the profile as it was saved. Requires edit access to Brand Voice.

Alcance

social_brand_voice:write

Permiso

Editar en el módulo

Tool del MCP

social_brand_voice_profile_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "social_brand_voice.profile.update".

Eventos que puede emitir

social_brand_voice.profile.updated

Costo declarado: hasta 2 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Respuesta

Errores

Ejemplo

curl -X PATCH "https://api.mb-suite.com/v1/social-brand-voice/profile" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X PATCH "https://api.mb-suite.com/v1/social-brand-voice/profile" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "updates": {}
}'

Reset the brand voice profile

social_brand_voice.profile.reset

Resets the Brand Voice: deletes the whole profile (tones, vocabulary, format, audience and per-network adjustments) and MB Suite's AI stops applying it. The documents uploaded to Brand Voice stay (delete them with social_brand_voice.documents.delete). The profile goes to the 30-day trash and owners and admins can restore it; if a new profile was saved in between, reset that one first and then restore the old one. With no profile configured it does nothing (reset=false). Fires social_brand_voice.profile.updated with profile=null. Outside the screen it needs confirmation: a dry run and its confirm_token, or the simple DELETE of the REST API. Requires edit access to Brand Voice.

Con una API key, este DELETE se ejecuta directo: el registro queda 30 días en la papelera y la respuesta trae su trash_item_id. Con un token OAuth, y por el MCP, pide dry_run → confirm_token.

Alcance

social_brand_voice:write y «Permitir eliminar» (social_brand_voice:delete en OAuth)

Permiso

Editar en el módulo

Tool del MCP

social_brand_voice_profile_resetEn la superficie completa; en la compacta, mb_execute_operation con id: "social_brand_voice.profile.reset".

Eventos que puede emitir

social_brand_voice.profile.updated

Costo declarado: hasta 1 lecturas y 2 escrituras por llamada (cuentan en el cupo diario).

Parámetros

Sin parámetros.

Respuesta

Errores

Ejemplo

curl -X DELETE "https://api.mb-suite.com/v1/social-brand-voice/profile" \
  -H "Authorization: Bearer $MB_API_KEY"

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar.

curl -X DELETE "https://api.mb-suite.com/v1/social-brand-voice/profile" \
  -H "Authorization: Bearer $MB_TEST_KEY"