Where is Windsurf's MCP config?

Usually ~/.codeium/windsurf/mcp_config.json. Newer builds may use a different location; open it from Cascade's MCP panel to be sure.

Do I need an API key?

No. Windsurf supports Tesselith's browser sign-in. Use a key only for unattended setups.

Windsurf + Tesselith

How to connect Windsurf to Tesselith

Add Tesselith to Windsurf's Cascade and draft and schedule social posts from your editor. Windsurf talks to Tesselith’s MCP server, so it can draft, queue and schedule posts on every channel you’ve connected. Keep a human in the loop: publishing now and deleting always ask for your confirmation.

Join the waitlist MCP docs

What do I need before connecting?

You need Windsurf and a Tesselith workspace on Pro, Team or Agency (every new workspace starts with a 14-day Pro trial) with at least one channel connected. On Teams and Enterprise, an admin must enable remote MCP servers first.

1 · Connect · a few minutes

Run this

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tesselith": {
      "serverUrl": "https://api.tesselith.com/mcp"
    }
  }
}

Newer builds may show the config path in Cascade's MCP panel. Edit the file that panel opens.

2 · Ask · live in Tesselith

Ask Windsurf to post for you

Turn this release note into a Bluesky post and queue it.

Used Tesselith · create_draft · add_to_queue

Queued for the next free Bluesky slot, tomorrow at 9:00. It's 284 characters.

Also try:

“List my Tesselith channels.”
“What's scheduled this week?”
“Draft three variations of this announcement.”

The setup at a glance

Open Cascade's MCP settings
Add Tesselith and refresh
Authenticate
Ask Cascade

One connection, every channel

Connect your accounts in Tesselith once. From then on Windsurf can plan and schedule for any of them, and Tesselith publishes at the time you set, even after the conversation ends.

XSoon
Instagram
Facebook
LinkedInSoon
Threads
YouTube
TikTokSoon
DiscordSoon
Telegram
RedditSoon
PinterestSoon
Bluesky
Mastodon
Dev.toSoon
HashnodeSoon

How do I connect Windsurf to Tesselith, step by step?

1. Open Cascade's MCP settings
In the Cascade panel, open MCPs and choose to edit the raw config. Remote servers use serverUrl.
2. Add Tesselith and refresh
Paste the entry above, save, and click the refresh icon in the MCP list.
3. Authenticate
The server shows Needs authentication. Click Authenticate. A Tesselith window opens. Sign in, pick the workspace, untick anything you don't want the agent to do, and click Allow access.
4. Ask Cascade
Ask Cascade to list your Tesselith channels to confirm, then to draft a post.

Can I use an API key instead of signing in?

To use a key instead of signing in, add a header. In Tesselith, open Settings → Developers, create an API key and tick only the scopes the agent needs. Keys start with tsl_live_ and are shown once, so store it in your password manager or a secret store. Restart Windsurf after setting the variable.

mcp_config.json

{
  "mcpServers": {
    "tesselith": {
      "serverUrl": "https://api.tesselith.com/mcp",
      "headers": { "Authorization": "Bearer ${env:TESSELITH_API_KEY}" }
    }
  }
}

What can Windsurf do in Tesselith?

The server at https://api.tesselith.com/mcp exposes these tools. Windsurf only gets the permissions you approve, and never more than your own role.

Tesselith MCP tools available to Windsurf
	What it does
list_channels	Lists your connected accounts and their status
list_posts / get_post	Finds posts by status or channel, or reads one
get_queue	Shows a channel's upcoming posts and free slots
suggest_best_time	Suggests the next free slot and your best hours
get_analytics_summary	Counts active channels, drafts and published posts
create_draft	Drafts a post for one or more channels
update_post	Changes a post's text, channels or media
add_to_queue	Gives a post the channel's next free slot
schedule_post	Pins a post to an exact time
upload_media_from_url	Attaches an image or video from a public URL
publish_now	Publishes within a minute, only after you confirm
delete_post	Deletes a post, only after you confirm

Why is Windsurf not working with Tesselith?

