MCP

What is MCP?

MCP stands for Model Context Protocol. You can read more on the official website: modelcontextprotocol.io

The gist of it: it's a layer that sits on top of our API and lets an LLM like Claude or ChatGPT interact with Swat.io directly. Not every API call is available through MCP yet - we're extending it alongside our API.

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

Connecting any MCP-compatible client

If you're using a different MCP-compatible tool (Cursor, Windsurf, Zed, n8n, or any other), you can connect directly using these details:

Point your client at the URL and follow its OAuth flow - Swat.io will ask you to authorize access in a browser window. The exact steps depend on your client; refer to its documentation for how to add a remote MCP server with OAuth.

Connecting with Claude

1. Open the Customize panel

Click the Customize icon (the toolbox icon) in the Claude sidebar.

2. Go to Connectors

In the Customize panel, select Connectors.

3. Add Swat.io as a custom MCP server

Swat.io is not listed in Claude's built-in connector marketplace, so you need to add it manually. Click the + button in the top right of the Connectors panel.

Enter the following details:

• Name: Swat.io
• MCP Server URL: https://mcp.swatio.app/mcp
• Authentication: OAuth

Then click Add.

4. Authorize

A browser window will open asking you to grant Claude access to your Swat.io account. Check the box and click Accept.

5. You're connected

Back in Claude, Swat.io shows as connected with a Disconnect button. You'll see the available read-only and write tools listed under Tool permissions.

Using Swat.io in a chat

Click the + button in the chat input bar, then Connectors, and toggle Swat.io on. Claude will now have access to your Swat.io workspaces for that conversation.

Troubleshooting:

• The + button is not visible - Make sure you're on a Claude Pro plan or higher. Custom MCP connectors are not available on the free plan.
• Claude asks me to authorize again - The OAuth token has expired or was revoked. Just follow the auth flow again.

Connecting with ChatGPT

1. Open Apps & Connectors

Add the MCP server through the Apps & Connectors setting.

2. Enable Developer Mode

Custom MCP connectors currently require Developer Mode. Click Advanced settings and turn it on.

3. Add the Swat.io MCP server

Click Create in the top right and fill in the details:

• Name: Swat.io
• MCP Server URL: https://mcp.swatio.app/mcp
• Authentication: OAuth
• Check the box to activate the connector

4. Connect and authorize

Click on the new connector and then Connect. This takes you through the OAuth flow to link your Swat.io account to OpenAI.

5. You're connected

Once approved, you'll see a Disconnect button confirming the connection is active.

Using Swat.io in a chat

Click the + icon when starting a new chat and add Swat.io as a tool.

Example prompts and workflows

First: orient Claude to your workspace

Before doing anything else, it's worth telling Claude which workspace and channel you'll be working with most. That way you don't have to repeat it in every prompt. A good first message when starting a new session:

"Connect to Swat.io and list all my workspaces and their channels. I'll be mostly working in the workspace called 'Acme Corp' - find my LinkedIn channel there and use that as the default for this conversation."

If your LLM supports memory or project instructions, save the workspace name and channel ID there so it carries over to future sessions automatically.

Scheduling a post

"On my LinkedIn channel in the 'Acme Corp' workspace, schedule a post for tomorrow at 10am: 'Excited to share that we just launched X - link in comments.'"

"Draft a short text post for my LinkedIn channel about [topic] and schedule it for next Monday at 9am."

Bulk scheduling from a CSV

If you have a content calendar or a spreadsheet of posts ready to go, you can hand it directly to Claude:

"I'm going to paste a CSV with columns: date, message, channel. Create a scheduled post for each row in the 'Acme Corp' workspace on my LinkedIn channel."

Claude will iterate through the rows and call createPost for each one - no manual copy-pasting required.

Analyzing past content to build a tone of voice

One of the more powerful workflows: use your existing posts to teach Claude how you write, then use that to generate future content.

"Fetch my last 20 posts from the LinkedIn channel in the 'Acme Corp' workspace. Analyze the tone, style, and structure. What patterns do you notice? Summarize my writing style in a few bullet points."

Once you have the summary, you can save it as a memory or project instruction and reference it in future prompts:

"Using the tone of voice you analyzed earlier, write 3 draft LinkedIn posts about our upcoming webinar and save them as drafts in Swat.io."

Working with drafts

"List all drafts in the 'Acme Corp' workspace. For each one, suggest whether it's ready to schedule or still needs work."

"Take the draft with ID [X] and turn it into a scheduled post on my LinkedIn channel for Friday at noon."

Reviewing what's scheduled

"What posts are scheduled for this week across all channels in the 'Acme Corp' workspace?"

"Is anything scheduled for today? If not, suggest a good time to post and create a short text post for LinkedIn."

Filtering by post status

"Show me all approved posts in the 'Acme Corp' workspace across channels 100 and 200."

"List all suggested posts waiting for approval on my LinkedIn channel - I want to review them."