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

# Volta MCP Tools Reference — All 16 Agent Bridge Tools

> Complete reference for all 16 MCP tools in Volta: schedule posts, manage channels, pull analytics, upload media, and generate AI content.

Volta exposes 16 tools via the Model Context Protocol, giving AI agents full control over publishing, scheduling, analytics, and channel management. This page is the complete reference for every tool — what it does, what parameters it accepts, and when to use it.

<Note>
  Call `integrationList` first in any agent workflow to discover the channel IDs you need for scheduling and analytics tools.
</Note>

## Read Tools

These tools retrieve data from your Volta organization without making changes.

<Accordion title="integrationList — List connected channels">
  Returns all channels connected to your organization, including their IDs, names, platform types, and connection status.

  **Use this tool** to discover available channel IDs before calling `schedulePostTool` or `analyticsTool`.

  **Returns:** Array of channel objects with `id`, `name`, `providerIdentifier`, and `profile`.

  **Example agent prompt:**

  ```
  List all my connected social media channels.
  ```
</Accordion>

<Accordion title="groupList — List post groups">
  Returns post groups (threads and multi-part content) in your organization.

  **Returns:** Array of group objects with IDs and associated post metadata.
</Accordion>

<Accordion title="integrationSchema — Get channel content schema">
  Returns the content schema for a specific channel — the field definitions, character limits, and media requirements for that platform.

  **Use this tool** before scheduling to understand what fields are required and what limits apply for a given channel.

  **Parameters:**

  * `integrationId` — the channel ID (get from `integrationList`)

  **Returns:** Schema object describing required/optional fields, character limits, and supported media types.
</Accordion>

<Accordion title="postsListTool — List scheduled and published posts">
  Lists posts in your organization with optional filters for status, channel, and date range.

  **Parameters:**

  * `page` — page number (default: 0)
  * `limit` — results per page (default: 20)

  **Returns:** Array of post objects with content, status, scheduled time, and channel info.
</Accordion>

<Accordion title="analyticsTool — Get channel analytics">
  Returns performance analytics for a connected channel over a specified time period.

  **Parameters:**

  * `integrationId` — the channel ID
  * `date` — date string in YYYY-MM-DD format

  **Returns:** Platform-specific analytics data (impressions, reach, engagement). Data availability depends on the platform.

  <Note>
    Not all platforms provide analytics via their API. Use `integrationList` to see which channels support analytics.
  </Note>
</Accordion>

<Accordion title="mediaListTool — List media library files">
  Returns all uploaded media files in your organization's media library.

  **Returns:** Array of media objects with `id`, `url`, `type` (image/video/audio), and upload metadata.
</Accordion>

<Accordion title="tagsTool — List post tags">
  Returns all tags used in your organization for organizing posts.

  **Returns:** Array of tag objects with `id` and `name`.
</Accordion>

***

## Write Tools

These tools create or modify content in your Volta organization.

<Accordion title="schedulePostTool — Schedule a post (primary publishing tool)">
  The primary tool for publishing. Schedules a post to one or more channels at a specified time.

  **Parameters:**

  * `integrationId` — channel ID (from `integrationList`)
  * `content` — post text
  * `date` — ISO 8601 datetime string for scheduled publish time
  * `media` (optional) — array of media IDs from the media library

  **Example agent prompt:**

  ```
  Schedule a post to my Twitter channel tomorrow at 10am saying:
  "Excited to share our Q1 results! Check out the full report at https://example.com"
  ```

  <Tip>
    Call `integrationSchema` first to check character limits and media requirements for the target channel.
  </Tip>
</Accordion>

<Accordion title="triggerTool — Immediately publish a post">
  Triggers immediate publishing of a post without scheduling a future time. Use when you want to publish right now.

  **Parameters:**

  * `postId` — ID of the post to publish
</Accordion>

<Accordion title="uploadFromUrlTool — Import media from URL">
  Downloads a file from a public URL and adds it to the Volta media library. Use this before scheduling posts that need images from the web.

  **Parameters:**

  * `url` — public URL of the file to import (must be HTTPS)

  **Returns:** Media object with `id` and `url` to reference in `schedulePostTool`.

  <Warning>
    The URL must be publicly accessible via HTTPS. Private/internal URLs are blocked by SSRF protection.
  </Warning>
</Accordion>

<Accordion title="generateImageTool — Generate an AI image">
  Generates an AI image and adds it to the media library.

  **Parameters:**

  * `prompt` — text description of the image to generate

  **Returns:** Media object with `id` and `url`.

  <Note>
    Requires image generation to be configured on your Volta instance.
  </Note>
</Accordion>

<Accordion title="generateVideoOptions — Get video generation options">
  Returns the available video generation options and templates configured on your instance. Call this before `generateVideoTool` to discover valid parameter values.
</Accordion>

<Accordion title="generateVideoTool — Generate a video">
  Generates a video using the configured video generation service.

  **Parameters:**

  * `options` — video generation options (get valid values from `generateVideoOptions`)

  **Returns:** Media object once generation is complete.

  <Note>
    Requires video generation to be configured on your Volta instance.
  </Note>
</Accordion>

<Accordion title="videoFunctionTool — Invoke a video function">
  Invokes a specific video generation function step. Used in multi-step video creation workflows.

  **Parameters:**

  * `function` — the function name to invoke
  * `params` — function-specific parameters
</Accordion>

***

## Manage Tools

These tools modify existing posts and channels.

<Accordion title="postsManageTool — Delete, duplicate, or reschedule posts">
  Manages existing posts. Supports three actions: delete, duplicate, and reschedule.

  **Parameters:**

  * `postId` — ID of the post to manage
  * `action` — one of: `delete`, `duplicate`, `reschedule`
  * `date` (for reschedule) — new scheduled datetime in ISO 8601 format
  * `integrationId` (for duplicate) — target channel ID if duplicating to a different channel

  **Example:** Duplicate a post to a different channel:

  ```
  Duplicate post post_abc123 to my LinkedIn channel (ch_xyz789).
  ```
</Accordion>

<Accordion title="channelsManageTool — Enable, disable, or delete channels">
  Manages connected channels. Supports three actions: enable, disable, and delete.

  **Parameters:**

  * `integrationId` — ID of the channel to manage
  * `action` — one of: `enable`, `disable`, `delete`

  <Warning>
    Deleting a channel removes it and all associated posts. This action cannot be undone.
  </Warning>
</Accordion>

***

## Typical Agent Workflow

Most publishing workflows follow this pattern:

<Steps>
  <Step title="Discover channels">
    Call `integrationList` to get the IDs and names of connected channels.
  </Step>

  <Step title="Check content requirements">
    Call `integrationSchema` with your target channel ID to check character limits and required fields.
  </Step>

  <Step title="Prepare media (if needed)">
    Use `uploadFromUrlTool` or `generateImageTool` to add media to the library, then note the returned `id`.
  </Step>

  <Step title="Schedule the post">
    Call `schedulePostTool` with the channel ID, content, scheduled date, and optional media IDs.
  </Step>
</Steps>