> ## 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.

# Connect AI Agents to Volta via the MCP Server Tools

> Volta's MCP server exposes 16 tools for AI agents. Connect Claude Code, Codex, or any MCP runtime to publish content from your agent.

Volta implements the [Model Context Protocol](https://modelcontextprotocol.io), 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

<Steps>
  <Step title="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](/agent/authentication) for full details.
  </Step>

  <Step title="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.

    ```json theme={null}
    {
      "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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Connecting Cursor and other MCP clients

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

```json theme={null}
{
  "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:

```json theme={null}
{
  "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.

```bash theme={null}
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.

<Tip>
  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.
</Tip>

## Available tools

Volta exposes 16 tools across three categories. See the [Tools reference](/agent/mcp/tools) for full parameter documentation and examples.

<AccordionGroup>
  <Accordion title="Read tools (7)" icon="magnifying-glass">
    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                       |
  </Accordion>

  <Accordion title="Write tools (7)" icon="pen-to-square">
    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                 |
  </Accordion>

  <Accordion title="Manage tools (2)" icon="sliders">
    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    |
  </Accordion>
</AccordionGroup>