# Planly — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/planly

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_planly?ms=1787291220000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/planly/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/planly/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/planly/skill.md
Postman collection (v2.1): https://mcp.ai/planly/postman.json

## Tools
- planly_complete_ai_prompt(n: integer, prompt: string, teamId: string) — 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
- planly_create_team(name: string) — Tool to create a new team in Planly. Use when you need to create a team organization.
- planly_delete_media(ids: string[]) — Tool to delete one or more media files by their IDs. Use when you need to remove media files from Planly storage.
- planly_delete_team(team_id: string) — Tool to delete a team by its ID. Use when you need to permanently remove a team from Planly.
- planly_edit_team(name: string, teamId: string) — Tool to edit team details such as name in Planly. Use when you need to update an existing team's information.
- planly_get_ai_credits(teamId: string) — Tool to retrieve available AI credits left in a team. Use when you need to check the remaining AI credits for a specific team.
- planly_get_team(id: string) — 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
- planly_import_media_from_url(url: string, teamId: string) — 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.
- planly_list_channels(team_id: string) — 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.
- planly_list_media(team_id: string, pagination?: object) — 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.
- planly_list_schedule_groups(ids?: string[], filter?: object, teamId: string, dateRange?: object, pagination?: object) — 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
- planly_list_schedules(teamId: string, pagination?: object) — 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
- planly_list_team_users(id: string) — 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.
- 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.
- planly_start_media_upload(teamId: string, fileName?: string, contentType?: string, contentLength: integer) — 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

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

## Links
Docs: https://mcp.ai/docs/mcps/planly
Website: https://mcp.ai/mcps/planly