> ## Documentation Index
> Fetch the complete documentation index at: https://juicer.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tool Catalog

> The 33 tools exposed by the Juicer MCP Server — account, feeds, sources, posts, moderation, social accounts, analytics, webhooks, team, and social data — grouped by domain.

The Juicer MCP Server exposes **33 tools**, one per public API operation. Every tool runs as your account and respects your plan's limits and permissions. This catalog is grouped by domain; each tool maps to an endpoint in the [API Reference](/api-reference).

## Conventions

* **Destructive tools ask for confirmation.** Tools that delete or hard-delete data are marked destructive in their description, and well-behaved clients confirm with you before running them. Review the action before approving.
* **Team tools need elevated access.** Inviting or removing users and assigning feeds require an owner or manager API key, and an Enterprise or Team plan.
* **Upgrade hints pass through.** When an action exceeds your plan (feed limits, team management), the tool returns a `422` with an actionable upgrade hint that the agent can surface to you.

<Info>
  This catalog reflects the live server's inventory. For the authoritative,
  always-current list, an agent can call the MCP `tools/list` method.
</Info>

## Account

| Tool             | Purpose                                                                                                                 |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `get_account`    | Get the current account's plan, usage, limits, and enabled features.                                                    |
| `list_platforms` | List every supported platform and the term types it accepts (username, hashtag, page URL); call before `create_source`. |

## Feeds

| Tool             | Purpose                                                                                         |
| ---------------- | ----------------------------------------------------------------------------------------------- |
| `list_feeds`     | List all feeds on the account, paginated. Use it to find a feed's id.                           |
| `get_feed`       | Get a single feed's details and moderation settings; pass `include="sources"` to embed sources. |
| `create_feed`    | Create a new, empty feed. Returns its id and slug.                                              |
| `update_feed`    | Update a feed's name and/or moderation settings.                                                |
| `delete_feed`    | Permanently delete a feed and stop serving its embed. **Destructive.**                          |
| `get_feed_embed` | Get the embed snippets (JavaScript, iframe, WordPress shortcode) to place the feed on a site.   |

## Sources

| Tool            | Purpose                                                                                                      |
| --------------- | ------------------------------------------------------------------------------------------------------------ |
| `list_sources`  | List the sources feeding a given feed, with each one's sync status. Paginated.                               |
| `create_source` | Add a source to a feed (Instagram username, Twitter hashtag, Facebook page, …). Call `list_platforms` first. |
| `delete_source` | Remove a source from a feed. Posts already pulled remain unless separately deleted.                          |

## Posts & moderation

| Tool                  | Purpose                                                                                           |
| --------------------- | ------------------------------------------------------------------------------------------------- |
| `list_feed_posts`     | List posts in a feed, paginated; filter by moderation `status`.                                   |
| `get_feed_post`       | Get a single post by id — media, engagement counts, poster, moderation status.                    |
| `moderate_post`       | Moderate one post: `approve`, `reject`, `pin`, `unpin`, or `delete`. `delete` is **destructive**. |
| `bulk_moderate_posts` | Moderate many posts at once by `post_ids` or by `tab`. `hard_delete` is irreversible.             |

## Social accounts

| Tool                                | Purpose                                                                                         |
| ----------------------------------- | ----------------------------------------------------------------------------------------------- |
| `list_social_accounts`              | List OAuth-connected social accounts, including whether each has expired. Paginated.            |
| `get_social_account_status`         | Check per-platform connection status: connected, expired, or available to connect.              |
| `create_social_account_connect_url` | Generate a single-use magic link to connect a social account via OAuth (expires in 30 minutes). |
| `delete_social_account`             | Disconnect a social account. Dependent sources stop syncing. **Confirm first.**                 |

## Analytics

| Tool                 | Purpose                                                                                                    |
| -------------------- | ---------------------------------------------------------------------------------------------------------- |
| `get_feed_analytics` | Engagement stats, source breakdown, and top posts for a feed over a date range (defaults to last 30 days). |

## Search & social data

| Tool                | Purpose                                                                              |
| ------------------- | ------------------------------------------------------------------------------------ |
| `search_posts`      | Full-text search across posts already collected into the account's feeds.            |
| `get_data_posts`    | Data API: look up recent posts for a handle or hashtag across one or more platforms. |
| `get_data_profiles` | Data API: resolve one or more handles to their canonical profile on a platform.      |

## Webhooks

| Tool             | Purpose                                                                                |
| ---------------- | -------------------------------------------------------------------------------------- |
| `list_webhooks`  | List the account's webhook subscriptions with status and failure counts. Paginated.    |
| `create_webhook` | Subscribe an HTTPS endpoint to Juicer events. Returns a signing `secret` (shown once). |
| `update_webhook` | Update a webhook's endpoint or subscribed events.                                      |
| `delete_webhook` | Delete a webhook subscription; delivery stops immediately.                             |
| `test_webhook`   | Send a test event so the user can verify their receiver and signature validation.      |

## Team

Requires an owner or manager API key on an Enterprise or Team plan.

| Tool                 | Purpose                                                                           |
| -------------------- | --------------------------------------------------------------------------------- |
| `list_users`         | List the account's users with roles and feed assignments. Paginated.              |
| `create_user`        | Invite a user as a `manager` (all feeds) or `collaborator` (assigned feeds only). |
| `delete_user`        | Remove a user from the account, revoking access. **Confirm first.**               |
| `assign_user_feed`   | Assign a feed to a user so they can access it. Idempotent.                        |
| `unassign_user_feed` | Remove a user's assignment to a feed, revoking access to it.                      |

## Example prompts

Once connected, just ask:

* *"Create a feed called Summer Campaign and add the Instagram account @nasa to it."*
* *"Show me the most engaged posts in my Brand feed over the last 7 days."*
* *"Anything in the moderation queue for feed 1240? Approve the ones from verified accounts."*
* *"Give me the embed code for my Events feed for WordPress."*
* *"Look up the TikTok and YouTube profiles for the handle 'juicer'."*