Connect AI Agents to Volta via the MCP Server Tools

Volta implements the Model Context Protocol, giving AI agents a standard, structured interface to the full publishing surface. Instead of writing custom API calls, your agent receives 16 named tools — covering scheduling, analytics, media, channel management, and AI content generation — that any MCP-compatible runtime can discover and invoke automatically. Whether you’re running Claude Code locally, deploying an agent on a server, or building an agentic pipeline with a custom runtime, Volta’s MCP server is the fastest path to social publishing from AI.

Connection methods

Volta supports five MCP connection methods to accommodate different clients and security requirements.

Method	Endpoint	Auth
URL key (simplest)	`/mcp/:apiKey`	API key in URL
Bearer token	`/mcp`	`Authorization: Bearer API_KEY`
SSE streaming	`/sse/:apiKey`	API key in URL
OAuth 2.1 + PKCE	`/mcp-oauth`	Full OAuth flow
Info (public)	`/mcp/info`	None — shows quickstart configs

Connecting Claude Code

Get your API key

In the Volta dashboard, go to Settings → API Keys → Create New Key. Copy the key value immediately — it’s shown only once. See Authentication for full details.

Add Volta to your MCP config

Open (or create) your Claude Code MCP configuration file — typically .mcp.json at the root of your project or in your global Claude config directory.

{
  "mcpServers": {
    "volta": {
      "url": "https://your-instance.com/mcp/your-api-key"
    }
  }
}

Replace your-instance.com with your Volta instance URL and your-api-key with the key you just created.

Restart Claude Code

Claude Code picks up MCP config changes on restart. Once restarted, you’ll see the Volta tools available in the tool list. Ask Claude to “list my Volta channels” to verify the connection.

Connecting Cursor and other MCP clients

Most MCP clients use the same JSON structure. Add the Volta server under your client’s mcpServers key:

{
  "mcpServers": {
    "volta": {
      "url": "https://your-instance.com/mcp/your-api-key"
    }
  }
}

If your client supports custom headers and you prefer not to embed the key in the URL, use the Bearer token endpoint instead:

{
  "mcpServers": {
    "volta": {
      "url": "https://your-instance.com/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

Getting the quickstart config for your instance

Every Volta instance exposes a public endpoint that returns ready-made MCP config snippets for the most common clients. No authentication is required.

GET https://your-instance.com/mcp/info

The response includes pre-formatted config for Claude Code, Cursor, and other clients — with your instance URL already filled in. Visit this endpoint in your browser or fetch it with curl to copy the exact config for your deployment.

Share the /mcp/info URL with anyone on your team who needs to connect their agent. It’s public, doesn’t expose credentials, and always reflects the current instance URL.

Available tools

Volta exposes 16 tools across three categories. See the Tools reference for full parameter documentation and examples.

Read tools (7)

These tools retrieve information from your Volta organization. Start with integrationList in any workflow to get valid channel IDs.

Tool	Description
`integrationList`	Lists all connected channels with IDs, names, and platform types
`groupList`	Returns post groups and threads
`integrationSchema`	Returns the content schema for a specific channel
`postsListTool`	Lists scheduled and published posts
`analyticsTool`	Returns analytics for a channel over a time period
`mediaListTool`	Lists uploaded media files in the library
`tagsTool`	Returns all tags used in your organization

Write tools (7)

These tools create or modify content. Use schedulePostTool as your primary publishing tool.

Tool	Description
`schedulePostTool`	Schedules a post to one or more channels
`triggerTool`	Immediately publishes a post
`uploadFromUrlTool`	Downloads media from a URL into the media library
`generateImageTool`	Generates an AI image (requires image generation configured)
`generateVideoTool`	Generates a video from options
`generateVideoOptions`	Returns available video generation options
`videoFunctionTool`	Invokes a specific video generation function

Manage tools (2)

These tools modify the state of existing posts and channels.

Tool	Description
`postsManageTool`	Delete, duplicate, or reschedule an existing post
`channelsManageTool`	Enable, disable, or delete a connected channel

​Connection methods

​Connecting Claude Code

​Connecting Cursor and other MCP clients

​Getting the quickstart config for your instance

​Available tools

Connection methods

Connecting Claude Code

Connecting Cursor and other MCP clients

Getting the quickstart config for your instance

Available tools