Almost every failure is one of these. Tesselith returns a readable error, so asking Windsurf“what went wrong?” usually points at the right row.

Troubleshooting Windsurf with Tesselith
	Fix
Server won't start	Remote servers need serverUrl, not command and args.
Needs authentication	Click Authenticate to rerun the browser sign-in.
Nothing appears on a Teams plan	An admin must enable remote MCP transports and allow the server.
Too many tools	Cascade caps the total tools across servers. Disable servers or tools you don't use.
403: your plan doesn't include API access	MCP is included on Pro, Team and Agency. New workspaces get a 14-day Pro trial; upgrade under Settings → Billing.
401: connection revoked or lost access	Someone disconnected the assistant in Settings → AI assistants, or your role changed. Connect again and approve the workspace.
The assistant can read posts but can't schedule	You unticked Schedule and queue on the consent screen. Disconnect and connect again, keeping that permission.
No channels found	The assistant only sees accounts already connected in Tesselith. Connect them under Channels first.
Post scheduled at the wrong time	Tell the assistant your time zone. Tesselith takes ISO 8601 times with an offset, and your workspace time zone is shown in get_queue.
429: rate limited	Each connection can make 120 requests a minute on Pro, 300 on Team and 600 on Agency. Wait for the Retry-After seconds.

Windsurf and Tesselith: frequently asked questions

Where is Windsurf's MCP config?: Usually ~/.codeium/windsurf/mcp_config.json. Newer builds may use a different location; open it from Cascade's MCP panel to be sure.
Do I need an API key?: No. Windsurf supports Tesselith's browser sign-in. Use a key only for unattended setups.

Windsurf’s own documentation: Windsurf docs.

Connect other AI agents

Claude Claude Code Claude Cowork ChatGPT Codex OpenAI API Cursor VS Code (GitHub Copilot)Zed Cline Gemini CLI Hermes Agent OpenClaw Goose n8n Mistral Le Chat Perplexity Manus

Ready to connect Windsurf?

Create your Tesselith account, connect your channels, and Windsurf can start scheduling in minutes.

Join the waitlist

Windsurf + Tesselith

How to connect Windsurf to Tesselith

Join the waitlist MCP docs

What do I need before connecting?

1 · Connect · a few minutes

Run this

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tesselith": {
      "serverUrl": "https://api.tesselith.com/mcp"
    }
  }
}

Newer builds may show the config path in Cascade's MCP panel. Edit the file that panel opens.

2 · Ask · live in Tesselith

Ask Windsurf to post for you

Turn this release note into a Bluesky post and queue it.

Used Tesselith · create_draft · add_to_queue

Queued for the next free Bluesky slot, tomorrow at 9:00. It's 284 characters.

Also try:

“List my Tesselith channels.”
“What's scheduled this week?”
“Draft three variations of this announcement.”

The setup at a glance

Open Cascade's MCP settings
Add Tesselith and refresh
Authenticate
Ask Cascade

One connection, every channel

Connect your accounts in Tesselith once. From then on Windsurf can plan and schedule for any of them, and Tesselith publishes at the time you set, even after the conversation ends.

XSoon
Instagram
Facebook
LinkedInSoon
Threads
YouTube
TikTokSoon
DiscordSoon
Telegram
RedditSoon
PinterestSoon
Bluesky
Mastodon
Dev.toSoon
HashnodeSoon

How do I connect Windsurf to Tesselith, step by step?

1. Open Cascade's MCP settings
In the Cascade panel, open MCPs and choose to edit the raw config. Remote servers use serverUrl.
2. Add Tesselith and refresh
Paste the entry above, save, and click the refresh icon in the MCP list.
3. Authenticate
The server shows Needs authentication. Click Authenticate. A Tesselith window opens. Sign in, pick the workspace, untick anything you don't want the agent to do, and click Allow access.
4. Ask Cascade
Ask Cascade to list your Tesselith channels to confirm, then to draft a post.

Can I use an API key instead of signing in?

mcp_config.json

{
  "mcpServers": {
    "tesselith": {
      "serverUrl": "https://api.tesselith.com/mcp",
      "headers": { "Authorization": "Bearer ${env:TESSELITH_API_KEY}" }
    }
  }
}

