---
title: "MCP Setup Guide"
description: "Connect AdaptlyPost to Claude, Cursor, Windsurf, or any MCP-compatible AI assistant. Setup in under a minute."
url: "https://adaptlypost.com/features/agents/docs"
---

[Back to AI Agents](https://adaptlypost.com/features/agents)

# MCP Setup Guide

Connect AdaptlyPost to your AI assistant in under a minute.

## Prerequisites

* An active AdaptlyPost account [sign up](https://adaptlypost.com/signup)
* At least one connected social media account
* An API token from [Settings > API Tokens](https://adaptlypost.com/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](https://adaptlypost.com/api-tokens). 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](https://github.com/adaptlypost/agent)

## 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](https://adaptlypost.com/api-tokens). 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.

[Sign Up](https://adaptlypost.com/signup)[Get API Key](https://adaptlypost.com/api-tokens)