PostPickr MCP server
Yes. PostPickr publishes an official MCP server at https://mcp.postpickr.com/mcp. It's hosted. It offers 76 tools. We last checked it on 22 Nov 2026.
Official: answers MCP requests at mcp.postpickr.com, on PostPickr's own domain postpickr.com. Checked 22 Nov 2026. Maintained by Stuart Brameld.
Key facts
As of 22 Nov 2026, PostPickr's official MCP server scores 64/100 (provisional) on MartechDB's Agent Readiness Index (v1.1). It answered 55 of our 55 checks in the last 90 days and lists 76 tools.
How the Agent Readiness Index works · Wrong? Suggest a correction
PostPickr MCP server review
64/100
PostPickr's MCP server scores 64/100 on MartechDB's Agent Readiness Index: easy to connect an AI agent to, with a few gaps.
The good
Hosted by PostPickr: connect by URL, with nothing to install
Answered 100% of our checks in the last 90 days
Free trial
No card needed to start
The bad
Nothing we've found.
Not checked yet: how you sign in; a docs page listing its tools. Anything not checked scores nothing.
Official MCP server
PostPickr MCP server
- Address
- https://mcp.postpickr.com/mcp
- Runs
- Hosted
- Sign-in
- Cost to use
- Plan: Professional · Free trial · No card neededFrom PostPickr's own page
- Official MCP Registry
- Not listed
- How we know it's official
-
- Answers MCP requests at mcp.postpickr.com, on PostPickr's own domain postpickr.com.
- Tools
- 76 tools · listed 6 Oct 2026
- First seen
- 1 Oct 2026
- Last checked
-
Reachable ·
16 Nov 2026: reachable17 Nov 2026: reachable18 Nov 2026: reachable19 Nov 2026: reachable20 Nov 2026: reachable21 Nov 2026: reachable22 Nov 2026: reachable
- Uptime
- 100% · 55 of 55 checks reachable since 1 Oct 2026
PostPickr MCP server tools (76)
As the server lists them. Names and descriptions are the vendor's own.
-
get_linkedin_posts_analyticsGet LinkedIn Posts AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. USE THIS TOOL when the user asks for analytics, statistics, metrics, performance, engagement, or post insights (views, likes, comments, shares, impressions, reach, clicks, saves, etc.). Examples: "show me the analytics", "post statistics", "how are the posts performing", "which post has the most engagement", "content performance", "post metrics". CONTENT ANALYSIS — If the user instead wants to analyze topics, tone of voice, editorial themes, or posting frequency (NOT metrics), use get_channel_posts_for_content_analysis() instead. DATE RANGE — This tool fetches ALL posts in the given period in a single request. Always call it with the full date range requested by the user — do NOT split proactively. Do NOT make a preliminary "test" call with a short date range before the real call. Only if the call times out: inform the user and retry spl…
-
get_linkedin_followers_analyticsGet LinkedIn Followers AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks about LinkedIn PAGE (company/organization) follower growth, follower trend over time, or follower demographics (seniority, industry, function, company size). Examples: "come sono cresciuti i follower della pagina LinkedIn?", "follower growth last month", "chi sono i miei follower per settore/seniority?". - For a LinkedIn PERSONAL PROFILE instead, use get_linkedin_profile_followers(). - For page VISITS/page views (not followers), use get_linkedin_visitors_analytics(). - For post/content engagement metrics, use get_linkedin_posts_analytics() (page) or get_linkedin_profile_posts_analytics() (personal profile). - Do NOT use this tool just to get the current total follower count — get_linkedin_audience_info() already returns it directly and cheaper. Get LinkedIn page followers analytics. RESPONSE SHAPE —…
-
get_linkedin_visitors_analyticsGet LinkedIn Visitors AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks about visits/views to the LinkedIn PAGE (company/organization) itself, e.g. "quante visite ha ricevuto la pagina LinkedIn?", "page views", "unique visitors", "da dove arrivano le visite alla pagina" (mobile/desktop breakdown, if present in totalPageStatistics). - This is about VIEWS OF THE PAGE, not about post/content engagement and not about follower counts — for those use get_linkedin_content_statistics() or get_linkedin_followers_analytics() respectively. - There is no equivalent "visitors" tool for LinkedIn personal profiles — profile view counts are part of get_linkedin_profile_statistics() instead. Get LinkedIn page visitors analytics. Returns page views and unique visitors data. start_date/end_date always scope the query — there is no "lifetime" mode for this tool (unlike get_linkedin_followe…
-
get_linkedin_content_statisticsGet LinkedIn Content StatisticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks for an AGGREGATE daily trend of content/engagement across ALL shares on the LinkedIn page (e.g. "come sono andate le condivisioni questo mese, giorno per giorno?", "daily engagement trend"), not a breakdown per individual post. - If the user instead wants metrics PER POST (e.g. "which post has the most engagement", "post statistics", "how are the posts performing"), use get_linkedin_posts_analytics() (page) or get_linkedin_profile_posts_analytics() (personal profile) instead — those return one entry per post, this tool returns one entry per day aggregated across all posts. Get LinkedIn page content/share statistics by day. Returns daily content engagement metrics (shares/reactions/etc. per day). NOTE: All analytics dates and times are shown in UTC timezone. RESPONSE SHAPE — unlike get_linkedin_follo…
-
get_linkedin_profile_posts_analyticsGet LinkedIn Profile Posts AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. USE THIS TOOL when the user asks for analytics, statistics, metrics, performance, engagement, or post insights (impressions, likes, comments, shares, clicks, etc.) for a LinkedIn personal profile. Examples: "show me the analytics", "post statistics", "how are the posts performing", "which post has the most engagement", "content performance", "post metrics". CONTENT ANALYSIS — If the user instead wants to analyze topics, tone of voice, editorial themes, or posting frequency (NOT metrics), use get_channel_posts_for_content_analysis() instead. DATE RANGE — This tool fetches ALL posts in the given period in a single request. Always call it with the full date range requested by the user — do NOT split proactively. Do NOT make a preliminary "test" call with a short date range before the real call. Only if the call times out: inform the user an…
-
get_linkedin_profile_statisticsGet LinkedIn Profile StatisticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks for LinkedIn personal-profile post engagement metrics aggregated over a period: impressions, reshares, reactions, comments, or members reached (e.g. "quante impression hanno avuto i miei post questo mese?", "engagement totale del profilo", "trend giornaliero delle reaction"). This does NOT include profile page-view counts — LinkedIn's member API used here does not expose that metric. - For a per-post breakdown instead of an aggregate/trend, use get_linkedin_profile_posts_analytics(). - For follower count/growth, use get_linkedin_profile_followers() instead. Get LinkedIn personal profile post-engagement statistics. NOTE: All analytics dates and times are shown in UTC timezone. METRICS — returns up to 5 metrics, each only present if LinkedIn had data for it: IMPRESSION, RESHARE, REACTION, COMMENT, MEM…
-
get_linkedin_profile_followersGet LinkedIn Profile FollowersIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks how the LinkedIn personal profile's follower count has changed day by day over a period (e.g. "come sono cresciuti i miei follower questo mese?", "follower trend", "quanti follower avevo il giorno X?"). - For a LinkedIn PAGE (company/organization) instead, use get_linkedin_followers_analytics(). - For the current total follower count only (no trend), use get_linkedin_audience_info() instead — cheaper, no date range needed. Get LinkedIn personal profile followers per day. NOTE: All analytics dates and times are shown in UTC timezone. A date range (start_date/end_date) is always required — there is no lifetime mode for this tool. RESPONSE SHAPE — `data` is a flat list of [date, count] pairs, one per calendar day in the requested range, e.g. [["01/06/2026", 1204], ["02/06/2026", 1210], ...]. IMPORTANT:…
-
get_facebook_reels_analyticsGet Facebook Reels AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. USE THIS TOOL when the user asks for analytics, statistics, metrics, performance, engagement, or reel insights (views, likes, avg watch time, impressions, play count, etc.). Examples: "reel analytics", "reel statistics", "reel performance", "show me the reel metrics". CONTENT ANALYSIS — If the user instead wants to analyze topics, tone of voice, editorial themes, or posting frequency (NOT metrics), use get_channel_posts_for_content_analysis() instead. Get Facebook Reels insights: views, likes, avg watch time, unique impressions and play count for each Reel published on the Facebook page. NOTE: Max period 90 days. Insights use Pacific timezone. Some metrics may not include today's data. Mirrors the frontend "Analisi Reel" section (audience/facebook/reels). Each call fetches exactly ONE page (~25 reels). Present the results to the user, th…
-
get_facebook_welcome_dataGet Facebook Page Welcome DataIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user wants a quick multi-metric OVERVIEW of the page combining media views, follow/unfollow activity, and post engagement in a single call (e.g. "dammi una panoramica della pagina Facebook", "overview generale della pagina"). - This is NOT a substitute for the more focused tools: for media-view breakdowns by ads/organic or followers/non-followers use get_facebook_page_views() instead; for fan/follower demographics and growth use get_facebook_fans_analytics() instead. Use this tool only when a combined snapshot across several metrics is what's needed. Get Facebook page overview/welcome data (insights/page_media_view, page_total_media_view_unique,page_follows,page_daily_follows_unique, page_daily_unfollows_unique,page_post_engagements/day). NOTE: Max period 90 days. Insights use Pacific timezone. Some metrics m…
-
get_facebook_fans_analyticsGet Facebook Fans AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks WHERE the Facebook page's followers/fans are located geographically — total count by country or by city (e.g. "da quali paesi arrivano i miei follower?", "quanti follower ho in Italia vs altri paesi?", "distribuzione geografica dei fan"). - This is a CUMULATIVE/LIFETIME total per location as of the most recent day in the requested range — NOT new follows gained during the period, NOT age/gender demographics (Facebook does not expose that breakdown here), and NOT engagement data. For new-follow COUNTS over time, use get_facebook_welcome_data() (page_follows/page_daily_follows_unique). For total current fan/like count (not broken down geographically), use get_facebook_audience_info(). Get Facebook page follows geographic breakdown (insights/page_follows_country,page_follows_city/day). NOTE: Max period…
-
get_facebook_page_viewsGet Facebook Page ViewsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks specifically about VIEWS OF MEDIA (photos/videos) posted on the Facebook page, and wants it split by paid-vs-organic traffic and/or by follower-vs-non-follower audience (e.g. "quante visualizzazioni hanno avuto i media della pagina?", "views da ads vs organiche", "quante view arrivano da chi non mi segue?"). - This is NOT general page traffic, profile visits, or a generic "unique visitors" metric — it is media-view counts only. - For post-level engagement (reactions, comments, shares), use get_facebook_posts_data() instead. - For follower/fan counts, use get_facebook_fans_analytics() instead. Get Facebook page media-view analytics (insights/page_media_view/day). NOTE: Max period 90 days. Insights use Pacific timezone. Some metrics may not include today's data. RESPONSE SHAPE — the response is a flat…
-
get_facebook_posts_dataGet Facebook Posts DataIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. USE THIS TOOL when the user asks for analytics, statistics, metrics, performance, engagement, or post insights (views, likes, comments, shares, impressions, reach, clicks, saves, etc.). Examples: "show me the analytics", "post statistics", "how are the posts performing", "which post has the most engagement", "content performance", "post metrics". CONTENT ANALYSIS — If the user instead wants to analyze topics, tone of voice, editorial themes, or posting frequency (NOT metrics), use get_channel_posts_for_content_analysis() instead. Get Facebook posts insights: reactions, comments, shares and engagement for each post published on the Facebook page. Includes ALL posts on the page — both published via PostPickr and posted natively or through other tools. NOTE: Max period 90 days. Insights use Pacific timezone. Some metrics may not include tod…
-
get_instagram_account_analyticsGet Instagram Account AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks for Instagram ACCOUNT-LEVEL reach or views over a date range, optionally broken down by content type (post/reel/story), organic vs sponsored, or follower vs non-follower audience (e.g. "quante persone ho raggiunto questo mese?", "reach organica vs a pagamento", "views sui reel rispetto ai post"). - The user asks for total ACCOUNTS ENGAGED, or follow/unfollow totals, for a date range. - This is NOT follower/fan demographics (age, gender, city, country) — use get_instagram_fans_analytics() instead. This is NOT post-level interaction details (likes, comments, shares, saves per post) — use get_instagram_interactions() instead. This is NOT the current follower count/identity snapshot — use get_instagram_audience_info() instead. Get Instagram account-level analytics (reach, views, accounts engaged, follow…
-
get_instagram_fans_analyticsGet Instagram Fans AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks about follower/audience DEMOGRAPHICS: age, gender, country, or city breakdown (e.g. "che età hanno i miei follower?", "distribuzione per genere", "da quali paesi/città arrivano i miei follower?"). - The user asks WHEN their followers are online (best time to post), or wants a follower-COUNT trend over roughly the last month. - This tool takes NO date range parameters — it always covers a fixed internal window decided by the backend (see per-key notes below), it does NOT accept a custom start_date/end_date. - This is NOT account-level engagement (reach, views, accounts engaged, follows/unfollows) — use get_instagram_account_analytics() instead. This is NOT the single current follower total/identity snapshot — use get_instagram_audience_info() instead (this tool's "follower_count" gives a day-by-day s…
-
get_instagram_engaged_accountsGet Instagram Reached AccountsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks about the demographics of accounts REACHED by content — i.e. everyone who saw a post/reel/story, including non-followers — broken down by age, gender, country, or city (e.g. "che età hanno le persone raggiunte dai miei contenuti?", "da dove arrivano gli account raggiunti?"). - This is DIFFERENT from follower demographics: reached accounts can include people who don't follow the page. For demographics of actual FOLLOWERS, use get_instagram_fans_analytics() instead. - This tool takes NO date range parameters. The backend always queries "this_month" (calendar month-to-date, resetting on the 1st of each month) — this is NOT a rolling last-30-days window like get_instagram_fans_analytics(), and NOT a max-30-days limit on a caller-supplied range (no range is accepted at all). - This is NOT account-level r…
-
get_instagram_interactionsGet Instagram InteractionsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks for ACCOUNT-WIDE interaction totals for a date range — comments, likes, shares, saves and profile-contact-button taps, aggregated across ALL content — optionally broken down by content type (post/reel/story) and organic vs sponsored (e.g. "quante interazioni totali questo mese?", "quanti salvataggi organici vs a pagamento?", "quanti tap sui bottoni di contatto del profilo?"). - This is NOT per-post metrics — for interactions on a SPECIFIC post or a ranked list of posts, use get_instagram_posts_and_reels() instead. This is NOT reach/views/accounts-engaged/follows totals — use get_instagram_account_analytics() instead. Get Instagram account-wide interaction totals for a date range (insights: comments,likes,shares,saves + profile_links_taps). NOTE: max period 30 days (enforced below). Insights use Paci…
-
get_instagram_posts_and_reelsGet Instagram Posts & Reels AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. USE THIS TOOL when the user asks for analytics, statistics, metrics, performance, engagement, or post insights (views, likes, comments, shares, impressions, reach, clicks, saves, etc.). Examples: "show me the analytics", "post statistics", "how are the posts performing", "which post has the most engagement", "content performance", "post metrics". CONTENT ANALYSIS — If the user instead wants to analyze topics, tone of voice, editorial themes, or posting frequency (NOT metrics), use get_channel_posts_for_content_analysis() instead. Get Instagram posts and reels insights in a single call. Includes ALL posts and reels on the account — both published via PostPickr and posted natively or through other tools. NOTE: Max period 30 days. Insights use Pacific timezone. Some metrics may not include data from the last 2 days. ATTRIBUTION: set include…
-
get_pinterest_posts_analyticsGet Pinterest Posts AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. USE THIS TOOL when the user asks for analytics, statistics, metrics, performance, engagement, or post insights (views, likes, comments, shares, impressions, reach, clicks, saves, etc.). Examples: "show me the analytics", "post statistics", "how are the posts performing", "which post has the most engagement", "content performance", "post metrics". CONTENT ANALYSIS — If the user instead wants to analyze topics, tone of voice, editorial themes, or posting frequency (NOT metrics), use get_channel_posts_for_content_analysis() instead. DATE RANGE — This tool fetches ALL posts in the given period in a single request. Always call it with the full date range requested by the user — do NOT split proactively. Do NOT make a preliminary "test" call with a short date range before the real call. Only if the call times out: inform the user and retry spl…
-
get_pinterest_account_analyticsGet Pinterest Account AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks for account-wide Pinterest engagement metrics over a date range — impressions, engagement, saves, clicks, closeups, etc. (e.g. "quante impression ha avuto il mio account Pinterest questo mese?", "come sta performando l'account su mobile?"). - filter_type lets the user narrow the SAME metrics along ONE of two independent dimensions at a time — either DEVICE ("mobile", "tablet", "web") or PIN FORMAT ("product", "image", "video") — never both at once. Omit filter_type (or pass None) for the unfiltered totals across all devices and pin formats combined. - This is NOT per-post/per-pin metrics — use get_pinterest_posts_analytics() instead for individual pin performance. Get Pinterest account-level analytics metrics (Pinterest's user_account/analytics endpoint, passed through largely as-is). NOTE: max peri…
-
get_tiktok_video_analyticsGet TikTok Video AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. USE THIS TOOL when the user asks for analytics, statistics, metrics, performance, engagement, or post insights (views, likes, comments, shares, impressions, reach, clicks, saves, etc.). Examples: "show me the analytics", "post statistics", "how are the posts performing", "which post has the most engagement", "content performance", "post metrics". CONTENT ANALYSIS — If the user instead wants to analyze topics, tone of voice, editorial themes, or posting frequency (NOT metrics), use get_channel_posts_for_content_analysis() instead. DATE RANGE — This tool fetches ALL posts in the given period in a single request. Always call it with the full date range requested by the user — do NOT split proactively. Do NOT make a preliminary "test" call with a short date range before the real call. Only if the call times out: inform the user and retry spl…
-
get_threads_posts_analyticsGet Threads Posts AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. USE THIS TOOL when the user asks for analytics, statistics, metrics, performance, engagement, or post insights (views, likes, comments, shares, impressions, reach, clicks, saves, etc.). Examples: "show me the analytics", "post statistics", "how are the posts performing", "which post has the most engagement", "content performance", "post metrics". CONTENT ANALYSIS — If the user instead wants to analyze topics, tone of voice, editorial themes, or posting frequency (NOT metrics), use get_channel_posts_for_content_analysis() instead. DATE RANGE — This tool fetches ALL posts in the given period in a single request. Always call it with the full date range requested by the user — do NOT split proactively. Do NOT make a preliminary "test" call with a short date range before the real call. Only if the call times out: inform the user and retry spl…
-
get_threads_account_analyticsGet Threads Account AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks for account-wide Threads engagement totals or trends — views, likes, replies, reposts, quotes, follower count — over a date range (e.g. "quante visualizzazioni ha avuto il mio account Threads questo mese?", "quanti follower ho guadagnato?"). - This is NOT per-post metrics — for engagement on individual Threads posts, use get_threads_posts_analytics() instead. This is NOT follower demographics (age, gender, location) — use get_threads_fans_analytics() instead. Get Threads account-level analytics for a date range (metric=views, likes, replies, reposts, quotes, followers_count in a single Graph API call). A metric key is entirely absent from the response if Threads returned no data for it — do not assume all 6 keys are always present. NOTE — date-range shift: the backend shifts start_date forward by 1…
-
get_threads_fans_analyticsGet Threads Fans AnalyticsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. WHEN TO USE THIS TOOL: - The user asks about follower/audience DEMOGRAPHICS: age, gender, country, or city breakdown (e.g. "che età hanno i miei follower su Threads?", "da quali paesi arrivano i follower Threads?"). - This tool takes NO date range parameters — it always reflects the CURRENT audience composition, it does NOT accept start_date/end_date. - This is NOT account-level engagement (views, likes, replies, reposts, quotes, follower count trend) — use get_threads_account_analytics() instead. This is NOT per-post metrics — use get_threads_posts_analytics() instead. Get Threads follower demographics (insights/follower_demographics, broken down by gender+age, country, city). NOTE: requires the account to have at least 100 followers and to be linked to an Instagram account, or this data may be missing entirely from the response. RESPON…
-
get_google_business_insightsGet Google Business InsightsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. Get Google Business Profile daily metrics and insights. Returns views, searches, actions, and other business metrics. NOTE: Data from the last 72 hours is not available. All dates and times are shown in UTC timezone. Args: project_id: The project ID start_date: Start date in format DD/MM/YYYY end_date: End date in format DD/MM/YYYY channel_id: Optional idsocial of the channel (use if project has multiple channels of the same platform). Get it from get_audience_channels().
-
get_google_business_keywordsGet Google Business Search KeywordsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. Get Google Business Profile search keywords. Returns keywords/queries people used to find your business. NOTE: Data from the last 72 hours is not available. All dates and times are shown in UTC timezone. Args: project_id: The project ID start_date: Start date in format DD/MM/YYYY end_date: End date in format DD/MM/YYYY channel_id: Optional idsocial of the channel (use if project has multiple channels of the same platform). Get it from get_audience_channels().
-
get_google_business_reviewsGet Google Business ReviewsIMPORTANT: Always base counts, metrics and dates exclusively on the data returned by this tool call. Never use figures from memory or previous calls. Get Google Business Profile reviews and questions. Returns customer reviews and Q&A data. Args: project_id: The project ID channel_id: Optional idsocial of the channel (use if project has multiple channels of the same platform). Get it from get_audience_channels().
-
get_audience_channelsGet Audience ChannelsGet the analytics-eligible channels of a project, with the identifiers needed to call the audience/analytics tools for each one. IMPORTANT — this is a FILTERED subset, not the full channel list. The backend returns only channels whose platform supports audience analytics AND whose connection is healthy. Concretely it includes: - Facebook: PAGES only (personal profiles and groups are excluded). - Instagram: only accounts linked to a Facebook token. Personal (non Business/Creator) IG accounts are still listed but flagged with "to_connect": true, "type": "user" and social_icon "instagram-personal"; most Instagram analytics will fail for them until the account is reconnected as Business/Creator. - Pinterest: BUSINESS accounts only (personal Pinterest accounts are excluded). - LinkedIn, TikTok, Threads, Google Business Profile. Any channel whose platform has a connection error is silently dropped. There is NO Twitter/X entry — that platform has no audience analytics. A channel present in g…
-
get_facebook_audience_infoGet Facebook Audience InfoGet detailed Facebook page audience information and insights. Returns channel identity (name, picture, cover, category, id) plus fan_count/likes and followers_count. This is a point-in-time snapshot, not a time series. WHEN TO USE THIS TOOL: - The user explicitly asks for the current Facebook page like/fan count or follower count (e.g. "quanti fan/like ha la mia pagina Facebook?", "how many followers does my page have?"). - The user wants to confirm the identity of the connected Facebook page (name, picture, cover, category). - As a lightweight check that the info endpoint responds for this channel. Do NOT use this tool as a preparatory step before calling other Facebook analytics/posting tools — credential resolution already happens internally via _get_channel_credentials() and does not require calling this tool. For follower/fan TRENDS over time, use get_facebook_fans_analytics() instead. Args: channel_hash: Internal channel identifier (the "hash" field from get_audience_channels).…
-
get_instagram_audience_infoGet Instagram Audience InfoGet detailed Instagram Business/Creator account audience information. Returns channel identity and current follower snapshot from the Instagram Graph API: biography, id, ig_id, followers_count, follows_count, media_count, name, profile_picture_url, username, website. This is a point-in-time snapshot, not a time series. Note: there is no "likes" or generic "picture" object in this response — use followers_count and profile_picture_url instead. WHEN TO USE THIS TOOL: - The user explicitly asks for the current Instagram follower count or account identity (e.g. "quanti follower ha il mio account Instagram?", "qual è la bio/username dell'account collegato?"). - As a lightweight check that the info endpoint responds for this channel. Do NOT use this tool as a preparatory step before calling other Instagram analytics/posting tools — credential resolution already happens internally via _get_channel_credentials() and does not require calling this tool. For follower/fan DEMOGRAPHICS (age, gende…
-
get_linkedin_audience_infoGet LinkedIn Audience InfoGet detailed LinkedIn audience information: channel identity (id, name, logo) and follower count. Works for BOTH LinkedIn company pages AND personal profiles. WHEN TO USE THIS TOOL: - The user explicitly asks for the LinkedIn follower count / audience size (e.g. "quanti follower ha la mia pagina LinkedIn?", "quanti follower ha il mio profilo LinkedIn?", "how big is my LinkedIn audience?"). - The user wants to confirm the identity of the connected LinkedIn channel (name, logo) — e.g. "qual è il canale LinkedIn collegato?". - As a lightweight check that the info endpoint responds for this channel. Do NOT use this tool as a preparatory step before calling other LinkedIn analytics/posting tools — credential resolution already happens internally via _get_channel_credentials() and does not require calling this tool. For follower TRENDS over time, use get_linkedin_followers_analytics() (pages) or get_linkedin_profile_followers() (personal profiles) instead. PAGE vs PERSONAL PROFILE: the back…
-
get_pinterest_audience_infoGet Pinterest Audience InfoGet basic Pinterest channel identity: name and logo (profile image URL). NOTE: unlike the equivalent tool for other platforms, this does NOT return any follower/audience count or insights — the backend calls Pinterest's user_account endpoint only to validate the connection, its result is discarded and never included in the response. WHEN TO USE THIS TOOL: - The user wants to confirm the identity of the connected Pinterest channel (name, logo) or do a lightweight check that the connection is valid. Do NOT use this tool to answer questions about Pinterest follower counts or audience size — this response does not contain that data. Do NOT use this tool as a preparatory step before calling other Pinterest analytics/posting tools — credential resolution already happens internally via _get_channel_credentials() and does not require calling this tool. For account engagement metrics (impressions, engagement, saves, clicks) use get_pinterest_account_analytics() instead. Args: channel_hash: Int…
-
get_tiktok_audience_infoGet TikTok Audience InfoGet detailed TikTok account audience information. Returns channel identity (name = TikTok username, logo = profile image URL) plus a current snapshot from TikTok's user info API: follower_count, following_count, likes_count. This is a point-in-time snapshot, not a time series — there is no separate TikTok tool for follower/likes TRENDS over time (unlike Facebook/Instagram/LinkedIn, TikTok has no dedicated fans/followers analytics tool); this is the only source for these counts. WHEN TO USE THIS TOOL: - The user explicitly asks for the current TikTok follower/following/ likes count or account identity (e.g. "quanti follower ha il mio account TikTok?", "quanti like totali ha l'account?"). - As a lightweight check that the info endpoint responds for this channel. Do NOT use this tool as a preparatory step before calling other TikTok analytics/posting tools — credential resolution already happens internally via _get_channel_credentials() and does not require calling this tool. For per-vid…
-
get_google_business_audience_infoGet Google Business Audience InfoGet basic Google Business Profile channel identity: accountName, logo (profile image URL), and name. NOTE: this does NOT return any audience/customer insights or metrics — it is identity data only (Google Business Profiles don't have "followers"; use get_google_business_insights() for views/searches/actions metrics). WHEN TO USE THIS TOOL: - The user wants to confirm the identity of the connected Google Business Profile channel (account name, logo) or do a lightweight check that the connection is valid. Do NOT use this tool as a preparatory step before calling other Google Business analytics/posting tools — credential resolution already happens internally via _get_channel_credentials() and does not require calling this tool. For views/searches/actions metrics use get_google_business_insights() instead; for search keyword data use get_google_business_keywords() instead; for reviews use get_google_business_reviews() instead. Args: channel_hash: Internal channel identifier (the "hash" fi…
-
get_threads_audience_infoGet Threads Audience InfoGet basic Threads channel identity: id, username, name, and threads_profile_picture_url. NOTE: this does NOT return any follower count or audience insights — it is identity data only. Threads channels are backed by the linked Instagram account's credentials internally, but this endpoint is Threads-specific. WHEN TO USE THIS TOOL: - The user wants to confirm the identity of the connected Threads channel (username, display name, profile picture) or do a lightweight check that the connection is valid. Do NOT use this tool to answer questions about Threads follower counts or engagement — this response does not contain that data. Do NOT use this tool as a preparatory step before calling other Threads analytics/posting tools — credential resolution already happens internally via _get_channel_credentials() and does not require calling this tool. For follower count / engagement trends use get_threads_account_analytics() instead; for follower demographics use get_threads_fans_analytics() inste…
-
get_collectionsGet CollectionsGet scheduled posts from collections (rubriche) in the calendar for a specific date range. Collections are recurring content series in PostPickr. NOTE: This returns POSTS from collections in the date range, not the collection list. To list ALL collections (scheduled and unscheduled), use get_collections_list(). Args: project_id: The ID of the project start_date: Start date in format YYYY-MM-DD end_date: End date in format YYYY-MM-DD Example: get_collections(project_id=440, start_date="2025-11-23", end_date="2025-12-01")
-
get_collections_listGet Collections ListGet ALL collections (rubriche) for a project — both scheduled and unscheduled. Returns the complete list from Contenuti > Rubriche, with name and optional content count. WHEN TO USE THIS TOOL: - "list the collections of project X" / "elenca le rubriche del progetto X" - "how many contents does collection Y have?" / "quanti contenuti ha la rubrica Y?" - "find the collection named Z" / "trova la rubrica chiamata Z" - To get the id, name, colour and content count of each collection IMPORTANT: always call this tool to get up-to-date data. Do not reuse results from previous calls — they may be stale. Returns ALL collections (scheduled and unscheduled). To see only scheduled collections with their status (active/paused/ended), use get_palinsesto_collections(). For posts scheduled from the palinsesto in a date range, use get_collections(). Args: project_id: Project ID include_content_count: If True (default), adds the number of posts (stato=1) for each collection (field `content_count`). Req…
-
get_palinsesto_collectionsGet Palinsesto CollectionsGet scheduled collections (rubriche programmate) from the Palinsesto section, enriched with a computed scheduling_status and loop flag. WHEN TO USE THIS TOOL: - "show scheduled collections for project X" / "mostra le rubriche programmate del progetto X" - "which collections are active / paused / ended?" / "quali rubriche sono attive / in pausa / terminate?" - "which collections can I schedule?" / "quali rubriche posso programmare?" → those with is_scheduled=false (no Palinsesto record yet) - "which collections can I re-schedule / modify?" / "quali posso riprogrammare?" → those with is_scheduled=true - "is collection Y in loop mode?" / "la rubrica Y è in loop?" IMPORTANT: always call this tool to get up-to-date data. Do not reuse results from previous calls — collection status can change at any time (activation, pause, content exhaustion). For ALL collections (including unscheduled ones), use get_collections_list(). COUNTS — Per rispondere a "quante rubriche sono ended/paused/active/no…
-
create_collectionCrea RubricaCrea una nuova rubrica (collection/raccolta) in un progetto. QUANDO USARE QUESTO TOOL: - "crea una nuova rubrica chiamata X nel progetto Y" - "aggiungi la rubrica 'Buongiorno' al progetto" - Quando l'utente vuole organizzare contenuti ricorrenti in una nuova serie Nota: la creazione è soggetta al limite di rubriche del piano in uso. Se il limite è raggiunto, il backend risponde con code="COLLECTIONS_TOTAL_LIMIT" e il valore `limit` del piano. Args: project_id: ID del progetto in cui creare la rubrica (da get_projects()) description: Nome/descrizione della rubrica (obbligatorio) color: Colore della rubrica in formato esadecimale `#rrggbb` (opzionale). Serve a distinguere visivamente l'etichetta della rubrica nel calendario. Se non fornito viene generato un hex random — stesso comportamento della dashboard PostPickr, che lo genera lato JS al momento della creazione. Example: create_collection(project_id=440, description="Buongiorno", color="#FF8800")
-
set_palinsesto_collectionProgramma RubricaImposta (crea o aggiorna) la programmazione di una rubrica nel Palinsesto. QUANDO USARE QUESTO TOOL: - "aggiungi uno slot di programmazione della rubrica X nei giorni GIO VEN SAB alle 20:30 e 14:00" - "programma la rubrica X del progetto Y ogni lunedì alle 9" - "metti in loop la rubrica 'Buongiorno'" - "attiva/metti in pausa la programmazione della rubrica" - "cambia gli orari di pubblicazione di una rubrica già programmata" CREATE vs UPDATE (automatico — NON devi recuperare tu l'idpalinsesto): Il tool rileva da solo se la rubrica ha già una programmazione. Prima di scrivere interroga GET /palinsesto/collection/{project_id} e cerca un record Palinsesto con la stessa idcategoria (in QUALSIASI stato: active/paused/ended): - se lo trova → UPDATE della programmazione esistente (usa quell'idpalinsesto); - se non lo trova → INSERT di una nuova programmazione. Questo elimina il rischio di creare un secondo record Palinsesto duplicato per la stessa rubrica. Il parametro `palinsesto_id` resta…
-
get_pinterest_boardsGet Pinterest BoardsList the Pinterest boards of the connected Pinterest channel. WHEN TO USE THIS TOOL: - Before creating/scheduling a Pinterest post: `create_post` requires a `pinterest_board_id`, and this is how you obtain it. - When the user asks which Pinterest boards they have. - To let the user pick the destination board by name. Each board includes at least `id` (pass it as `pinterest_board_id` in create_post) and `name`. If the user hasn't said which board to use, show the list and ask — do not guess. To create a new board instead, use create_pinterest_board(). Args: project_id: The project ID (from get_projects()). channel_id: Specific channel idsocial if the project has multiple Pinterest accounts (from get_channels()). Optional. Both Business and personal "Pinner" accounts are supported. Example: boards = get_pinterest_boards(project_id=176178) # user picks one -> pass its id as pinterest_board_id in create_post
-
create_pinterest_boardCreate Pinterest BoardCreate a new Pinterest board on the connected Pinterest channel. WHEN TO USE THIS TOOL: - The user wants to publish to a NEW board that doesn't exist yet. - After get_pinterest_boards() shows none of the existing boards fit. On success the response contains the created board with its `id`, ready to pass as `pinterest_board_id` in create_post. Args: project_id: The project ID (from get_projects()). name: Board name (required). Pinterest rejects a duplicate name with BOARD_NAME_DUPLICATED — in that case use the existing board from get_pinterest_boards() instead. description: Optional board description. privacy: "PUBLIC" (default), "PROTECTED" or "SECRET". channel_id: Specific channel idsocial if the project has multiple Pinterest accounts. Optional. Example: create_pinterest_board(project_id=176178, name="Ricette estive")
-
get_pinterest_board_sectionsGet Pinterest Board SectionsList the sections of a specific Pinterest board. WHEN TO USE THIS TOOL: - When the user wants to publish into a specific SECTION of a board. - Sections are optional in create_post; pass the chosen section as `pinterestBoardSectionID` (and `pinterestBoardSectionName`). Args: project_id: The project ID (from get_projects()). board_id: The board id (from get_pinterest_boards()). channel_id: Specific channel idsocial if the project has multiple Pinterest accounts. Optional. Example: sections = get_pinterest_board_sections(project_id=176178, board_id="123456")
-
create_pinterest_board_sectionCreate Pinterest Board SectionCreate a new section inside a Pinterest board. WHEN TO USE THIS TOOL: - The user wants a NEW section that doesn't exist yet on the board. - After get_pinterest_board_sections() shows none of the existing ones fit. On success the response contains the created section with its `id`, usable as `pinterestBoardSectionID` in create_post. Args: project_id: The project ID (from get_projects()). board_id: The board id the section belongs to (from get_pinterest_boards()). name: Section name (required). channel_id: Specific channel idsocial if the project has multiple Pinterest accounts. Optional. Example: create_pinterest_board_section(project_id=176178, board_id="123456", name="Antipasti")
-
get_scheduled_postsGet Scheduled PostsGet ALL scheduled content from the PostPickr calendar for a specific date range. PRIMARY TOOL for calendar queries. Use this when user asks about: - "Post programmati" (scheduled posts) - "SmartFeed programmati" (scheduled SmartFeed) ← YES, use this tool! - "Rubriche programmate" (scheduled collections) - "Calendario" (calendar view) - Any combination of the above IMPORTANT: This returns THREE different types of scheduled content: 1. REGULAR POSTS ("posts"): Manually scheduled posts created individually - User scheduled these with a specific date/time - Each post is unique and one-time 2. COLLECTION POSTS ("collections"): Posts from recurring content series (Rubriche/Palinsesto) - Part of a recurring content calendar/editorial plan - Follow a predefined schedule pattern - Example: "Weekly tips every Monday" or "Product showcase every Friday" 3. SMARTFEED POSTS ("smartfeed"): Auto-scheduled posts based on AI/best times - Automatically scheduled by PostPickr's SmartFeed feature - Posted…
-
get_postsGet PostsRetrieve posts for a project, with automatic status filtering. Does NOT return drafts: use get_drafts() for drafts. Does NOT represent the calendar view: use get_scheduled_posts() for the calendar. WHEN TO USE THIS TOOL: - "show me published posts" / "mostrami i post pubblicati" → status="published" - "which posts are scheduled?" / "quali post sono programmati?" → status="scheduled" - "posts saved in a collection" / "post salvati in rubrica" → status="collection" - "archived posts" / "post archiviati" → status="archived" - "posts to publish immediately" / "post da pubblicare subito" → status="publish_immediately" - "posts being published" / "post in fase di pubblicazione" → status="publishing_in_progress" - "posts with errors" / "post con errori di pubblicazione" → status="error" - "posts deleted from social" / "post eliminati dal social" → status="deleted_from_social" - "posts pending approval" / "post da approvare" → status="pending_approval" - "approved posts" / "post già approvati…
-
create_postCrea Post (Pubblica / Programma)Crea e PUBBLICA / PROGRAMMA / salva in RUBRICA un post multicanale su PostPickr. Questo tool NON crea bozze: per le bozze usare save_draft(). ════════════════════════════════════════════════════════════════════════════ MAPPING della richiesta utente → parametro `state` ════════════════════════════════════════════════════════════════════════════ DEFAULT per "pubblica / posta / condividi" senza tempo futuro → state=20 • "pubblica" / "pubblica subito" / "pubblica ora" / "posta" "condividi" / "publish" / "post it" → state=20 • "programma per <data/ora>" / "schedula per <data/ora>" "metti in coda alle 14:30" / "schedule for tomorrow" → state=2 (RICHIEDE schedule_time = "YYYY-MM-DD HH:MM") • "salva in rubrica X" / "aggiungi alla rubrica X" "metti nella categoria X" → state=1 (RICHIEDE idcategoria per OGNI canale, da get_collections()) • "metti in approvazione" / "mettilo in coda di approvazione" "submit for approval" / "needs review" → require_approval=True (RICHIEDE state=2 con schedule_ti…
-
update_postModifica PostModifica un post esistente NON ancora pubblicato (programmato o in rubrica) su PostPickr: programmazione E/O contenuto (testo, primo commento, immagini, video, link, documento). ⚠️ SOLO post non pubblicati. Un post già pubblicato sui canali NON è modificabile (non è tecnicamente possibile via API dei social): per quelli il tool ritorna comunque il lookup ma la modifica non ha effetto sulla pubblicazione già avvenuta. Lo stato di APPROVAZIONE resta NON modificabile via MCP (il flusso di approvazione innesca notifiche gestite dalla dashboard). ════════════════════════════════════════════════════════════════════════════ LEGGI-PRIMA-DI-SCRIVERE + CONFERMA CON DIFF (obbligatorio per il contenuto) ════════════════════════════════════════════════════════════════════════════ Quando modifichi il CONTENUTO (message / first_comment / images / video_url / link / link_name / link_description / document) la scrittura è a DUE FASI: 1) PREVIEW — chiama update_post con i nuovi valori ma SENZA `confirm…
-
reschedule_slotRiprogramma Slot ProgrammatoSposta un intero slot programmato a una nuova data/ora. Uno "slot" e' un contenuto pubblicato su piu' canali insieme: N righe Post (una per canale) unite dallo stesso `codice` E dalla stessa `schedulazione`. Questo tool sposta TUTTI i canali dello slot insieme, come il trascinamento sul calendario della dashboard (POST /calendar/updateSchedulazione): aggiorna la sola `schedulazione` con una UPDATE ... WHERE idpost IN (...), senza toccare `codice` ne' altri campi. Lo slot resta unito e non si sdoppia. Differenza da update_post: `update_post` modifica UN singolo post/canale (e, cambiandone l'orario, lo stacca in uno slot separato con nuovo `codice`); `reschedule_slot` muove l'intero slot mantenendo i canali insieme. Per "sposta/riprogramma il post [multicanale] a ..." usa questo tool. Args: project_id: ID del progetto (da get_posts() / get_scheduled_posts()). post_id: ID di uno qualsiasi dei post dello slot. Il tool risale agli altri canali dello stesso slot via `codice` + `schedulazion…
-
get_channel_posts_for_content_analysisGet Channel Posts for Content AnalysisRetrieve published posts from a social channel with ONLY content fields — no engagement or performance metrics (likes, views, clicks, impressions, shares, etc.). Includes ALL posts on the channel — both published via PostPickr and natively. WHEN TO USE THIS TOOL — ONLY when the user explicitly asks to analyze editorial content, style, or topics. The key signal: the user wants to understand WHAT was published, not HOW WELL it performed. Examples: - "analyze the published content / topics / themes" - "analyze the tone of voice of the posts" - "what does this profile talk about?" - "what hashtags do they usually use?" - "how often do they post?" - "I'm taking over a new client's channel and want to understand what they published" - "analyze the editorial strategy of this channel" DO NOT use this tool — use the platform-specific analytics tool instead — when the user asks: - "analytics", "statistics", "metrics", "post analytics", "post performance" - "show me the analytics", "give me the…
-
save_draftCrea BozzaCrea una bozza (draft) su PostPickr, senza pubblicare né programmare. La bozza resta nella sezione Bozze del progetto, pronta per essere programmata/pubblicata quando l'utente vuole. La bozza viene creata con la modalità di pubblicazione (`publish_direct`) e la destinazione (`target`: feed/reels/storie) impostate direttamente dal tool, esattamente come farebbe la dashboard: il tool le scrive nella bozza, quindi NON dire all'utente di aprire la bozza nella dashboard per configurarle. ⚠️ CONFERMA OPZIONI PRIMA DI CREARE (obbligatoria): NON esiste un tool MCP per MODIFICARE una bozza dopo la creazione. Quindi le opzioni vanno decise PRIMA. Prima di chiamare save_draft, CHIEDI e conferma con l'utente: 1. la DESTINAZIONE del post (`target`): feed, reels o storie — soprattutto per Facebook/Instagram/TikTok; 2. la MODALITÀ di pubblicazione (`publish_direct`): Diretta (via API) o Notifica (push all'app, pubblicazione manuale). NON usare silenziosamente i default (Diretta + feed): usali solo s…
-
get_draftsElenco BozzeRecupera le bozze di un progetto, raggruppate per codice. NON restituisce post programmati/pubblicati: per quelli usare get_posts(). QUANDO USARE QUESTO TOOL: - "mostra le bozze" / "elenca le bozze del progetto" - "cerca nelle bozze" / "filtra bozze per canale" - Prima di modificare o eliminare una bozza Le bozze multicanale hanno più entry sotto lo stesso 'codice'. Args: project_id: ID del progetto page: Pagina per la paginazione (default: 0) idsocial: Filtra per ID canale (opzionale) codice: Filtra per codice bozza specifico (opzionale) ordinamento: Ordinamento — "DESC" (più recenti) o "ASC" (più vecchie) autore: Filtra per autore/membro ID (opzionale, "0" per il proprietario) ricerca: Testo da cercare nel contenuto delle bozze (opzionale) Example: get_drafts(project_id=149094) get_drafts(project_id=149094, ricerca="lancio prodotto")
-
update_draftModifica BozzaModifica una bozza esistente su PostPickr: CONTENUTO (testo, primo commento, immagini, video, link, documento, nota) e/o DESTINAZIONE e MODALITÀ di pubblicazione, senza pubblicarla. Agisce sull'intera bozza identificata da `codice` (una bozza multicanale è fatta di più righe unite dallo stesso codice: contenuto comune + una per canale). Le modifiche di CONTENUTO ai parametri top-level (message, images…) si applicano al contenuto COMUNE e ai canali che NON erano stati personalizzati; i canali con contenuto personalizzato mantengono il loro. Con `channel_overrides` si personalizza un SINGOLO canale (es. un testo diverso per social). `target` e `publish_direct` sono GLOBALI: si applicano a tutti i canali FB/IG/TikTok. Tutti gli altri dati (sondaggi, board, tag, album, audio, ecc.) vengono PRESERVATI invariati. PERSONALIZZAZIONE PER CANALE (`channel_overrides`, come save_draft): Mappa {idsocial: {campo: valore}} (chiave "0" = contenuto comune). Campi: message, first_comment, note, images,…
-
upload_imageUpload ImageCarica un'immagine da un URL pubblico nella media library di PostPickr. È il passo OBBLIGATORIO prima di allegare a `create_post`/`save_draft` un'immagine che non è già nella media library: URL grezzi passati direttamente in `gallery`/`immagine` vengono silenziosamente scartati dal backend. Il path restituito in `result.name` è quello da usare. WHEN TO USE THIS TOOL: - L'utente fornisce un URL HTTP/HTTPS pubblico di un'immagine - Per importare immagini da siti esterni (CDN, wp-content, ecc.) - Per sbloccare un create_post rifiutato con MEDIA_REQUIREMENTS_NOT_MET quando l'utente ha un'immagine online DO NOT USE THIS TOOL: - ❌ Con un file LOCALE (sul computer dell'utente) o comunque leggibile come byte: NON provare a passarlo qui (accetta solo URL pubblici) e NON ospitarlo su host esterni. Leggi il file, codificalo in base64 e usa `upload_image_file`. Se invece non hai accesso ai byte del file (es. sola immagine allegata in chat senza file system), proponi save_draft + upload manuale d…
-
upload_image_fileUpload Image FileCarica un'immagine LOCALE nella media library di PostPickr passandone il contenuto in base64 (endpoint `/upload`, multipart). È la controparte di `upload_image`: quello scarica da un URL pubblico, questo invia il file. WHEN TO USE THIS TOOL: - L'utente allega/indica un file immagine LOCALE (es. sul suo computer) che NON è raggiungibile da un URL pubblico. Leggi il file, codificalo in base64 e passalo qui — NON provare a farlo passare da `upload_image` (che accetta solo URL pubblici), né a ospitarlo su host esterni. - Restituisce il path interno in `result.name`, da usare come destinazione in un contenuto pubblicabile: `create_post` (campo `gallery` per canale) OPPURE `save_draft` (parametro `images`). NB: i promemoria (`create_reminder`) sono di solo testo — non accettano immagini. ⚠️ REGOLE ANTI-LOOP (importanti): - NON stampare MAI il base64 in chat o nel terminale: è enorme, inutile e rende la conversazione illeggibile. Passalo solo come argomento `image_data`. - Serve avere i BYTE…
-
upload_videoUpload VideoCarica un VIDEO da un URL nel bucket media PERSISTENTE di PostPickr e restituisce l'URL pubblico stabile da usare nel campo `video` di create_post. È la controparte video di `upload_image`. Il backend prende `video_url`, lo mette su S3 (media-upload-unified, catalogato per utente/progetto, ACL public-read) e ritorna un URL `media.postpickr.com/...` PERSISTENTE — così un post PROGRAMMATO ritrova il file anche a distanza di tempo (a differenza dello swap, che è effimero). Copre due casi: - **URL video pubblico** (es. l'utente lo incolla in chat): passa quell'URL qui direttamente. Funziona ANCHE senza sandbox/shell. - **File video locale** (agenti con shell): prima `request_video_upload` per caricarlo sullo swap, poi passa qui il `video_source_url` ottenuto — il backend fa una copia S3→S3 server-side (istantanea, nessun limite). WHEN TO USE THIS TOOL: - Devi allegare un video a un post e hai un suo URL (pubblico, o quello di swap restituito da request_video_upload). DO NOT USE THIS TOOL:…
-
upload_documentUpload DocumentCarica un DOCUMENTO (PDF/doc/docx/ppt/pptx) da un URL nel bucket media PERSISTENTE di PostPickr e restituisce l'URL pubblico stabile da usare nel campo `document.url` di create_post (carosello LinkedIn / documento Telegram). È la controparte documenti di `upload_video`. Il backend prende `document_url`, lo mette su S3 (media-upload-unified, per utente/progetto, ACL public-read, estensione originale preservata) e ritorna un URL `media.postpickr.com/...` PERSISTENTE — così un post PROGRAMMATO ritrova il file al momento della pubblicazione (i worker LinkedIn/Telegram scaricano quell'URL). Copre due casi: - **URL documento pubblico** (es. l'utente lo incolla in chat): passalo qui direttamente. Funziona ANCHE senza sandbox/shell. - **File documento locale** (agenti con shell): prima `request_document_upload` per caricarlo sullo swap, poi passa qui il `document_source_url` ottenuto — il backend fa una copia S3→S3 server-side (istantanea, nessun limite). A COSA SERVE — canali che supportano…
-
upload_audioUpload AudioCarica un AUDIO (mp3/m4a) da un URL nel bucket media PERSISTENTE di PostPickr e restituisce l'URL pubblico stabile da usare nel campo `audio.url` di create_post (allegato audio TELEGRAM). È la controparte audio di `upload_video`/`upload_document`. Il backend prende `audio_url`, lo mette su S3 (media-upload-unified, per utente/progetto, ACL public-read, estensione originale preservata) e ritorna un URL `media.postpickr.com/...` PERSISTENTE — così un post PROGRAMMATO ritrova il file al momento della pubblicazione (il worker Telegram scarica quell'URL e lo invia con /sendAudio). Copre due casi: - **URL audio pubblico** (es. l'utente lo incolla in chat): passalo qui direttamente. Funziona ANCHE senza sandbox/shell. - **File audio locale** (agenti con shell): prima `request_audio_upload` per caricarlo sullo swap, poi passa qui il `audio_source_url` ottenuto — il backend fa una copia S3→S3 server-side (istantanea, nessun limite). A COSA SERVE — SOLO Telegram (tipologia 7): allegato audio "m…
-
get_facebook_post_commentsGet Facebook Post CommentsGet comments from Facebook posts for analysis. WHEN TO USE THIS TOOL: - To retrieve comments from Facebook posts - For sentiment analysis and customer feedback - To analyze engagement and user responses - When user asks to analyze Facebook comments Args: project_id: The project ID post_id: Specific Facebook post ID to get comments from (optional) last_n_posts: Number of recent posts to get comments from (optional, default: 10) include_replies: Whether to include comment replies (default: True) channel_id: Specific channel ID if project has multiple Facebook pages Example: get_facebook_post_comments(project_id=149094, last_n_posts=5)
-
get_instagram_post_commentsGet Instagram Post CommentsGet comments from Instagram posts for analysis. WHEN TO USE THIS TOOL: - To retrieve comments from Instagram posts - For sentiment analysis and customer feedback - To analyze engagement and user responses - When user asks to analyze Instagram comments Args: project_id: The project ID media_id: Specific Instagram media ID to get comments from (optional) last_n_posts: Number of recent posts to get comments from (optional, default: 10) include_replies: Whether to include comment replies (default: True) channel_id: Specific channel ID if project has multiple Instagram accounts Example: get_instagram_post_comments(project_id=149094, last_n_posts=5)
-
get_notificationsGet NotificationsGet inbox notifications for a project. Mirrors the frontend Notifiche section with the same STATUS and TIPOLOGIA filters. The frontend defaults to showing only unread notifications (status="unread"). STATUS filter (status): - "unread" → only new/unread notifications — letto IS NULL (default, matches frontend) - "read" → only archived/read notifications — letto = 1 - "all" → both unread and read TIPOLOGIA filter (notification_type) — mirrors the frontend dropdown: - "all" → all types (default) - "publishing_error" → Errori di pubblicazione (iderrore=2). Use for: "which posts have a publishing error?" / "quali post hanno errore di pubblicazione?", "list publishing error notifications" / "elencami le notifiche di errore di pubblicazione". - "skipped" → Pubblicazioni saltate (iderrore=11 or 13). Use for: "skipped publications" / "pubblicazioni saltate", "posts that were not published" / "post non pubblicati". - "terminated" → Pubblicazioni terminate (iderrore=1, 3, 12 or 14). Use for: "te…
-
get_current_datetimeGet Current DatetimeReturns the current date and time from the server (Italy/Rome timezone). WHEN TO USE THIS TOOL: - At the start of each conversation or when the session may have been resumed after days: call this tool to get the actual current date. - Every time you need to compute a relative date range (e.g. "last week", "this month", "today"): call this tool to anchor the calculation to the real current date. - Never trust the date in the system prompt: it may be the date the conversation was first opened, not the actual current date. Returns: - date: today's date in YYYY-MM-DD format - time: current time in HH:MM:SS format - datetime: full datetime in YYYY-MM-DD HH:MM:SS format - timezone: timezone (Europe/Rome) - weekday: day of the week in English
-
get_projectsGet ProjectsGet the list of all projects from your PostPickr account. WHEN TO USE THIS TOOL: - When user asks to list all projects - When user wants to switch projects or see available projects - To get project IDs for use with other tools - At the start of a session to understand available projects Returns all projects with their details including: - idprogetto: Project ID (use this with other tools) - nome: Project name - idutente: User ID - channelserror: true if the project has one or more channels that need to be reconnected (expired/revoked token). Mirrors the red banner shown in the platform dashboard ("Attenzione: potresti ricevere errori di pubblicazione se non riconnetti alcuni canali"). - channelsErrorNumber: count of channels needing reconnection in that project - numNotificheErrore: count of unread publishing-error notifications - And other project configuration details To list all channels that need reconnecting across all projects, use get_channels_to_reconnect() instead. Example:…
-
get_channelsGet ChannelsGet the list of social media channels connected to a specific project. WHEN TO USE THIS TOOL: - When user asks which social channels are connected - To get channel IDs needed for create_post() or save_draft() - To see available platforms (Facebook, Instagram, TikTok, LinkedIn, etc.) - Before creating posts to verify channel availability Returns list of channels with: - idsocial: Channel ID (use this for creating posts/drafts) - tipologia: Channel type code (use this for create_post()) - social_icon: Platform name (facebook, instagram, tiktok, linkedin, etc.) - nome_profilo: Profile/page name - foto_profilo: Profile image URL OAuth credentials (access/refresh tokens, secrets) are stripped from the response and never exposed: tools that need a token resolve it server-side. Don't ask for them here. NOTE — publish mode (direct vs notification) is NOT derivable from this tool. Channel data carries no reliable "direct publishing enabled" flag, so do NOT infer `instagram_options_direct` / `t…
-
get_channels_to_reconnectGet Channels To ReconnectList all social channels that need to be reconnected (expired or revoked token). Mirrors the red banner shown in the platform dashboard: "Attenzione: potresti ricevere errori di pubblicazione se non riconnetti alcuni canali". WHEN TO USE THIS TOOL: - "are there any channels to reconnect?" / "ci sono canali da ricollegare?" - "which channels need to be reconnected?" / "quali canali devo ricollegare?" - "are all channels properly connected?" / "i canali sono tutti collegati correttamente?" - "are there channels with an expired token?" / "ci sono canali con il token scaduto?" - "which channels have connection issues?" / "quali canali hanno problemi di connessione?" - "are there any disconnected channels?" / "ci sono canali disconnessi?" - Any question about whether channels are properly connected or need attention. Every non-archived project's channel list is checked directly (channel.error == '1' is the ground truth for "needs reconnecting"); channelserror / channelsErrorNumber are not…
-
get_team_membersGet Team MembersGet all team members for your PostPickr account. WHEN TO USE THIS TOOL: - To list all team members and their roles / per elencare i membri del team e i loro ruoli - To check who has access to projects / per verificare chi ha accesso ai progetti - To see team member permissions / per vedere i permessi dei membri Returns members with their roles, permissions, and project access. Role names match the frontend dashboard: - "Administrator" / "Amministratore" (API: memberadmin) - Full access to all available features, excluding administrative and commercial ones - "Project Manager" (API: membermanager) - Can manage only the Projects explicitly assigned to them - "Content Manager" (API: memberbasic) - Can manage content within assigned Projects only, with no administrative privileges - "Creator" (API: membereditor) - Can only create content within assigned Projects - "Customer" / "Cliente" (API: membercustomer) - Read-only role dedicated to reviewing and approving posts created by the social…
-
get_calendar_remindersGet Calendar RemindersGet reminders from the calendar for a specific date range. Args: project_id: The ID of the project start_date: Start date in format YYYY-MM-DD end_date: End date in format YYYY-MM-DD Example: get_calendar_reminders(project_id=440, start_date="2025-11-23", end_date="2025-12-01")
-
create_reminderCreate ReminderCreate a reminder in the PostPickr calendar. Args: project_id: The ID of the project title: Reminder title date: Reminder date in format YYYY-MM-DD time: Reminder time in format HH:MM (NOTA: l'API attuale salva solo la data, il promemoria viene fissato a mezzanotte; l'orario è accettato ma ignorato) description: Reminder description (optional)
-
request_image_uploadRequest Image UploadApre un canale di upload per un'IMMAGINE locale senza limiti di dimensione né perdita di qualità, restituendo un URL S3 presigned a cui caricarla. ⛔ PREREQUISITO DURO — leggi PRIMA di chiamare. Questo tool serve a caricare l'immagine con un comando shell (`curl`). Se in QUESTO ambiente NON puoi eseguire comandi shell (es. chat pura senza code-execution), NON chiamarlo: restituirebbe un URL che non potresti usare, mandandoti in un vicolo cieco. In quel caso vai diretto all'alternativa giusta: `upload_image` se hai un URL pubblico, `upload_image_file` (base64) per un'immagine piccola di cui possiedi i byte. Se non hai né shell né byte reali del file (tipico con un'immagine solo allegata in chat), fermati e chiedi all'utente un URL pubblico oppure l'upload dalla dashboard PostPickr — NON tentare a vuoto. È l'alternativa preferita a `upload_image_file` quando il client ha una sandbox di esecuzione (Cowork, Claude Code, claude.ai con code-execution): l'immagine NON passa in base64 dentro…
-
request_video_uploadRequest Video UploadApre un canale di upload per un VIDEO LOCALE senza limiti di dimensione né perdita di qualità, restituendo un URL S3 presigned a cui caricarlo. Serve SOLO per un video che hai come file locale E puoi eseguire `curl`. - Se hai già un URL VIDEO pubblico (es. passato in chat): NON usare questo tool, chiama direttamente `upload_video(project_id, video_url=<URL>)`. - Se NON puoi eseguire shell (chat senza sandbox) e hai solo un file locale: questo canale non è utilizzabile — chiedi all'utente un URL pubblico o l'upload del video dalla dashboard PostPickr. A differenza delle immagini, il video NON resta sullo swap: al passo 3 `upload_video` lo fa COPIARE nel bucket persistente ufficiale (media-upload-unified) e ne restituisce l'URL pubblico stabile (media.postpickr.com), che è ciò che va nel campo `video` del post — così un post PROGRAMMATO ritrova il file anche a distanza di tempo. FLUSSO (3 passi): 1. Chiama questo tool: ottieni `upload_url` (PUT) e `video_source_url`. 2. Carica il file:…
-
request_document_uploadRequest Document UploadApre un canale di upload per un DOCUMENTO LOCALE (PDF/doc/docx/ppt/pptx) senza limiti di dimensione, restituendo un URL S3 presigned a cui caricarlo. Serve SOLO per un documento che hai come file locale E puoi eseguire `curl`. - Se hai già un URL documento pubblico (es. passato in chat): NON usare questo tool, chiama direttamente `upload_document(project_id, document_url=<URL>)`. - Se NON puoi eseguire shell (chat senza sandbox) e hai solo un file locale: questo canale non è utilizzabile — chiedi all'utente un URL pubblico o l'upload del documento dalla dashboard PostPickr. A COSA SERVE — documenti dei canali LinkedIn (carosello PDF) e Telegram. Come il video, il documento NON resta sullo swap: al passo 3 `upload_document` lo fa COPIARE nel bucket persistente ufficiale (media-upload-unified) e ne restituisce l'URL pubblico stabile (media.postpickr.com), che è ciò che va nel campo `document.url` del post — così un post PROGRAMMATO ritrova il file. FLUSSO (3 passi): 1. Chiama questo too…
-
request_audio_uploadRequest Audio UploadApre un canale di upload per un AUDIO LOCALE (mp3/m4a) senza limiti di dimensione, restituendo un URL S3 presigned a cui caricarlo. Serve SOLO per un audio che hai come file locale E puoi eseguire `curl`. - Se hai già un URL audio pubblico (es. passato in chat): NON usare questo tool, chiama direttamente `upload_audio(project_id, audio_url=<URL>)`. - Se NON puoi eseguire shell (chat senza sandbox) e hai solo un file locale: questo canale non è utilizzabile — chiedi all'utente un URL pubblico o l'upload dell'audio dalla dashboard PostPickr. A COSA SERVE — allegato audio Telegram (tipologia 7). Come il video, l'audio NON resta sullo swap: al passo 3 `upload_audio` lo fa COPIARE nel bucket persistente ufficiale (media-upload-unified) e ne restituisce l'URL pubblico stabile (media.postpickr.com), che è ciò che va nel campo `audio.url` del post — così un post PROGRAMMATO ritrova il file. FLUSSO (3 passi): 1. Chiama questo tool: ottieni `upload_url` (PUT) e `audio_source_url`. 2. Carica il…
-
get_smartfeed_listGet SmartFeed ListGet the SmartFeeds that have IMPORTED CONTENT, with that content (review). Uno SmartFeed è una rubrica "automatica": importa contenuti da una sorgente esterna (fullpick_url) e li tiene pronti per la pubblicazione. La sorgente è identificata dal campo `fullpick_tab`. Sorgenti supportate (per ora): Feed RSS, WordPress, Pocket, Facebook, LinkedIn, YouTube, Twitter, Pinterest, Spotify Podcast. ATTENZIONE — questo NON è l'elenco completo degli SmartFeed: restituisce SOLO quelli che hanno almeno un contenuto importato (Post.fullpick_url NOT NULL, stato=1). Uno SmartFeed senza contenuti importati NON compare qui. Per l'elenco COMPLETO di tutti gli SmartFeed (anche senza contenuti / non programmati) con il loro stato di programmazione, usa get_palinsesto_smartfeed(). WHEN TO USE THIS TOOL: - "che contenuti ha importato lo SmartFeed Y?" / "mostrami i contenuti del feed" - Per ottenere, per gli SmartFeed con contenuti, idcategoria, nome, colore, URL del feed e i contenuti/canali importati. DIFF…
-
get_palinsesto_smartfeedGet Palinsesto SmartFeedGet scheduled SmartFeeds (smartfeed programmati) with their scheduling status. Gemello di get_palinsesto_collections, per gli SmartFeed. WHEN TO USE THIS TOOL: - "quali SmartFeed ci sono / sono disponibili nel progetto X?" → è QUESTO il tool per l'elenco completo (get_smartfeed_list mostra solo quelli con contenuti importati). - "mostra gli SmartFeed programmati / attivi / in pausa / terminati" - "quali SmartFeed posso programmare?" → is_scheduled=false (nessun record) - "quali posso riprogrammare?" → is_scheduled=true Restituisce TUTTI gli SmartFeed del progetto (fullpick_tab NOT NULL), inclusi quelli SENZA programmazione (attiva=null) e senza contenuti importati, ciascuno con NOME e SORGENTE (fusi dalla lista completa delle categorie SmartFeed), così la risposta è completa senza dover ricorrere ad altri tool. Per ogni elemento: - Categoria: nome dello SmartFeed - source / source_label: sorgente esterna (es. "youtube" / "YouTube") - scheduling_status: "active" | "paused" | "ended" |…
-
get_calendar_smartfeedGet Calendar SmartFeedGet scheduled SmartFeed posts from the calendar for a specific date range. WHEN TO USE THIS TOOL: - When user asks SPECIFICALLY for ONLY SmartFeed posts (excluding regular posts and collections) - For detailed SmartFeed-only analysis IMPORTANT: For general calendar queries including SmartFeed, use get_scheduled_posts() instead. That tool returns ALL content types (posts + collections + smartfeed) by default. NOTE: This returns SCHEDULED POSTS from SmartFeed, not the SmartFeed sources. For the SmartFeed sources and their imported content, use get_smartfeed_list(). If this tool returns an error or empty result, it means: - No SmartFeed posts are scheduled in this date range, OR - The project has no SmartFeed sources configured This is NOT an endpoint error - the endpoint exists and works correctly. SmartFeed posts are automatically scheduled at optimal times based on AI/analytics. Args: project_id: The ID of the project start_date: Start date in format YYYY-MM-DD (e.g., "2026-02-02") en…
-
set_palinsesto_smartfeedProgramma SmartFeedImposta (crea o aggiorna) la programmazione di uno SmartFeed nel Palinsesto. Uno SmartFeed è una rubrica automatica che pubblica i contenuti importati da un feed. La programmazione è identica a quella delle rubriche (set_palinsesto_collection) TRANNE che: - il contenuto pubblicato è scelto dal feed secondo `content_selection` (invece delle opzioni "dopo la pubblicazione"/loop, che qui NON esistono); - internamente usa tipologia "s". CREATE vs UPDATE (automatico): il tool rileva da solo se lo SmartFeed ha già una programmazione interrogando GET /palinsesto/smartfeed/{project_id} e cercando la stessa idcategoria: se la trova fa UPDATE (stesso idpalinsesto), altrimenti INSERT. Elimina il rischio di record Palinsesto duplicati. `palinsesto_id` resta come override manuale opzionale; se il lookup fallisce per errore di trasporto il tool NON crea alla cieca (niente duplicati). PRESERVAZIONE IN UPDATE: aggiornando solo orari/periodo, i parametri NON specificati (content_selection, error_notif…
-
get_link_previewGet Link PreviewGet link preview metadata (title, description, image) from a URL. Args: link_url: The URL to get preview for
Connect your AI to PostPickr
Add the official PostPickr MCP server to Claude, ChatGPT or your editor.
Connect PostPickr MCP to Claude
Claude.ai and Claude Desktop
Open Customize, then Connectors.
Click +, then Add custom connector.
Name it PostPickr, paste the address below and click Add.
Connect PostPickr MCP to ChatGPT
Open Settings, then Apps, then Advanced settings.
Turn on Developer mode, then click Create.
Name it PostPickr and paste the address below.
ChatGPT usually only connects to servers with self-serve sign-in or none.
Connect PostPickr MCP to Cursor
Opens Cursor if it's installed. If nothing happens, use the JSON below.
Connect PostPickr MCP to VS Code
Opens VS Code if it's installed. Otherwise add the JSON settings from the Cursor tab to your .vscode/mcp.json.
PostPickr MCP server questions
Does PostPickr have an official MCP server?
Yes. PostPickr publishes its MCP server itself. Its address is on PostPickr's own domain (mcp.postpickr.com). MartechDB only lists servers a vendor publishes, never community copies.
What is the PostPickr MCP server URL?
The address is https://mcp.postpickr.com/mcp.
How do I connect PostPickr MCP to Claude, ChatGPT or Cursor?
In Claude, add https://mcp.postpickr.com/mcp as a custom connector (Customize, Connectors, Add custom connector). In Cursor, use the Add to Cursor link on MartechDB's page, or paste the JSON settings into your mcp.json. In Claude Code, run: claude mcp add --transport http postpickr https://mcp.postpickr.com/mcp
What can the PostPickr MCP server do?
It offers 76 tools, including get_linkedin_posts_analytics, get_linkedin_followers_analytics, get_linkedin_visitors_analytics, get_linkedin_content_statistics and get_linkedin_profile_posts_analytics (as listed on 6 Oct 2026). 56 are marked read-only.
Is the PostPickr MCP server in the official MCP Registry?
No. PostPickr hasn't published it to the official MCP Registry.
Is the PostPickr MCP server working?
Yes. It answered our most recent check. We last checked it on 22 Nov 2026.
What are the alternatives to PostPickr's MCP server?
In Social media management, the most agent-friendly alternatives with an official MCP server are ContentStudio (100/100), SocialChamp (98/100), Buffer (95/100), Taplio (95/100) and Brandwise (95/100). PostPickr scores 64/100 on the same index.
Alternatives to PostPickr's MCP server
Vendors in Social media management with an official MCP server, the most agent-friendly first. PostPickr scores 64/100.
ContentStudio
contentstudio.io
SocialChamp
socialchamp.com
Buffer
buffer.com
Taplio
taplio.com
Brandwise
brandwise.ai
Use with AI
Connect your AI to MartechDB
Then ask it about PostPickr, or any of the 1,851 marketing tools with an official MCP server. Free, no sign-in.
Claude.ai and Claude Desktop
Open Customize, then Connectors.
Click +, then Add custom connector.
Name it MartechDB, paste the address below and click Add. There's no sign-in.
The free plan allows one custom connector. On Team and Enterprise plans, an owner adds the connector first.
Claude Code
Run this in your terminal:
ChatGPT
Open Settings, then Apps, then Advanced settings.
Turn on Developer mode, then click Create.
Name it MartechDB, paste the address below and choose No authentication.
Developer mode is on Plus and Pro plans, and on Business, Enterprise and Edu if an admin allows it.
API
The same data as JSON, with no sign-in. See the OpenAPI description for every endpoint and field.
CLI
Search the directory and print the command to connect a vendor's server, from your terminal. Needs Node 18 or later. View on npm
Show that your MCP server is verified
If you work at PostPickr, add this badge to your MCP docs or README. It's free, it's the same for every vendor, and it updates from our daily checks: it shows uptime while the server responds, and says so if it stops.
Something wrong or out of date? Suggest a correction or email us, and we'll check it against the evidence. Every correction we make is listed on Corrections.