What can Windsurf do in Tesselith?

The server at https://api.tesselith.com/mcp exposes these tools. Windsurf only gets the permissions you approve, and never more than your own role.

Tesselith MCP tools available to Windsurf
	What it does
list_channels	Lists your connected accounts and their status
list_posts / get_post	Finds posts by status or channel, or reads one
get_queue	Shows a channel's upcoming posts and free slots
suggest_best_time	Suggests the next free slot and your best hours
get_analytics_summary	Counts active channels, drafts and published posts
create_draft	Drafts a post for one or more channels
update_post	Changes a post's text, channels or media
add_to_queue	Gives a post the channel's next free slot
schedule_post	Pins a post to an exact time
upload_media_from_url	Attaches an image or video from a public URL
publish_now	Publishes within a minute, only after you confirm
delete_post	Deletes a post, only after you confirm

Why is Windsurf not working with Tesselith?

Almost every failure is one of these. Tesselith returns a readable error, so asking Windsurf“what went wrong?” usually points at the right row.

Troubleshooting Windsurf with Tesselith
	Fix
Server won't start	Remote servers need serverUrl, not command and args.
Needs authentication	Click Authenticate to rerun the browser sign-in.
Nothing appears on a Teams plan	An admin must enable remote MCP transports and allow the server.
Too many tools	Cascade caps the total tools across servers. Disable servers or tools you don't use.
403: your plan doesn't include API access	MCP is included on Pro, Team and Agency. New workspaces get a 14-day Pro trial; upgrade under Settings → Billing.
401: connection revoked or lost access	Someone disconnected the assistant in Settings → AI assistants, or your role changed. Connect again and approve the workspace.
The assistant can read posts but can't schedule	You unticked Schedule and queue on the consent screen. Disconnect and connect again, keeping that permission.
No channels found	The assistant only sees accounts already connected in Tesselith. Connect them under Channels first.
Post scheduled at the wrong time	Tell the assistant your time zone. Tesselith takes ISO 8601 times with an offset, and your workspace time zone is shown in get_queue.
429: rate limited	Each connection can make 120 requests a minute on Pro, 300 on Team and 600 on Agency. Wait for the Retry-After seconds.

Windsurf and Tesselith: frequently asked questions

Where is Windsurf's MCP config?: Usually ~/.codeium/windsurf/mcp_config.json. Newer builds may use a different location; open it from Cascade's MCP panel to be sure.
Do I need an API key?: No. Windsurf supports Tesselith's browser sign-in. Use a key only for unattended setups.

Windsurf’s own documentation: Windsurf docs.

Connect other AI agents

Claude Claude Code Claude Cowork ChatGPT Codex OpenAI API Cursor VS Code (GitHub Copilot)Zed Cline Gemini CLI Hermes Agent OpenClaw Goose n8n Mistral Le Chat Perplexity Manus

Ready to connect Windsurf?

Create your Tesselith account, connect your channels, and Windsurf can start scheduling in minutes.

Join the waitlist

What do I need before connecting?

Run this

Ask Windsurf to post for you

The setup at a glance

One connection, every channel

How do I connect Windsurf to Tesselith, step by step?

1. Open Cascade's MCP settings

2. Add Tesselith and refresh

3. Authenticate

4. Ask Cascade

Can I use an API key instead of signing in?

What can Windsurf do in Tesselith?

Why is Windsurf not working with Tesselith?

Windsurf and Tesselith: frequently asked questions

Connect other AI agents

Ready to connect Windsurf?

What do I need before connecting?

Run this

Ask Windsurf to post for you

The setup at a glance

One connection, every channel

How do I connect Windsurf to Tesselith, step by step?

1. Open Cascade's MCP settings

2. Add Tesselith and refresh

3. Authenticate

4. Ask Cascade

Can I use an API key instead of signing in?

What can Windsurf do in Tesselith?

Why is Windsurf not working with Tesselith?

Windsurf and Tesselith: frequently asked questions

Connect other AI agents

Ready to connect Windsurf?