Skip to main content

Works with AI · Verified

Smash Balloon logo

Manage Smash Balloon Social Feeds with AI

Connect Smash Balloon's Instagram, Facebook, X (Twitter), YouTube, Reviews and TikTok feed plugins to Claude, ChatGPT, or any AI assistant with WPVibe. Create Instagram feeds and place them on your pages, match them to your design, find out why a feed stopped updating, and check every Smash Balloon feed at once, by asking in plain English.

70 verified abilities Last verified Nov 5, 2026

What your AI can do with Smash Balloon

One connection gives your assistant structured, permission-checked access to the whole site.

Put a feed on a page

Check which Instagram accounts are connected, create the feed with your columns and post count, and place it on the page you name.

Match your design

Columns, post counts, button colors and a background, with Instagram Feed reporting every change it saved and the old values kept in the chat.

Check every feed at once

One read-only pass over Instagram, Facebook, X, YouTube, Reviews and TikTok: what is connected, what is broken or empty, and where each feed shows.

Find out why a feed went stale

Account errors, expiry and the refresh schedule in one pass, without the AI ever seeing an access token.

Tune Instagram refresh and loading

Change how often Instagram feeds refresh, and load the stylesheet only on pages that show a feed.

You keep the keys

Connecting an account and deleting a feed happen in your browser through one-time links. AI writes stay off until you turn them on in each plugin.

Things to ask

Paste any of these into Claude or ChatGPT once Smash Balloon is connected.

“Check every Smash Balloon feed on my site and tell me which ones are broken or empty.”
“Put my Instagram feed on the homepage above the footer: four columns, eight posts.”
“Make the homepage Instagram feed three columns on desktop and two on mobile, with buttons in my brand green.”
“My Instagram feed stopped showing new posts. Check the connected accounts and the refresh schedule and tell me why.”

Up and running in three steps

1

Install WPVibe

Add the free WPVibe plugin from WordPress.org to the site running Smash Balloon.

2

Connect your AI

Claude, ChatGPT, Cursor, and more. One click to authorize, and no passwords ever go in the chat.

3

Ask in plain English

“Check every Smash Balloon feed on my site and tell me which ones are broken or empty.”

Verified Smash Balloon recipes

Copy-paste playbooks, each one tested on a live Smash Balloon install before it ships.

Every Smash Balloon ability

Smash Balloon registers these with the WordPress Abilities API under the instagram-feed namespace. Your AI finds them with discover_abilities and calls them with run_ability. WPVibe asks for your approval only when an ability is marked destructive and deletes something or runs code; everything else runs as soon as your AI calls it. Verified means we ran it on a live install. Registered means a fresh install ships it and we have not run it yet.

Requires WordPress 6.9 or newer. Abilities come with Smash Balloon Social Photo Feed (Instagram) 6.15 or Instagram Feed Pro 6.14, Social Post Feed (Facebook) 4.15, Custom Twitter Feeds 2.11, Feeds for YouTube 2.11, Reviews Feed 2.16 and Feeds for TikTok 1.9. Each plugin has its own namespace: instagram-feed, facebook-feed, twitter-feed, youtube-feed, reviews-feed and tiktok-feeds. Writes need MCP Write Access turned on in each plugin's Settings > General. Verified on the free builds (Instagram 6.15.1, Facebook 4.15.1, Twitter 2.11.1, YouTube 2.11.1, Reviews 2.17.0, TikTok 1.9.1), and the Instagram recipes also on Instagram Feed Pro 6.14.0; the other Pro builds were not part of this check. Real posts were shown for Instagram only: with no Facebook, YouTube or TikTok account connected, the abilities that set a feed's account there ran only their refusal and are marked Registered. Reviews Feed ran on a test source; no real reviews were fetched.

Ability What it does Access Status

Instagram: list feeds

instagram-feed/list-feeds
The feeds made in the Feed Builder with their id, name and shortcode. Read Verified

Instagram: get a feed

instagram-feed/get-feed
One feed's settings and the accounts it pulls from. Read Verified

Instagram: list connected accounts

instagram-feed/list-sources
The accounts connected to the site, with errors and expiry. Read Verified

Instagram: get global settings

instagram-feed/get-global-settings
The plugin-wide settings: caching, GDPR mode, image handling and loading. Read Verified

Instagram: describe editable settings

