Prerequisites
An active AdaptlyPost account sign up
At least one connected social media account
An API token from Settings > API Tokens
Setup for Claude Code & Cursor
Add this to your MCP settings. For Claude Code: <code>~/.claude/settings.json</code>. For Cursor: <code>.cursor/mcp.json</code>.
MCP config
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp",
"headers": {
"Authorization": "Bearer adaptly_your_api_key_here"
}
}
}
}Get your API key from the API Tokens page. Keys start with adaptly_.
Claude Code CLI
claude mcp add --transport http --scope project --header "Authorization: Bearer adaptly_your_api_key_here" -- adaptlypost https://mcp.adaptlypost.com/mcpOr use the Claude Code CLI one-liner:
Setup for Claude Desktop
Claude Desktop requires the <code>mcp-remote</code> bridge for HTTP MCP servers. Add this to your <code>claude_desktop_config.json</code>:
claude_desktop_config.json
{
"mcpServers": {
"adaptlypost": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.adaptlypost.com/mcp",
"--header",
"Authorization: Bearer adaptly_your_api_key_here"
]
}
}
}Setup for other MCP clients
Any MCP client that supports HTTP transport can connect directly.
Endpoint
https://mcp.adaptlypost.com/mcp
Auth header
Authorization: Bearer adaptly_your_api_key_here
Transport
HTTP (Streamable HTTP)
For clients that only support stdio transport, use the <code>mcp-remote</code> bridge as shown in the Claude Desktop section.
Alternative: Agent Skill
For Claude Code, Cursor, Windsurf, and Codex you can also install AdaptlyPost as an agent skill, no MCP configuration needed.
npx skills add adaptlypost/agentInstalls a SKILL.md and CLI script that teaches your agent the AdaptlyPost API. View on GitHub
Tool Reference
The MCP server exposes 12 tools. Your AI discovers these automatically, just ask in plain language.
| Tool | Description | Key params |
|---|---|---|
| list_accounts | List all connected social media accounts with IDs, platforms, and usernames. | None |
| upload_media | Upload media from URLs or base64 data. Returns mediaUrls for create_post. | urls?, files? |
| get_upload_urls | Get presigned upload URLs for direct file uploads to storage. | files (fileName + mimeType) |
| create_post | Create and schedule a post to one or more platforms. | text, platforms, contentType, timezone, scheduledAt?, mediaUrls?, platformTexts?, saveAsDraft?, tiktokConfigs?, youtubeConfigs?, pinterestConfigs? |
| get_post | Get full details of a single post by ID. | id |
| list_posts | List posts with optional filters by platform, status, or date range. | statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset? |
| update_post | Update a scheduled or draft post's caption, schedule, media, or platform configs. | id, text?, platforms?, contentType?, scheduledAt?, mediaUrls?, platformTexts? |
| delete_post | Delete a scheduled or draft post. | id |
| publish_draft | Publish a draft post immediately or schedule it for later. | id, timezone, scheduledAt? |
| list_post_results | Check per-platform posting results, success/failure with error details. | id |
| retry_failed_platforms | Retry publishing on platforms that failed. | id, platformIds |
| bulk_schedule_posts | Schedule multiple posts at once with shared platforms and connection IDs. | platforms, timezone, posts[], connectionIds, platformConfigs? |
Managing access
You can view and revoke API tokens anytime from your API Tokens page. Revoking a token immediately disconnects any agent using it.
Ready to connect?
Copy the config above, paste it into your MCP settings, and start posting from your AI.