MCP Setup Guide

Connect AdaptlyPost to your AI assistant in under a minute.

Prerequisites

An active AdaptlyPost account sign up
At least one connected social media account
An API token from Settings > API Tokens

Recommended

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/mcp

Or 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/agent

Installs 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.

Get API Key