MCP Setup Guide

Name: AdaptlyPost
Author: AdaptlyPost

Connect AdaptlyPost to your AI assistant in under a minute. Paste the URL, sign in when prompted, and start posting.

Prerequisites

An active AdaptlyPost account sign up
At least one connected social media account
Optional: an API token for headless agents and clients without OAuth, from Settings > API Tokens

Setup for Claude Code & Cursor

Add this to your MCP settings and sign in when the browser opens. 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"
    }
  }
}

Claude Code CLI

claude mcp add --transport http adaptlypost https://mcp.adaptlypost.com/mcp

Or use the Claude Code CLI one-liner. It opens the sign-in page on first use:

API key alternative

{
  "mcpServers": {
    "adaptlypost": {
      "type": "http",
      "url": "https://mcp.adaptlypost.com/mcp",
      "headers": {
        "Authorization": "Bearer adaptly_your_key"
      }
    }
  }
}

For headless agents or clients without OAuth, add an Authorization header with a token from the API Tokens page. Keys start with adaptly_.

Setup for Claude Desktop

Claude Desktop connects through the <code>mcp-remote</code> bridge, which opens the sign-in page for you. 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"]
    }
  }
}

Setup for Other MCP Clients

Any MCP client that supports HTTP transport can connect directly.

Endpoint

https://mcp.adaptlypost.com/mcp

Auth

Transport

HTTP (Streamable HTTP)

Without a Bearer header the server answers 401 with a WWW-Authenticate header, so OAuth-capable clients open the sign-in page on their own.

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 18 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?
get_analytics_overview	Views, likes, comments, shares, followers and engagement rate for a date window, each compared with the previous window.	from, to, platforms?
get_analytics_timeseries	The same metrics bucketed by day, week or month for trend questions.	from, to, platforms?, granularity?
get_platform_breakdown	The same metrics split per platform, with the metrics each platform reports.	from, to
list_post_analytics	Per-post metrics sortable by any metric. Top posts and "how did this post do".	from, to, platforms?, sortBy?, page?, limit?
get_analytics_sync_status	When each account last synced and whether one needs reconnecting for analytics.	None
trigger_analytics_sync	Refresh analytics now. Once per 10 minutes per workspace.	None

Managing Access

Signed-in agents lose access when you remove the connector in your client or sign out. API tokens can be viewed and revoked anytime from your API Tokens page. Revoking a token immediately disconnects any agent using it.

Ready to Connect?

Paste the URL into your MCP settings, sign in once, and start posting from your AI.

Get API Key