> ## Documentation Index
> Fetch the complete documentation index at: https://docs.so-me.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Servidor MCP de redes sociales para agentes de IA

> Deja que Claude, Cursor, Codex o cualquier cliente MCP programe publicaciones, responda mensajes y lea analíticas a través del servidor MCP remoto de Social media studio.

## ¿Qué es MCP?

El [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) es un estándar abierto para conectar herramientas de IA con servicios externos. El servidor MCP de Social media studio permite que los agentes de IA creen, programen y gestionen publicaciones en redes sociales directamente.

## Datos de conexión

| Propiedad | Valor |
| - | - |
| **Endpoint completo** (Cursor / personalizado) | `https://api.so-me.studio/mcp` |
| **Endpoint del directorio** (marketplace, sin herramientas de imagen/vídeo con IA) | `https://api.so-me.studio/mcp/directory` |
| **Endpoint del directorio de Claude** (Claude Connectors Directory) | `https://api.so-me.studio/mcp/claude` |
| **Transporte** | Streamable HTTP (solo POST) |
| **Autenticación** | Encabezado `X-API-Key` **o** OAuth 2.1 (PKCE) |
| **Modo** | Sin estado (sin sesiones) |

> [!NOTE]
>
> Los conectores personalizados (Cursor, conector personalizado de Claude con una clave pegada) pueden seguir usando
> `X-API-Key`. Las fichas de los marketplaces usan OAuth: la ficha del Claude Connectors Directory usa
> la URL del **directorio de Claude** (ver abajo), y los demás marketplaces usan la URL del **directorio**,
> que excluye las herramientas de imagen/vídeo con IA.

> [!NOTE]
>
> La URL MCP del directorio filtra las herramientas de generación de imágenes y vídeo con IA (política del
> directorio de Claude). Las herramientas de IA para textos/descripciones y de programación siguen disponibles. El catálogo completo permanece en
> `/mcp`.

## Conector del directorio de Claude

**Social media studio** (con tecnología de So-me Studio) tiene su propio endpoint para Claude. La ficha del Claude
Connectors Directory y el plugin de Social media studio para Claude lo usan, y puedes
añadirlo hoy mismo como conector personalizado mediante URL (**Customize** > **Connectors** > **Add custom
connector**). Da a Claude las mismas 28 herramientas de publicación que los plugins de ChatGPT y Grok.

| Propiedad | Valor |
| - | - |
| **URL** | `https://api.so-me.studio/mcp/claude` |
| **Inicio de sesión** | OAuth 2.1 con PKCE. Claude abre la página de inicio de sesión de Social media studio; no se necesita clave de API. |
| **Espacio de trabajo** | El espacio de trabajo que apruebes en la página de consentimiento. Se aplican tu plan, tus permisos y tus límites de uso. |

El conector cubre:

* **Publicación y programación** — crear, actualizar, programar, desprogramar, reintentar y eliminar publicaciones, y leer el calendario
* **Borradores** — crear, editar, eliminar y convertir borradores en publicaciones
* **Biblioteca de medios y subida** — explorar, buscar y subir imágenes y vídeos
* **Comprobaciones de medios** — comprobar los archivos con las reglas de medios de cada plataforma antes de publicar
* **Opciones de publicación** — cadenas de hilos, un primer comentario y ajustes de privacidad e interacción de TikTok
* **Destinos** — cuentas conectadas, tableros de Pinterest y canales de Discord y Slack

No cubre analíticas, la bandeja de entrada, facturación, administración de cuentas ni la generación de imágenes y vídeo
con IA. Las publicaciones de Reddit y Google Business Profile no se admiten en esta versión.

> [!NOTE]
>
> El camino para desarrolladores no cambia: usa `https://api.so-me.studio/mcp` con un encabezado `X-API-Key`
> para obtener el catálogo completo de herramientas.

## OAuth (clientes de directorio)

Social media studio admite MCP OAuth 2.1 con PKCE (S256), metadatos de recurso protegido y
registro dinámico de clientes / metadatos del servidor de autorización compatibles con CIMD.

