# Swiply MCP server: connect Swiply to your AI assistant

> Connect Swiply to Claude, ChatGPT, Claude Code, Codex, Cursor or VS Code with the Swiply MCP server: server URL, OAuth sign-in and setup for each client.

Updated November 17, 2026. Web version: https://swiply.pro/docs/mcp (also in French: https://swiply.pro/fr/docs/mcp, German: https://swiply.pro/de/docs/mcp).

The Swiply MCP server lets Claude, ChatGPT, Cursor or any MCP-compatible assistant use Swiply for you: find what works in your niche, read your stats, publish and schedule on TikTok, Instagram, Facebook, Threads, X and LinkedIn, create carousels and videos, and handle your comments and automated DMs.

It is included in every paid plan. Your assistant sees the tools of your plan and describes them itself once connected, so this page only explains how to connect.

## Server URL

```
https://mcp.swiply.pro/mcp
```

Transport: Streamable HTTP. Sign-in: OAuth, no API key to copy.

## The fastest way: ask your agent

In Claude Code, Codex, Cursor or any agent that can install MCP servers, paste this sentence:

```
Add the Swiply MCP server: https://mcp.swiply.pro/mcp (HTTP transport, OAuth sign-in). Then list my Swiply projects.
```

Your agent adds the server. When it asks you to sign in, a Swiply page opens in your browser: click **Authorize**.

In a browser (Claude on the web, ChatGPT), your assistant cannot add a server by itself: add a **custom connector** with the URL above instead (see "Setup by client").

## Sign-in and permissions

Swiply uses OAuth 2.1. When you connect, your assistant opens swiply.pro in your browser. If you are signed in to Swiply, click **Authorize** and you are done: there is no key to copy.

The consent screen shows two permissions: **read** your Swiply data, and **generate, schedule and publish** on your behalf.

To give read-only access, request the `swiply:read` scope only. Example for Claude Code (`.mcp.json`):

```json
{
  "mcpServers": {
    "swiply": {
      "type": "http",
      "url": "https://mcp.swiply.pro/mcp",
      "oauth": { "scopes": "swiply:read" }
    }
  }
}
```

## Setup by client

### Claude (web and desktop app)

1. Open **Customize > Connectors**.
2. Click **+ Add**, then **Add custom connector**.
3. Name it Swiply, paste `https://mcp.swiply.pro/mcp` and confirm.
4. Click **Connect**, then **Authorize** on the Swiply page.

Available on every Claude plan (the Free plan is limited to one custom connector). On Team and Enterprise, an owner adds the connector in **Organization settings > Connectors**, then each member clicks **Connect**. In a chat, turn Swiply on from the **+** button, then **Connectors**.

### ChatGPT

On the ChatGPT website, add a custom connector (app) with the URL `https://mcp.swiply.pro/mcp`, then sign in to Swiply when ChatGPT asks.

Full access, actions included, is available on Business, Enterprise and Edu workspaces (an admin may need to allow it). On Pro, ChatGPT can only read. Plans and menus change often: see OpenAI's guide, https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt

### Claude Code

```bash
claude mcp add --transport http swiply https://mcp.swiply.pro/mcp
```

Then type `/mcp`, choose **swiply** and **Authenticate**.

### Codex

```bash
codex mcp add swiply --url https://mcp.swiply.pro/mcp
codex mcp login swiply
```

Or in `~/.codex/config.toml`:

```toml
[mcp_servers.swiply]
url = "https://mcp.swiply.pro/mcp"
```

`codex mcp login swiply` opens the Swiply sign-in page.

### Cursor

One-click install: `cursor://anysphere.cursor-deeplink/mcp/install?name=swiply&config=eyJ1cmwiOiJodHRwczovL21jcC5zd2lwbHkucHJvL21jcCJ9`

Or in `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "swiply": {
      "url": "https://mcp.swiply.pro/mcp"
    }
  }
}
```

Cursor opens the Swiply sign-in page the first time it connects.

### VS Code (GitHub Copilot)

Run **MCP: Add Server** from the command palette, choose **HTTP** and paste the URL. Or in `.vscode/mcp.json`:

```json
{
  "servers": {
    "swiply": {
      "type": "http",
      "url": "https://mcp.swiply.pro/mcp"
    }
  }
}
```

VS Code uses the `servers` key, not `mcpServers`.

### Other clients

Any client that supports remote MCP servers: URL `https://mcp.swiply.pro/mcp`, Streamable HTTP transport, OAuth 2.1 with dynamic client registration (scopes `swiply:read` and `swiply:write`).

```json
{
  "mcpServers": {
    "swiply": {
      "type": "http",
      "url": "https://mcp.swiply.pro/mcp"
    }
  }
}
```

## What your assistant can do

- **Inspiration**: find the videos and accounts that work in your niche, analyze a video, get hooks and scripts.
- **Stats**: your dashboard and best posts.
- **Publishing**: publish and schedule on TikTok, Instagram, Facebook, Threads, X and LinkedIn, plus Instagram and Facebook stories.
- **Your files**: send your own videos and images to publish them.
- **Creation**: carousels and videos made with AI.
- **Engagement**: comments and automatic replies, automated DMs and private messages.
- **Projects**: one account per network, grouped by project.

Your assistant only has the tools of your plan. Plans: https://swiply.pro/pricing

## Security

- Your assistant acts only on your Swiply account, with the tools of your plan and the permissions you granted (read only, or read and publish).
- Most clients can ask you to confirm each action: keep that on for publishing.
- To cut access, remove the Swiply connector in your client (Claude, ChatGPT, Cursor...), or run **Clear authentication** in Claude Code (`/mcp`, then **swiply**).

## Troubleshooting

### The connection fails or the Swiply page shows an error

Sign in to swiply.pro in the same browser, check that you have an active paid plan, then start the connection again from your client.

### A tool is missing or refused

It is not included in your plan. Your assistant tells you which plan unlocks it, and the plans are on swiply.pro/pricing.

### My assistant asks me to sign in again

Your session expired or access was removed. Reconnect from your client (in Claude Code: /mcp, swiply, Authenticate).

### Does it work without a paid plan?

No. The MCP server is included in every paid plan: Starter, Growth and Scale.

### I use the old address mcp.swiply.farm

It still works for existing connections. For a new connection, use https://mcp.swiply.pro/mcp.