instagram-feed/describe-settings-schema
Every editable setting with its allowed values, which ones need Pro, and whether write access is on. Read Verified

Instagram: list Pro features

instagram-feed/get-pro-features
What the Pro edition adds, with the settings each feature unlocks. Read Verified

Instagram: update feed settings

instagram-feed/update-feed-settings
Changes only the settings you pass. Write Verified

Instagram: update global settings

instagram-feed/update-global-settings
Changes plugin-wide settings and reports what was updated and ignored. Write Verified

Instagram: request a feed deletion

instagram-feed/request-feed-deletion
Returns a one-time link, valid 15 minutes. Write Verified

Instagram: create a feed

instagram-feed/create-feed
Creates a feed of connected accounts' own posts with quick settings. Write Verified

Instagram: set a feed's accounts

instagram-feed/set-feed-sources
Replaces the accounts a feed shows with accounts already connected. Write Verified

Instagram: set a color palette

instagram-feed/set-color-palette
Inherit, light, dark or custom. Write Verified

Instagram: get a connect link

instagram-feed/get-connect-url
A one-time link, valid 15 minutes, that an admin opens in their browser to connect an Instagram account. Write Verified

Instagram Pro: set highlighted posts

instagram-feed/set-highlight-source
Instagram Feed Pro only. Write Verified

Facebook: list feeds

facebook-feed/list-feeds
The feeds made in the Feed Builder with their id, name and shortcode. Read Verified

Facebook: get a feed

facebook-feed/get-feed
One feed's settings and the pages and groups it pulls from. Read Verified

Facebook: list connected pages and groups

facebook-feed/list-sources
The pages and groups connected to the site, with errors and expiry. Read Verified

Facebook: get global settings

facebook-feed/get-global-settings
The plugin-wide settings: caching, GDPR mode, image handling and loading. Read Verified

Facebook: describe editable settings

facebook-feed/describe-settings-schema
Every editable setting with its allowed values, which ones need Pro, and whether write access is on. Read Verified

Facebook: list Pro features

facebook-feed/get-pro-features
What the Pro edition adds, with the settings each feature unlocks. Read Verified

Facebook: update feed settings

facebook-feed/update-feed-settings
Changes only the settings you pass. Write Verified

Facebook: update global settings

facebook-feed/update-global-settings
Changes plugin-wide settings and reports what was updated and ignored. Write Verified

Facebook: request a feed deletion

facebook-feed/request-feed-deletion
Returns a one-time link, valid 15 minutes. Write Verified

Facebook: create a feed

facebook-feed/create-feed
Creates a feed, with or without a connected page or group. Write Verified

Facebook: set a feed's page or group

facebook-feed/set-feed-sources
Sets the connected page or group a feed shows; one per feed on the free plugin. Write Registered

Facebook: get a connect link

facebook-feed/get-connect-url
A one-time link, valid 15 minutes, that an admin opens in their browser to connect a Facebook page or group. Write Verified

X (Twitter): list feeds

twitter-feed/list-feeds
The feeds made in the Feed Builder with their id, name and shortcode. Read Verified

X (Twitter): get a feed

twitter-feed/get-feed
One feed's settings and the @handles it shows. Read Verified

X (Twitter): list connected account

twitter-feed/list-sources
Whether an X account is connected, and its handle. Read Verified

X (Twitter): get global settings

twitter-feed/get-global-settings
The plugin-wide settings: caching, GDPR mode, image handling and loading. Read Verified

X (Twitter): describe editable settings

twitter-feed/describe-settings-schema
Every editable setting with its allowed values, which ones need Pro, and whether write access is on. Read Verified

X (Twitter): list Pro features

twitter-feed/get-pro-features
What the Pro edition adds, with the settings each feature unlocks. Read Verified

X (Twitter): update feed settings

twitter-feed/update-feed-settings
Changes only the settings you pass. Write Verified

X (Twitter): update global settings

twitter-feed/update-global-settings
Changes plugin-wide settings and reports what was updated and ignored. Write Verified

X (Twitter): request a feed deletion

twitter-feed/request-feed-deletion
Returns a one-time link, valid 15 minutes. Write Verified

X (Twitter): create a feed

twitter-feed/create-feed
Creates a feed of the connected account's timeline. Write Verified

X (Twitter): set the handles

twitter-feed/set-feed-type-and-terms
Points a feed at one or more @handles. Write Verified

X (Twitter): get a connect link

twitter-feed/get-connect-url
A one-time link, valid 15 minutes, that an admin opens in their browser to connect an X account. Write Verified

YouTube: list feeds

youtube-feed/list-feeds
The feeds made in the Feed Builder with their id, name and shortcode. Read Verified

YouTube: get a feed

youtube-feed/get-feed
One feed's settings and the channels it pulls from. Read Verified

YouTube: list connected channels

youtube-feed/list-sources
The connected channels with expiry and whether each is valid, and, with an API key saved, the channels feeds use. Read Verified

YouTube: get global settings

youtube-feed/get-global-settings
The plugin-wide settings: caching, GDPR mode, image handling and loading. Read Verified

YouTube: describe editable settings

youtube-feed/describe-settings-schema
Every editable setting with its allowed values, which ones need Pro, and whether write access is on. Read Verified

YouTube: list Pro features

youtube-feed/get-pro-features
What the Pro edition adds, with the settings each feature unlocks. Read Verified

YouTube: update feed settings

youtube-feed/update-feed-settings
Changes only the settings you pass. Write Verified

YouTube: update global settings

youtube-feed/update-global-settings
Changes plugin-wide settings and reports what was updated and ignored. Write Verified

YouTube: request a feed deletion

youtube-feed/request-feed-deletion
Returns a one-time link, valid 15 minutes. Write Verified

YouTube: create a feed

youtube-feed/create-feed
Creates a feed from one connected channel, or any channel id when a YouTube API key is saved. Write Registered

YouTube: set a feed's channel

youtube-feed/set-feed-type-and-source
Sets the channel a feed shows. Write Registered

YouTube: get a connect link

youtube-feed/get-connect-url
A one-time link, valid 15 minutes, that an admin opens in their browser to connect a YouTube channel. Write Verified

Reviews: list feeds

reviews-feed/list-feeds
The feeds made in the Feed Builder with their id, name and how many sources each uses. Read Verified

Reviews: get a feed

reviews-feed/get-feed
One feed's settings and the review sources it pulls from. Read Verified

Reviews: list connected review sources

reviews-feed/list-sources
The review sources added in wp-admin: provider, business name, rating, review count and errors. Read Verified

Reviews: get global settings

reviews-feed/get-global-settings
The plugin-wide settings: image optimization, script loading, review schema markup and GDPR mode. Read Verified

Reviews: describe editable settings

reviews-feed/describe-settings-schema
Every editable setting with its allowed values, which ones need Pro, and whether write access is on. Read Verified

Reviews: list Pro features

reviews-feed/get-pro-features
What the Pro edition adds, with the settings each feature unlocks. Read Verified

Reviews: update feed settings

reviews-feed/update-feed-settings
Changes only the settings you pass. Write Verified

Reviews: update global settings

reviews-feed/update-global-settings
Changes plugin-wide settings and reports what was updated and ignored. Write Verified

Reviews: request a feed deletion

reviews-feed/request-feed-deletion
Returns a one-time link, valid 15 minutes. Write Verified

Reviews: create a feed

reviews-feed/create-feed
Creates a feed from review sources already added in wp-admin. Write Verified

Reviews: set a feed's sources

reviews-feed/set-feed-sources
Replaces the review sources a feed shows with sources already added. Write Verified

Reviews: set the review button link

reviews-feed/set-header-button-link
Points the header button at the Google review page of a connected source, or at a link you give. Write Verified

TikTok: list feeds

tiktok-feeds/list-feeds
The feeds made in the Feed Builder with their id, name and shortcode. Read Verified

TikTok: get a feed

tiktok-feeds/get-feed
One feed's settings and the accounts it pulls from. Read Verified

TikTok: list connected accounts

tiktok-feeds/list-sources
The accounts connected to the site, with errors and expiry. Read Verified

TikTok: get global settings

tiktok-feeds/get-global-settings
The plugin-wide settings: image optimization, GDPR mode and whether settings are kept on uninstall. Read Verified

TikTok: describe editable settings

tiktok-feeds/describe-settings-schema
Every editable setting with its allowed values, which ones need Pro, and whether write access is on. Read Verified

TikTok: list Pro features

tiktok-feeds/get-pro-features
What the Pro edition adds, with the settings each feature unlocks. Read Verified

