How to Use the Joomag MCP in Windsurf

Let Windsurf's Cascade agent run multi-step Joomag reports on its own. Just set a goal and see the final result.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Joomag MCP to Windsurf

Create your Vinkius account to connect Joomag to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Joomag with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Publication Reporting

Ask Cascade to 'report on the latest issue of the quarterly sales magazine'. It finds the right publication with `get_publication`, pulls all its editions using `list_issues`, and then grabs the performance data for the most recent one with `list_analytics`. You don't have to prompt each step. Cascade chains the tools together, figures out the IDs, and gives you the final report. This is what an autonomous agent is for.

Audit Contact and Subscription Lists

You can give Cascade a high-level task like, 'show me all contacts who subscribed through the 'Summer 2024' campaign but have since churned'. It's not a single API call. Cascade will use `list_campaigns` to find the right one, then cross-reference `list_contacts` with `list_subscriptions` to build the exact list you asked for. You get a clean list without having to manually filter and join data.

Organize Content with Your MCP Server

Tell your agent to 'move all 2023 issues of the 'Product Updates' publication into the 'Archived' collection'. Cascade plans the whole operation. It starts by finding the publication ID with `list_publications`, gets all the relevant issue IDs using `list_issues`, and then works with `list_collections` to perform the organization. This MCP server gives Cascade the tools it needs to manage your Joomag library.

Setup guide

Set up Joomag MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Joomag MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Joomag payment history." If connected, Cascade will call the Joomag tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "joomag-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Joomag. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Joomag now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Joomag MCP in Windsurf

Windsurf connects via this MCP server. Install it from the MCP Marketplace in Windsurf, and Cascade automatically discovers all the Joomag tools. Your MCP connection handles all the authentication.

No, this server is read-only. It lets Cascade run complex queries with tools like `list_publications` and `list_issues`, but it can't create or modify Joomag content.

Give Cascade a specific goal, like 'Compare the performance of our top three publications this quarter.' It will use `list_publications` and `list_analytics` to build the comparison for you.

You can access publications, issues, collections, contacts, subscriptions, marketing campaigns, and analytics reports. The server provides tools to list and get details for each of these.

This server only reads your Joomag publication metadata and analytics data. Your Vinkius token authenticates access, and all operations run in an ephemeral, zero-trust sandbox that doesn't store your data.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript