MCP App Store
by KeenEthics
EmbedSocial icon

EmbedSocial MCP Server for ChatGPT

By EmbedSocial

Overview

Connect your existing EmbedSocial account to explore its collected social posts and media. Find posts by keyword, source and date; view widget media and individual media details; and summarize widget click counts for a date range. This app provides read-only access. Available data and analytics depend on your account permissions and plan. Click counts do not measure unique visitors, sales or conversions.

How to connect

  1. ChatGPT: Open the EmbedSocial listing in the ChatGPT app directory and choose Connect. ChatGPT listing EmbedSocial exposes 5 tools here.

Tools

social_feed_get_single_media

ChatGPT
Get a single social-feed media item by its media_id for the authenticated EmbedSocial user. Returns the same response as GET /v2/api/social-feed/media/{mediaId}. Required: media_id (the id of the media, as returned by social_feed_hashtag_album_get_media in the data[].media_id field). The EmbedSocial MCP proxy injects api_key automatically — do not send it from the client. Tool expects valid stringified JSON object with 2 properties. Property names with description, type and required status: media_id: (description: The id of the social-feed media item, e.g. 11222333445567 (returned as data[].media_id from social_feed_hashtag_album_get_media)., type: string, required: true), api_key: (description: EmbedSocial user API key (injected by the Symfony MCP proxy as api_key in tools/call arguments), type: string, required: true) ALL parameters marked as required must be provided

social_feed_hashtag_album_get_media

ChatGPT
Fetch hashtag-album media (also known as widget media or album media) for the authenticated EmbedSocial user. Returns the same response as GET /v2/api/social-feed/hashtag-album/media. Required: album_ref (hashtag album / widget ref, e.g. 1979b2dae50abb12b6956659bbbe69c46a05a925). Optional: page (default 1), per_page (default 100, max 200), begin_time (ISO 8601), end_time (ISO 8601), filter_keyword (URL-encode special chars like ',', '+', '-', '#'). The EmbedSocial MCP proxy injects api_key automatically — do not send it from the client. Tool expects valid stringified JSON object with 7 properties. Property names with description, type and required status: album_ref: (description: , type: string, required: true), page: (description: , type: string, required: false), per_page: (description: , type: string, required: false), begin_time: (description: , type: string, required: false), end_time: (description: , type: string, required: false), filter_keyword: (description: , type: string, required: false), api_key: (description: EmbedSocial user API key (injected by the Symfony MCP proxy as api_key in tools/call arguments), type: string, required: true) ALL parameters marked as required must be provided

socialfeed_items_query_api

ChatGPT
Query social-feed post items (UGC posts) for the authenticated EmbedSocial user, with filters and cursor pagination. Returns the same response as POST /v2/api/social-feed/items/query: { data: [...], nextPageToken, previousPageToken, totalCount }. Each item includes rating (integer 1-5 star rating; null for items without one, such as regular posts). Results are always posts (itemType is fixed server-side). All parameters are optional. IMPORTANT: if periodStart/periodEnd are omitted the API only returns the last 7 days — pass an early periodStart (e.g. 2015-01-01) to search all time. - searchString: keyword search in the post content - page (default 1), pageSize (default 10, max 100) - searchAfter / searchBefore: cursor tokens from a previous response (nextPageToken / previousPageToken) - periodStart / periodEnd: Y-m-d - sourceType: JSON array as a string, e.g. ["instagram","tiktok"] - sourceSubtype: JSON array as a string, e.g. ["hashtag"] - sourceOriginalId: JSON array of source original ids, as a string - orderBy: JSON object as a string with exactly ONE field of originalCreatedOn|likes|comments|shares|globalModerationStatus mapped to asc|desc, e.g. {"originalCreatedOn":"desc"} - minAiScore: integer 0-100 - rightsApproveStatus: Pending|Approved|Declined|Unrequested The EmbedSocial MCP proxy injects api_key automatically — do not send it from the client. Tool expects valid stringified JSON object with 14 properties. Property names with description, type and required status: api_key: (description: EmbedSocial user API key (injected by the Symfony MCP proxy as api_key in tools/call arguments), type: string, required: true), searchString: (description: , type: string, required: false), page: (description: , type: string, required: false), pageSize: (description: , type: string, required: false), searchAfter: (description: , type: string, required: false), searchBefore: (description: , type: string, required: false), periodStart: (description: , type: string, required: false), periodEnd: (description: , type: string, required: false), sourceType: (description: , type: string, required: false), sourceSubtype: (description: , type: string, required: false), sourceOriginalId: (description: , type: string, required: false), orderBy: (description: , type: string, required: false), minAiScore: (description: , type: string, required: false), rightsApproveStatus: (description: , type: string, required: false) ALL parameters marked as required must be provided

socialfeed_widgets_list

ChatGPT
List the Social Feed widgets owned by the authenticated EmbedSocial user. Returns the same response as GET /v2/api/social-feed/widgets: widget names with their widgetRef (or albumRef for legacy widgets), widget type, and connected-source metadata where available, sorted by date. Optional: widgetType — manually_configured or ai_generated. If omitted, all widgets are returned, including legacy widgets. Legacy widgets are left out when widgetType is ai_generated. Use this tool to find a widget before calling social_feed_hashtag_album_get_media (pass the ref as album_ref) or widget_analytics_get_metrics (pass it as widgetRef). This operation is read-only. Authentication is handled by the connected account; callers must not supply an API key. Tool expects valid stringified JSON object with 2 properties. Property names with description, type and required status: widgetType: (description: , type: string, required: false), api_key: (description: EmbedSocial user API key (injected by the Symfony MCP proxy as api_key in tools/call arguments), type: string, required: true) ALL parameters marked as required must be provided

widget_analytics_get_metrics

ChatGPT
Fetch widget analytics (post/icon/lightbox/CTA click occurrences, periodic and total) for a widget owned by the authenticated EmbedSocial user. Returns the same response as GET /v2/api/widget-analytics. Optional: widgetRef (the widget data-ref; if omitted the API may aggregate across the account), period (e.g. last_7_days, last_30_days, last_90_days, custom), from (ISO date, required when period=custom), to (ISO date, required when period=custom). The EmbedSocial MCP proxy injects api_key automatically — do not send it from the client. Tool expects valid stringified JSON object with 5 properties. Property names with description, type and required status: widgetRef: (description: , type: string, required: false), period: (description: , type: string, required: false), from: (description: , type: string, required: false), to: (description: , type: string, required: false), api_key: (description: EmbedSocial user API key (injected by the Symfony MCP proxy as api_key in tools/call arguments), type: string, required: true) ALL parameters marked as required must be provided

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/embedsocial"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/embedsocial)