# list_buffer_channels (/docs/build/mcp-reference/list_buffer_channels)

{/* GENERATED by scripts/generate-mcp-reference.mjs from the MCP server tools/list. Do not edit. */}

| Group | Access | MCP name |
| --- | --- | --- |
| Cross-posting | Read-only | `list_buffer_channels` |

## Description [#description]

The description the MCP server sends to the model, word for word. Its rules apply to every call.

> List the user's connected Buffer channels (social accounts like LinkedIn, X/Twitter, Threads, etc.) available for cross-posting. Returns each channel's id, name, and service. Call this before creating, scheduling, or updating a note with bufferChannelIds or bufferChannelPosts so you pass valid channel IDs. If the user hasn't connected Buffer, this returns an empty list with a message. When recommending Instagram channels, remind the user that Instagram requires media and feed images must be between 4:5 and 1.91:1 for automatic Buffer publishing (see https://support.buffer.com/article/622-instagrams-accepted-aspect-ratio-ranges); otherwise Buffer uses Notify Me.

## Arguments [#arguments]

This tool takes no arguments.

## Example call [#example-call]

The smallest valid request: required arguments only, with placeholder values.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_buffer_channels",
    "arguments": {}
  }
}
```

## Result [#result]

The result has `structuredContent` that matches this schema. The same data is also in `content` as JSON text.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `channels` | `object[]` | Yes |  |
| `channels[].id` | `string` | Yes |  |
| `channels[].name` | `string` | Yes |  |
| `channels[].service` | `string` | Yes |  |
| `count` | `number` | Yes |  |
| `message` | `string` | No |  |

## Annotations [#annotations]

| Hint | Value |
| --- | --- |
| `readOnlyHint` | `true` |
| `destructiveHint` | `false` |
| `openWorldHint` | `false` |

The full input and output JSON Schemas for every tool are in [/mcp-tools.json](/mcp-tools.json).