# Postiz — how to use (mcp.ai)

Connect your Postiz account and use 9 tools for social media marketing straight from your AI agent. Connect with your own API key. Postiz is an agentic social media scheduling tool. It offers everything you need to manage your social media posts, build an audience, capture leads, and grow your business faster with AI.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_postiz_mcp?ms=1787291340000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `postiz_mcp_ask_postiz`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/postiz_mcp`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/postiz_mcp/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/postiz_mcp/ask/postiz` — Ask agent 'postiz' a question. Agent description: Agent that helps manage and schedule social media posts for users
  - body: { message: string }
- `POST https://api.mcp.ai/api/postiz_mcp/generateimagetool` — Generate image to use in a post,
  - body: { prompt: string }
- `POST https://api.mcp.ai/api/postiz_mcp/generatevideooptions` — All the options to generate videos, some tools might require another call to generateVideoFunction
- `POST https://api.mcp.ai/api/postiz_mcp/generatevideotool` — Generate video to use in a post,
  - body: { output: string, identifier: string, customParams: object[] }
- `POST https://api.mcp.ai/api/postiz_mcp/integrationlist` — This tool list available integrations to schedule posts to
- `POST https://api.mcp.ai/api/postiz_mcp/integrationscheduleposttool` — postiz_mcp
  - body: { socialPost: object[] }
- `POST https://api.mcp.ai/api/postiz_mcp/integrationschema` — Everytime we want to schedule a social media post, we need to understand the schema of the integration.
  - body: { platform: string, isPremium: boolean }
- `POST https://api.mcp.ai/api/postiz_mcp/triggertool` — After using the integrationSchema, we sometimes miss details we can't ask from the user, like ids.
  - body: { dataSchema: object[], methodName: string, integrationId: string }
- `POST https://api.mcp.ai/api/postiz_mcp/videofunctiontool` — Sometimes when we want to generate videos we might need to get some additional information like voice_id, etc
  - body: { identifier: string, functionName: string }

## Example prompts
- "What can I do in Postiz?"
- "Show me a summary of my Postiz account"

## More
- Page: https://mcp.ai/postiz_mcp
- Agent spec (llms.txt): https://mcp.ai/postiz_mcp/llms.txt
- Postman collection: https://mcp.ai/postiz_mcp/postman.json