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

# MCP overview

> Connect AI clients to PostlyBee through Streamable HTTP and OAuth 2.1.

PostlyBee provides a Model Context Protocol server for AI clients that can inspect connected accounts and posts, validate platform requirements, schedule content, update provider settings, and generate media.

## Endpoint

```text theme={null}
https://api.postlybee.com/mcp
```

The modern endpoint uses stateless Streamable HTTP. Compatible clients can discover PostlyBee's OAuth 2.1 metadata automatically and request `mcp:read` and `mcp:write` scopes.

## Authentication options

<CardGroup cols={2}>
  <Card title="OAuth connection" icon="shield-check">
    Recommended for clients that support protected-resource discovery, dynamic
    client registration, and PKCE S256.
  </Card>

  <Card title="Workspace API key" icon="key">
    Use `Authorization: Bearer YOUR_API_KEY` in clients that accept a static
    header configuration.
  </Card>
</CardGroup>

<Note>
  OAuth access tokens and workspace REST API keys are separate credentials. Both
  use the Bearer header at the MCP endpoint.
</Note>

## Available capabilities

The modern MCP server exposes tools for:

* Listing connected social accounts and validating provider schemas.
* Listing posts within a UTC date range.
* Scheduling posts after user confirmation.
* Updating provider-specific settings for drafts and queued posts.
* Discovering video options and running helper functions.
* Generating images and videos.

Write tools require the `mcp:write` scope. Read-only inspection tools require `mcp:read`. Post deletion is not available through MCP.

## Legacy endpoint

The older API-key SSE endpoint remains available for existing clients:

```text theme={null}
https://api.postlybee.com/mcp/YOUR_API_KEY/sse
```

New integrations should use the Streamable HTTP endpoint instead because it supports modern MCP discovery and OAuth.