TikTok: update feed settings

tiktok-feeds/update-feed-settings
Changes only the settings you pass. Write Verified

TikTok: update global settings

tiktok-feeds/update-global-settings
Changes plugin-wide settings and reports what was updated and ignored. Write Verified

TikTok: request a feed deletion

tiktok-feeds/request-feed-deletion
Returns a one-time link, valid 15 minutes. Write Verified

TikTok: create a feed

tiktok-feeds/create-feed
Creates a feed, with or without a connected account. Write Verified

TikTok: set a feed's account

tiktok-feeds/set-feed-sources
Sets the connected account a feed shows. Write Registered

TikTok: get a connect link

tiktok-feeds/get-connect-url
A one-time link, valid 15 minutes, that an admin opens in their browser to connect a TikTok account. Write Verified

What we learned testing it

Behavior the ability descriptions do not mention.

  • AI writes are off in each plugin until a site admin turns on MCP Write Access in that plugin's Settings > General. While it is off a write fails with: AI write access is disabled, even though the AI may still see the write abilities listed through WPVibe. Turning it off cancels every connect and deletion link still waiting.
  • Connecting an account is always a browser step. get-connect-url gives a link that works once and expires after 15 minutes; the admin opens it where they are logged in to wp-admin and finishes the login. Reviews Feed has no connect link: review sources are added in its own screen in wp-admin.
  • The AI cannot delete a feed. request-feed-deletion returns a link, and each admin can have only one deletion waiting: asking for another cancels the first link.
  • Feed changes show on the site right away. There is no draft, so ask the AI to note the current values before it changes them.
  • A call that includes a setting this edition does not have is rejected whole, and nothing is saved. describe-settings-schema lists the Pro-only settings under pro_only; on the free Instagram plugin that includes layouts, captions, a centered header and link colors, and create-feed has no template picker.
  • The free plugins have these limits: X (Twitter) allows one feed and user timelines only; TikTok allows two feeds; Facebook shows one page or group per feed; YouTube shows one channel per feed, and create-feed needs a connected channel or a YouTube API key saved in its settings; Reviews shows up to 10 of the latest reviews for one Google or Yelp business.
  • A feed can be created before any account is connected (Instagram, Facebook, X, TikTok). Visitors then see nothing where it sits, except an X feed, which shows "Twitter feed is not available at the moment."
  • On Instagram, a custom palette that sets the Follow button color makes Instagram Feed ignore the Follow button's own colors, text color included, though update-feed-settings reports them as updated. Sending an empty custom color does not clear one that is set. Use the inherit palette with per-button colors when the text color matters.
  • An Instagram feed page loads as many posts as the larger of num (desktop) and nummobile (mobile), which is 20 until it is set. Set both.
  • GDPR mode is writable by the AI in the free builds we tested; on Instagram Feed Pro 6.14.0 it is read-only. It affects legal compliance, so confirm a change with the site owner first.
  • WPVibe asks for no approval before any of these abilities. set-feed-sources (and set-feed-type-and-terms or set-feed-type-and-source) replaces the accounts a feed shows at once, and request-feed-deletion only returns a link, so nothing is deleted until an admin confirms in the browser.
  • There is no clear-cache ability. In the free builds of Instagram Feed and Facebook Feed, saving global settings clears every feed's cache, and in Instagram Feed saving a feed clears that feed's cached copy (its posts are fetched again only when the post count, sort or image size changes); the other plugins clear less or nothing on a save, so clear the cache from the plugin's own Settings screen.
  • On X (Twitter) the caching schedule is read-only to the AI; change it in the plugin's settings screen.
  • Instagram list-sources can show a connect type of "personal" on a working Business account; the account type is what matters. An expiry date of 2037-12-30 is a placeholder for a connection with no expiry date.
  • Highlight layouts and highlighted posts are Instagram Feed Pro only (set-highlight-source), verified on Pro 6.14.0. Setting one kind of highlight (hashtag, pattern or post IDs) clears the values saved for the others. A hashtag works with or without the #.

Verified, and kept that way

Works with AI is WPVibe’s verification program. Every ability marked verified was run on a live Smash Balloon install, and we rescan WordPress.org weekly so a release that adds or removes abilities shows up here before it surprises you.

Learn more about Smash Balloon at smashballoon.com.