# Planly — how to use (mcp.ai)

Connect your Planly account and use 15 tools for social media marketing straight from your AI agent. Connect with your own API key. All-in-one social media management tool for scheduling and managing content across multiple platforms.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_planly?ms=1787291160000`
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. `planly_complete_ai_prompt`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/planly`
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/planly/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/planly/complete/ai/prompt` — Tool to complete a text prompt using AI. Generates AI-powered text completions based on the provided prompt. Use when you need to generate creative content, complete text, or get AI suggestions for wr
  - body: { n: integer, prompt: string, teamId: string }
- `POST https://api.mcp.ai/api/planly/create/team` — Tool to create a new team in Planly. Use when you need to create a team organization.
  - body: { name: string }
- `POST https://api.mcp.ai/api/planly/delete/media` — Tool to delete one or more media files by their IDs. Use when you need to remove media files from Planly storage.
  - body: { ids: string[] }
- `POST https://api.mcp.ai/api/planly/delete/team` — Tool to delete a team by its ID. Use when you need to permanently remove a team from Planly.
  - body: { team_id: string }
- `POST https://api.mcp.ai/api/planly/edit/team` — Tool to edit team details such as name in Planly. Use when you need to update an existing team's information.
  - body: { name: string, teamId: string }
- `POST https://api.mcp.ai/api/planly/get/ai/credits` — Tool to retrieve available AI credits left in a team. Use when you need to check the remaining AI credits for a specific team.
  - body: { teamId: string }
- `POST https://api.mcp.ai/api/planly/get/team` — Tool to retrieve detailed information about a specific team including permissions, limits, and integrations. Use when you need to access team configuration, member counts, channel status, or integrati
  - body: { id: string }
- `POST https://api.mcp.ai/api/planly/import/media/from/url` — Tool to import media from a URL to your team. Use when you need to add external media (video/mp4, image/png, image/jpeg, image/webp) to a team's media library.
  - body: { url: string, teamId: string }
- `POST https://api.mcp.ai/api/planly/list/channels` — Tool to list all social media channels connected to a team. Use when you need to retrieve channel details including name, picture, social network type, status, and scopes.
  - body: { team_id: string }
- `POST https://api.mcp.ai/api/planly/list/media` — Tool to retrieve a paginated list of media files in a team. Use when you need to fetch media assets, browse uploaded files, or implement media management features with cursor-based pagination.
  - body: { team_id: string, pagination?: object }
- `POST https://api.mcp.ai/api/planly/list/schedule/groups` — Tool to retrieve a list of schedule groups for a team with comprehensive filtering and pagination. Use when you need to view scheduled posts, filter by channels, status, social networks, media type, o
  - body: { ids?: string[], filter?: object, teamId: string, dateRange?: object, pagination?: object }
- `POST https://api.mcp.ai/api/planly/list/schedules` — Tool to retrieve a paginated list of schedules in a specified team. Use when you need to fetch schedules with support for pagination, custom ordering, and configurable page size. Returns schedule data
  - body: { teamId: string, pagination?: object }
- `POST https://api.mcp.ai/api/planly/list/team/users` — Tool to list all users that belong to a specific team. Returns user details including id, fullname, picture, email, and role. Use when you need to retrieve the complete roster of team members.
  - body: { id: string }
- `POST https://api.mcp.ai/api/planly/list/teams` — Tool to retrieve all teams that the authenticated user belongs to. Use when you need to get team details including id, name, picture, role, number of users, and number of channels.
- `POST https://api.mcp.ai/api/planly/start/media/upload` — Tool to start the upload process for a media file. Returns a pre-signed upload URL where the file should be uploaded using a PUT request. Use when you need to prepare for uploading images or videos to
  - body: { teamId: string, fileName?: string, contentType?: string, contentLength: integer }

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

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