La [guía Auth.md](https://so-me.studio/auth.md), legible por agentes, describe el flujo PKCE completo para clientes públicos. Su URL y el método `user_authorization` admitido también se publican en el bloque `agent_auth` de los metadatos OAuth.

| Endpoint | Finalidad |
| - | - |
| `GET /.well-known/oauth-protected-resource/mcp/directory` | Metadatos de recurso protegido del MCP del directorio |
| `GET /.well-known/oauth-protected-resource/mcp/claude` | Metadatos de recurso protegido del MCP del directorio de Claude |
| `GET /.well-known/oauth-authorization-server` | Descubrimiento del servidor de autorización (PKCE S256) |
| `GET /oauth/authorize` | Autorización + consentimiento |
| `POST /oauth/token` | Intercambio / renovación de tokens |
| `POST /oauth/register` | Registro dinámico de clientes (alternativa) |

Las herramientas de escritura siguen sujetas al plan (acceso a la API Standard, Advanced o Lifetime) tanto en sesiones con clave de API como con OAuth.

## Herramientas disponibles

Una vez conectado, tu agente de IA puede llamar a **205 herramientas**, agrupadas a continuación por área. Cada herramienta consume un pequeño número de créditos MCP por llamada (1 = lectura, 2 = escritura/modificación, 3 = analíticas, 5 = texto con IA, 8 = imagen con IA, 10 = acciones compuestas con IA). Usa `list_mcp_tools` para obtener la lista actualizada con el coste en créditos de cada herramienta, y `get_mcp_usage` para consultar tus créditos MCP restantes.

> **Publicaciones (11 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_posts` | Lista las publicaciones programadas/publicadas con filtro por estado y plataforma |
> | `get_post` | Obtiene una publicación por ID |
> | `create_post` | Crea una publicación nueva dirigida a cualquier plataforma conectada |
> | `update_post` | Actualiza el contenido o la programación de una publicación existente |
> | `schedule_post` | Programa una publicación existente para publicarla en el futuro |
> | `unschedule_post` | Quita una publicación de la programación (vuelve a pendiente) |
> | `delete_post` | Elimina una publicación |
> | `retry_post` | Reintenta una publicación fallida (cambia el estado de FAILED a PENDING) |
> | `resubmit_post` | Reenvía a aprobación una publicación rechazada |
> | `bulk_delete_posts` | Elimina varias publicaciones a la vez |
> | `get_calendar_posts` | Obtiene las publicaciones de un rango de fechas (vista de calendario) |

> **Comentarios de publicaciones (5 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_post_comments` | Lista los comentarios de una publicación |
> | `add_post_comment` | Añade un comentario a una publicación |
> | `update_post_comment` | Actualiza un comentario existente de una publicación |
> | `delete_post_comment` | Elimina un comentario de una publicación |
> | `mark_comments_as_read` | Marca como leídos todos los comentarios de una publicación |

> **Borradores (6 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_drafts` | Lista los borradores de tu espacio de trabajo |
> | `get_draft` | Obtiene un borrador por ID |
> | `create_draft` | Crea un borrador nuevo |
> | `update_draft` | Actualiza un borrador existente |
> | `delete_draft` | Elimina un borrador |
> | `convert_draft` | Convierte un borrador en una publicación programada |

> **Cuentas (3 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_accounts` | Lista las cuentas de redes sociales conectadas |
> | `get_account` | Obtiene los detalles de una cuenta social conectada |
> | `disconnect_account` | Desconecta (elimina) una cuenta social conectada |

> **Medios (13 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_media` | Lista los archivos multimedia de tu biblioteca |
> | `search_media` | Busca archivos multimedia por nombre |
> | `get_media_file` | Obtiene un archivo multimedia por ID |
> | `delete_media` | Elimina un archivo multimedia de la biblioteca |
> | `bulk_delete_media` | Elimina varios archivos multimedia a la vez |
> | `list_media_folders` | Lista las carpetas de medios de la biblioteca |
> | `create_media_folder` | Crea una carpeta de medios nueva |
> | `delete_media_folder` | Elimina una carpeta de medios (y su contenido) |
> | `move_media_file` | Mueve un archivo multimedia a otra carpeta o a la raíz |
> | `move_media_folder` | Mueve una carpeta a otro elemento padre o a la raíz |
> | `rename_media_file` | Renombra un archivo multimedia |
> | `rename_media_folder` | Renombra una carpeta de medios |
> | `presign_media_upload` | Genera URL PUT prefirmadas de S3 para subir archivos a la biblioteca |

> **Bandeja de entrada (18 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_conversations` | Lista las conversaciones de la bandeja de entrada de todas las plataformas conectadas |
> | `get_messages` | Obtiene los mensajes de un hilo de conversación |
> | `reply_to_conversation` | Publica una respuesta de seguimiento en un hilo de conversación |
> | `update_conversation` | Actualiza el estado de la conversación (marcar como leída/vista, resuelta, etc.) |
> | `delete_conversation` | Elimina un hilo de conversación |
> | `list_saved_replies` | Lista las plantillas de respuestas guardadas |
> | `get_saved_reply` | Obtiene una respuesta guardada por ID |
> | `create_saved_reply` | Crea una plantilla de respuesta guardada nueva |
> | `update_saved_reply` | Actualiza una respuesta guardada existente |
> | `delete_saved_reply` | Elimina una respuesta guardada |
> | `subscribe_inbox` | Activa la sincronización de la bandeja de entrada para una cuenta social conectada |
> | `unsubscribe_inbox` | Desactiva la sincronización de la bandeja de entrada para una cuenta social conectada |
> | `edit_inbox_message` | Edita un comentario/mensaje en la bandeja de entrada social (Facebook/Instagram) |
> | `delete_inbox_message` | Elimina un comentario/mensaje en la bandeja de entrada social (Facebook/Instagram) |
> | `hide_inbox_message` | Oculta o muestra un comentario en la bandeja de entrada social (Facebook/Instagram) |
> | `preview_bulk_reply` | Previsualiza los destinatarios de una respuesta masiva antes de enviarla |
> | `create_bulk_reply` | Envía una respuesta (con personalización opcional `{{name}}`) a muchas conversaciones de mensajes directos |
> | `get_bulk_reply_batch` | Obtiene el estado y los resultados de un lote de respuestas masivas |

> **Aprobaciones (4 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_approvals` | Lista las publicaciones pendientes de aprobación |
> | `approve_post` | Aprueba una publicación pendiente de aprobación |
> | `reject_post` | Rechaza una publicación pendiente de aprobación (el comentario de rechazo es obligatorio) |
> | `update_review_comment` | Actualiza el comentario de revisión/rechazo de una publicación en el flujo de aprobación |

> **Equipos (6 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_team_members` | Lista todos los miembros del equipo de tu espacio de trabajo |
> | `invite_team_member` | Invita a un nuevo miembro al espacio de trabajo |
> | `remove_team_member` | Elimina a un miembro del espacio de trabajo |
> | `update_member_role` | Actualiza el rol de un miembro del equipo |
> | `list_team_invitations` | Lista las invitaciones de equipo pendientes |
> | `cancel_team_invitation` | Cancela una invitación de equipo pendiente |

> **Biolinks (19 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_biolinks` | Lista todas las páginas de biolink |
> | `get_biolink` | Obtiene los detalles de una página de biolink |
> | `create_biolink` | Crea una página de biolink nueva |
> | `update_biolink` | Actualiza una página de biolink existente |
> | `delete_biolink` | Elimina una página de biolink |
> | `publish_biolink` | Alterna el estado de publicación de un biolink |
> | `change_biolink_theme` | Cambia un biolink a un tema predefinido |
> | `set_biolink_custom_theme` | Aplica colores de tema personalizados a un biolink |
> | `list_biolink_buttons` | Lista los botones de una página de biolink |
> | `create_biolink_button` | Añade un botón a una página de biolink |
> | `update_biolink_button` | Actualiza un botón de una página de biolink |
> | `delete_biolink_button` | Elimina un botón de una página de biolink |
> | `reorder_biolink_buttons` | Reordena los botones de una página de biolink |
> | `list_biolink_posts` | Lista las publicaciones de galería de una página de biolink |
> | `create_biolink_post` | Añade una publicación de galería a un biolink |
> | `update_biolink_post` | Actualiza una publicación de galería de un biolink |
> | `delete_biolink_post` | Elimina una publicación de galería de un biolink |
> | `reorder_biolink_posts` | Reordena las publicaciones de galería de un biolink |
> | `get_biolink_analytics` | Obtiene las analíticas de una página de biolink (vistas, clics) |

> **Contenido con IA (10 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `generate_caption` | Genera un texto con IA para una plataforma y un tono concretos |
> | `generate_content` | Genera o reescribe texto con IA de cualquier tipo (publicación, descripción, hashtag, titular, biografía, hilo, correo, etc.) |
> | `generate_image` | Genera una imagen con IA a partir de un prompt de texto |
> | `generate_and_schedule` | Genera contenido con IA, crea una publicación y la programa en una sola llamada |
> | `get_ai_history` | Obtiene el historial de prompts de generación con IA |
> | `get_ai_credits` | Obtiene los saldos y límites de créditos de IA (texto, imagen, vídeo UGC) del plan actual |
> | `list_ai_image_providers` | Lista los proveedores de generación de imágenes con IA permitidos por el plan actual |
> | `list_generated_images` | Lista las imágenes generadas con IA con paginación |
> | `get_generated_image` | Obtiene los detalles de una imagen generada con IA por ID |
> | `delete_generated_image` | Elimina una imagen generada con IA |

> **Vídeo con IA / UGC (9 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `generate_video` | Genera un vídeo UGC con IA a partir de un texto gancho + avatar |
> | `list_videos` | Lista los vídeos UGC generados |
> | `get_video` | Obtiene un vídeo generado por ID (incluye el estado de generación) |
> | `delete_video` | Elimina un vídeo generado |
> | `list_avatars` | Lista los avatares UGC disponibles para la generación de vídeo |
> | `list_sounds` | Lista los sonidos/músicas disponibles para la generación de vídeo |
> | `get_sound_genres` | Lista los géneros de sonido de fondo disponibles para vídeos UGC |
> | `generate_hook_suggestions` | Genera sugerencias de gancho/guion con IA para vídeos UGC |
> | `list_ai_video_providers` | Lista los proveedores de vídeo UGC con IA permitidos por el plan actual |

> **Analíticas (26 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `get_analytics_summary` | Obtiene las analíticas del espacio de trabajo: número de publicaciones por estado y plataforma |
> | `get_platform_analytics` | Obtiene analíticas detalladas de una cuenta social conectada concreta |
> | `get_post_analytics` | Obtiene las analíticas de una publicación concreta |
> | `get_facebook_analytics` | Obtiene las analíticas a nivel de página de Facebook |
> | `get_facebook_posts_analytics` | Obtiene las analíticas de página de Facebook por publicación |
> | `get_facebook_videos_analytics` | Obtiene las analíticas de página de Facebook por vídeo |
> | `get_instagram_analytics` | Obtiene las analíticas a nivel de cuenta de Instagram |
> | `get_instagram_media_analytics` | Obtiene las analíticas de medios de Instagram por publicación |
> | `get_instagram_stories_analytics` | Obtiene las analíticas de las historias de Instagram |
> | `get_linkedin_analytics` | Obtiene las analíticas a nivel de página de LinkedIn |
> | `get_linkedin_posts_analytics` | Obtiene las analíticas de página de LinkedIn por publicación |
> | `get_youtube_analytics` | Obtiene las analíticas a nivel de canal de YouTube |
> | `get_youtube_videos_analytics` | Obtiene las analíticas del canal de YouTube por vídeo |
> | `get_twitter_analytics` | Obtiene las analíticas a nivel de cuenta de Twitter/X |
> | `get_twitter_content_analytics` | Obtiene las analíticas a nivel de contenido de Twitter/X |
> | `get_tiktok_analytics` | Obtiene las analíticas de la cuenta de TikTok |
> | `get_whatsapp_analytics` | Obtiene las analíticas de la cuenta de WhatsApp Business |
> | `get_bluesky_analytics` | Obtiene las analíticas de la cuenta de Bluesky |
> | `get_mastodon_analytics` | Obtiene las analíticas de la cuenta de Mastodon |
> | `get_reddit_account_analytics` | Obtiene las analíticas a nivel de cuenta de Reddit |
> | `get_reddit_submissions_analytics` | Obtiene las analíticas de los envíos (publicaciones) de Reddit |
> | `get_pinterest_analytics` | Obtiene las analíticas de la cuenta de Pinterest |
> | `get_pinterest_pins_analytics` | Obtiene las analíticas de Pinterest por pin |
> | `get_pinterest_top_pins_analytics` | Obtiene los pines de Pinterest con mejor rendimiento |
> | `get_pinterest_top_video_pins_analytics` | Obtiene los pines de vídeo de Pinterest con mejor rendimiento |
> | `get_gmb_analytics` | Obtiene las analíticas de una ubicación de Google Business Profile (GMB) |

> **Mejor momento para publicar (3 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `get_best_time_recommendations` | Lista las recomendaciones del mejor momento para publicar de todas las cuentas conectadas del espacio de trabajo |
> | `get_best_time_recommendation` | Obtiene la recomendación del mejor momento (mapa de calor + mejores franjas) de una sola cuenta |
> | `recompute_best_time_recommendation` | Recalcula la recomendación del mejor momento de una cuenta a partir del historial reciente de interacción |

> **Plantillas (3 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_templates` | Lista las plantillas de contenido disponibles por categoría |
> | `get_template` | Obtiene una plantilla por ID |
> | `render_template` | Genera una plantilla con los valores de campo proporcionados |

> **Conocimiento (RAG) (6 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_knowledge` | Lista los documentos de conocimiento que usa el asistente de IA (RAG) |
> | `get_knowledge` | Obtiene un documento de conocimiento con el texto extraído y los metadatos |
> | `create_knowledge` | Crea un documento de conocimiento a partir de un archivo subido o una nota escrita |
> | `update_knowledge` | Actualiza los metadatos o el cuerpo de la nota de un documento de conocimiento |
> | `reprocess_knowledge` | Reintenta la extracción de un documento de conocimiento PDF/imagen/texto que falló |
> | `delete_knowledge` | Elimina un documento de conocimiento |

> **Canva (4 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `get_canva_status` | Comprueba si Canva está conectado para el usuario autenticado |
> | `list_canva_designs` | Lista los diseños de Canva del usuario (paginado, con búsqueda) |
> | `export_canva_design` | Exporta un diseño de Canva a una imagen (asíncrono; devuelve un id de trabajo de exportación) |
> | `get_canva_export_status` | Consulta el estado de un trabajo de exportación de un diseño de Canva |

> **Ayuda y soporte (5 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `create_ticket` | Crea un ticket de soporte |
> | `list_tickets` | Lista tus tickets de soporte |
> | `get_ticket` | Obtiene un ticket de soporte con detalles |
> | `send_ticket_message` | Envía un mensaje en un ticket de soporte |
> | `list_ticket_messages` | Lista todos los mensajes de un ticket de soporte |

> **Notificaciones (5 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_notifications` | Lista las notificaciones dentro de la app del usuario autenticado |
> | `get_unread_notification_count` | Obtiene el número de notificaciones sin leer, opcionalmente por categoría |
> | `mark_notification_read` | Marca una notificación como leída |
> | `mark_all_notifications_read` | Marca todas las notificaciones (opcionalmente dentro de una categoría) como leídas |
> | `archive_notification` | Archiva (descarta) una notificación |

> **Ajustes y cuenta (9 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `get_profile` | Obtiene tu perfil de usuario |
> | `update_profile` | Actualiza el perfil del usuario autenticado (nombre, contraseña, correo) |
> | `get_organization` | Obtiene los detalles del espacio de trabajo/organización |
> | `update_organization` | Actualiza el espacio de trabajo actual (nombre, descripción, color, zona horaria) |
> | `get_usage` | Obtiene el desglose de uso del periodo de facturación actual |
> | `get_user_preferences` | Obtiene las preferencias del usuario autenticado (ajustes de notificaciones, zona horaria, preferencias de la interfaz) |
> | `update_user_preferences` | Actualiza (fusiona) las preferencias del usuario autenticado |
> | `get_current_tenant` | Obtiene los detalles del espacio de trabajo (tenant) activo |
> | `get_billing` | Obtiene la información de suscripción y facturación |

> **Planes y facturación (4 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `get_plans` | Obtiene el catálogo de planes con precios y visibilidad |
> | `get_plan_features` | Obtiene la matriz de funciones de un plan concreto |
> | `get_subscription` | Obtiene el estado de la suscripción actual del espacio de trabajo, su plan y sus límites |
> | `list_invoices` | Lista las facturas de la suscripción actual |

> **Claves de API (3 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_api_keys` | Lista las claves de API activas del espacio de trabajo actual |
> | `create_api_key` | Crea una clave de API nueva (la clave completa se devuelve solo una vez) |
> | `revoke_api_key` | Revoca una clave de API |

> **Espacios de trabajo / Tenants (4 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_tenants` | Lista los espacios de trabajo/tenants a los que pertenece el usuario autenticado |
> | `create_tenant` | Crea un espacio de trabajo nuevo propiedad del usuario autenticado |
> | `delete_tenant` | Elimina un espacio de trabajo |
> | `leave_tenant` | Abandona un espacio de trabajo del que el usuario es miembro |

> **Referidos (2 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `get_referral_code` | Obtiene el código de referido del usuario autenticado |
> | `get_referral_stats` | Obtiene el código de referido, el número de referidos, los créditos ganados y la URL para compartir |

> **Introspección de MCP (2 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `get_mcp_usage` | Obtiene el uso de créditos MCP de este espacio de trabajo, sus límites y el desglose por herramienta del periodo actual |
> | `list_mcp_tools` | Lista todas las herramientas MCP disponibles y su coste en créditos |

> **WhatsApp (6 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_whatsapp_templates` | Lista las plantillas de mensajes de WhatsApp Business |
> | `get_whatsapp_template` | Obtiene una plantilla de mensajes de WhatsApp por nombre |
> | `create_whatsapp_template` | Crea (envía a aprobación de Meta) una plantilla de mensajes de WhatsApp |
> | `delete_whatsapp_template` | Elimina una plantilla de mensajes de WhatsApp |
> | `send_whatsapp_template` | Envía un mensaje de plantilla de WhatsApp a un destinatario |
> | `upload_whatsapp_template_media` | Sube el medio de cabecera (imagen/vídeo/documento) de una plantilla |

> **Webhooks (10 herramientas)**
>
> | Herramienta | Descripción |
> | - | - |
> | `list_webhook_subscriptions` | Lista las suscripciones de webhook |
> | `get_webhook_subscription` | Obtiene una suscripción de webhook por ID |
> | `create_webhook_subscription` | Crea una suscripción de webhook para categorías de eventos |
> | `update_webhook_subscription` | Actualiza una suscripción de webhook (URL, categorías, estado activo, regenerar secreto) |
> | `delete_webhook_subscription` | Elimina una suscripción de webhook |
> | `test_webhook_subscription` | Envía un ping de prueba a una suscripción de webhook |
> | `list_webhook_deliveries` | Lista los registros de entrega de webhooks con filtros opcionales |
> | `get_webhook_delivery` | Obtiene un registro de entrega de webhook con el payload completo y el estado |
> | `retry_webhook_delivery` | Reintenta una entrega de webhook fallida |
> | `list_webhook_events` | Lista todos los tipos de eventos de webhook disponibles por categoría |

> **Ayudas de integración (9 herramientas)**
>
> Estas herramientas resuelven los destinos de publicación específicos de cada plataforma (tableros, subreddits, canales, ubicaciones) para que puedas elegir un destino antes de crear una publicación.
>
> | Herramienta | Descripción |
> | - | - |
> | `list_pinterest_boards` | Lista los tableros de Pinterest de una cuenta (selecciona un tablero antes de publicar) |
> | `create_pinterest_board` | Crea un tablero de Pinterest nuevo |
> | `list_reddit_subreddits` | Lista los subreddits de los que es miembro la cuenta de Reddit conectada |
> | `list_reddit_flairs` | Lista los flairs de publicación disponibles de un subreddit |
> | `list_gmb_locations` | Lista las ubicaciones de Google Business Profile (GMB) de una cuenta |
> | `list_discord_channels` | Lista los canales de Discord disponibles para una cuenta en modo bot |
> | `list_slack_channels` | Lista los canales de Slack de un espacio de trabajo conectado |
> | `list_telegram_chats` | Lista los chats/grupos de Telegram disponibles para una cuenta |
> | `get_tiktok_creator_info` | Obtiene la información de creador/cuenta de TikTok (valida las capacidades de publicación) |

## Plataformas admitidas

El enum `socialMedia` / `platform` que usan las herramientas de publicación y de contenido con IA (`create_post`, `create_draft`, `generate_caption`, `generate_and_schedule`, `generate_hook_suggestions`, etc.) acepta estos valores:

| Plataforma | Valor del enum |
| - | - |
| Twitter / X | `TWITTER` |
| Instagram | `INSTAGRAM` |
| LinkedIn | `LINKEDIN` |
| LinkedIn Page | `LINKEDIN_PAGE` |
| Facebook | `FACEBOOK` |
| TikTok | `TIKTOK` |
| YouTube | `YOUTUBE` |
| Threads | `THREADS` |
| WhatsApp | `WHATSAPP` |
| Dribbble | `DRIBBBLE` |
| Pinterest | `PINTEREST` |

> [!NOTE]
>
> Las herramientas de analíticas y de ayudas de integración cubren más destinos que el enum de publicaciones anterior, incluidos Bluesky, Mastodon, Reddit, Google Business Profile (GMB), Discord, Slack y Telegram. Usa `list_accounts` para descubrir todas las cuentas conectadas y su `accountId`, y pasa ese id a las herramientas de analíticas o ayudas de integración específicas de cada plataforma.

## Tipos de publicación

El parámetro `postType` de `create_post`, `update_post`, `create_draft` y `update_draft` acepta: `TEXT`, `IMAGE`, `MULTIPLE_IMAGES`, `VIDEO`, `CAROUSEL`, `REEL`, `STORY` (por defecto: `TEXT`).

## Estados de publicación

El filtro `status` de `list_posts` acepta: `POSTED`, `SCHEDULED`, `PENDING`, `FAILED`, `PENDING_APPROVAL`, `REJECTED`.

## Ejemplos de solicitudes

El servidor MCP habla JSON-RPC 2.0 sobre Streamable HTTP. La mayoría de los agentes se encargan de esto por ti, pero puedes llamarlo directamente con `curl`.

```bash Listar herramientas theme={null}
curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'
```

```bash Crear una publicación programada theme={null}
curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "create_post",
      "arguments": {
        "text": "Big news coming Friday!",
        "socialMedia": "TWITTER",
        "postType": "TEXT",
        "scheduledAt": "2026-06-20T15:00:00.000Z"
      }
    }
  }'
```

```bash Generar y programar en una sola llamada theme={null}
curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "generate_and_schedule",
      "arguments": {
        "platform": "LINKEDIN",
        "socialMedia": "LINKEDIN",
        "topic": "Why async standups beat daily meetings",
        "tone": "professional",
        "scheduledAt": "2026-06-21T09:00:00.000Z"
      }
    }
  }'
```

## Guías de configuración

Elige tu agente de IA para empezar:

> **[Claude Code](/es/mcp/claude-code.md)**
>
> La herramienta de programación agéntica de Anthropic

> **[Claude Desktop](/es/mcp/claude-desktop.md)**
>
> La aplicación de escritorio de Anthropic

> **[Cursor](/es/mcp/cursor.md)**
>
> Editor de código orientado a la IA

> **[OpenAI Codex](/es/mcp/codex.md)**
>
> El agente de programación de OpenAI

> **[Windsurf](/es/mcp/windsurf.md)**
>
> IDE con IA de Codeium

> **[VS Code (Copilot)](/es/mcp/vscode.md)**
>
> Modo agente de GitHub Copilot

> **[Gemini CLI](/es/mcp/gemini-cli.md)**
>
> El agente de terminal con IA de Google

## Solución de problemas

> **401 Unauthorized**
>
> Comprueba que tu clave de API es correcta y está activa. El encabezado debe ser exactamente `X-API-Key` (distingue mayúsculas). Genera una clave nueva en **Ajustes > Acceso a la API** si es necesario.

> **405 Method Not Allowed en GET/SSE**
>
> El servidor MCP de Social media studio funciona sin estado mediante Streamable HTTP. Solo se admiten solicitudes POST. Asegúrate de que tu agente está configurado con transporte HTTP, no SSE.

> **Límite de solicitudes superado**
>
> Las llamadas a herramientas MCP tienen un límite por minuto según el plan. Consulta tu uso en **Ajustes > MCP** y mejora tu plan si es necesario.

> **Créditos agotados**
>
> Cada llamada a una herramienta MCP consume créditos. Consulta los créditos restantes en **Ajustes > MCP**.

> **Tiempo de conexión agotado**
>
> Aumenta el tiempo de espera en tu configuración de MCP. Se recomienda un valor de 30000 ms (30 segundos).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.