Skip to main 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.
Call integrationList first in any agent workflow to discover the channel IDs you need for scheduling and analytics tools.

​
Read Tools

These tools retrieve data from your Volta organization without making changes.
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.
Returns post groups (threads and multi-part content) in your organization.Returns: Array of group objects with IDs and associated post metadata.
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.
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.
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.
Not all platforms provide analytics via their API. Use integrationList to see which channels support analytics.
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.
Returns all tags used in your organization for organizing posts.Returns: Array of tag objects with id and name.

​
Write Tools

These tools create or modify content in your Volta organization.
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"
Call integrationSchema first to check character limits and media requirements for the target channel.
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
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.
The URL must be publicly accessible via HTTPS. Private/internal URLs are blocked by SSRF protection.
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.
Requires image generation to be configured on your Volta instance.
Returns the available video generation options and templates configured on your instance. Call this before generateVideoTool to discover valid parameter values.
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.
Requires video generation to be configured on your Volta instance.
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

​
Manage Tools

These tools modify existing posts and channels.
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).
Manages connected channels. Supports three actions: enable, disable, and delete.Parameters:
  • integrationId — ID of the channel to manage
  • action — one of: enable, disable, delete
Deleting a channel removes it and all associated posts. This action cannot be undone.

​
Typical Agent Workflow

Most publishing workflows follow this pattern:
1

Discover channels

Call integrationList to get the IDs and names of connected channels.
2

Check content requirements

Call integrationSchema with your target channel ID to check character limits and required fields.
3

Prepare media (if needed)

Use uploadFromUrlTool or generateImageTool to add media to the library, then note the returned id.
4

Schedule the post

Call schedulePostTool with the channel ID, content, scheduled date, and optional media IDs.