Skip to main content

MCP: Connect Swat.io with ChatGPT & Claude

Written by Florian Triller-Windisch

With the Model Context Protocol (MCP), you can connect Swat.io with LLMs such as ChatGPT and Claude. This allows the AI tool or agent to interact with your Swat.io account using your own Swat.io API token - for example to prepare content or schedule posts in advance.

Important: As Swat.io API access is a prerequisite for using MCP, this feature is available to customers on a Medium, Large or Custom plan. You can find an overview of our plans and included features here.

Please use this link to navigate to our current API documentation. If you have any technical questions you may contact api@swat.io at any time. Please also note that MCP in combination with our API is currently in beta. Plan availability and pricing are not yet final and may still change.

What is MCP?

MCP stands for Model Context Protocol. It is an interface built on top of our API that enables Large Language Models (LLMs) such as ChatGPT or Claude to interact with Swat.io.

Swat.io MCP Server URL: https://mcp.swatio.app/mcp

MCP in Swat.io

Here are a few examples of what you can do with ChatGPT or Claude via MCP in Swat.io. It depends on your Swat.io plan, which of the following options are available to you: To pull details on Inbox tickets, for example, Inbox needs to be included in your plan and for detailed Insights analytics, an Insights package needs to be booked.

Note: Which functions are actually supported via MCP also depends on the respective social media platform and on whether that platform makes these functions available to third party apps like Swat.io. In this case, on top of MCP’s own limitations, the API possibilities of the respective platform need to be taken into account as well.

Publisher: Create and schedule posts

Currently, MCP can be used to create the following types of posts in Swat.io:

  • Text posts

  • Single-image and multi-image posts

  • Link posts

  • Video posts

  • Story posts

  • Reel posts

Practical examples:

  • Have different types of posts for several channels prepared at once, all complete with caption and specific publication times and scheduled for the coming days or weeks. This saves you the time of creating each post manually.

  • Ask what posts are coming up next for a specific channel or time period and adjust text or publication time directly in the chat if needed.

Inbox: Manage comments and tickets

The same goes for your Inbox: You can look for tickets and comments directly through your AI and manage them, without having to click through lists and filters in Swat.io manually.

Examples:

  • For specific Inbox tickets or search terms, you can get the current status, the communication history and the assigned person shown to you on request, without having to open Swat.io manually.

  • Have notable or negatively toned comments from the last few days summarized for you in seconds and tag or archive them, directly from the chat with the AI.

Insights: Retrieve analytics and reports

Via MCP, you can also check Insights metrics directly and have them added to reports, without navigating through dashboards or gathering numbers manually yourself.

Examples:

  • Have the key metrics for a campaign or a specific time period compiled for you in a clear overview, for example sorted by reach, interactions or click numbers.

  • From the current metrics, put together a short, easy-to-understand summary or overview for an internal report or a customer update in just a few words.

Quick Tip: Not sure whether a specific function is possible via MCP? Just ask your AI. It can see which Swat.io functions are currently available through the connection and can list them for you. You can also find an overview of all possibilities in the technical documentation.

Connect with ChatGPT

Requirements

Before setting up the connection, please make sure that:

  • API Access is enabled in your Swat.io account;

  • You have an active ChatGPT Plus plan or higher;

  • If you use ChatGPT through a workspace account, your admin may need to grant the necessary permissions.

Enable MCP for ChatGPT

  1. Activate API Access in your Swat.io account if it is not already enabled.

  2. Add the MCP Server by opening Plugins in ChatGPT, clicking "+" and selecting “Add custom MCP server".

    Enter the following details:

    • Name: e.g. Swat.io

    • Authentication: OAuth

    • Confirm the warning and click “Create as a plugin”.

  3. Authentication via OAuth

    Note:

    • The connection between ChatGPT and Swat.io is established using the secure OAuth authorization process.

    • During the connection process, you will be redirected to Swat.io to confirm access. The connection will only be activated after you approve the request.

  4. Verify the connection: Once the connection is successful, Swat.io will appear under "Connected tools"

Info: You can disconnect the connection at any time in the ChatGPT settings under "Plugins". After disconnecting, ChatGPT will no longer be able to access your Swat.io account.

Connect with Claude

Requirements

Before setting up the connection, please make sure that:

  • API Access is enabled in your Swat.io account (otherwise the connection will fail).

  • Make sure your Claude plan is either Claude Pro or higher.

  • We recommend connecting Swat.io to Claude in the browser because it supports direct MCP connections and requires no local setup.

Enable MCP for Claude

  1. Activate API Access in your Swat.io account if it is not already enabled.

  2. Go to Claude’s Customize → Connectors and

    click + Add and select “Add custom connector”.

  3. Name it Swat.io and paste the following Remote MCP Server URL: https://mcp.swatio.app/mcp

  4. Authentication via OAuth

    Note:

    • The connection between Claude and Swat.io is established using the secure OAuth authorization process.

    • During the connection process, you will be redirected to Swat.io to confirm access. The connection will only be activated after you approve the request.

  5. You’ll be redirected back to Claude and Swat.io should now appear as connected under “Connected tools”.

  6. Now test whether the connection works by entering a test prompt like: “Show my Swat.io workspaces”.

MCP test prompt on Claude

Troubleshooting

Images fail to upload when using Claude Cowork or Claude Code

If you use MCP through Claude Cowork or Claude Code instead of the Claude browser, the agent runs in an isolated sandbox environment. Outgoing network traffic (egress) is restricted there by default, which can cause images or other uploads to fail because access to Swat.io's S3 storage gets blocked. The error message in this case usually points to a "policy denial" or a blocked network connection.

Solution: A person with admin rights for the respective Claude account needs to add the relevant domains (for example Swat.io's S3 storage domains) to the sandbox's network egress allowlist. After that the upload should work as expected.

MCP Limitations

Please note the following current limitations:

  • Direct publishing of posts via MCP is currently not possible. Content can be scheduled in advance but not published immediately.

  • Rest assured, MCP is being continuously improved.

Did this answer your question?