How to Use the MailboxPower MCP in Windsurf

Q: Can I manage MailboxPower contact groups with Windsurf?

Yes. You can tell Windsurf to create a new list with creategroup or add someone to an existing one with addcontacttogroup. It's perfect for segmenting customers for different campaigns.

Q: What's the best way to sync my CRM with MailboxPower using Windsurf?

Prompt Windsurf to check if a contact exists with getcontact. If they don't, your agent can use createcontact to add them. Cascade can chain these actions to run a full sync on a list of users.

Let Windsurf's Cascade agent run your direct mail strategy, turning a single goal into contacts created, groups managed, and gifts sent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MailboxPower MCP to Windsurf

Create your Vinkius account to connect MailboxPower 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 MailboxPower with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Gifting from a Single Prompt

This MCP server gives your agent the tools to send physical mail. Tell Windsurf to send a welcome kit to your new enterprise sign-ups. Cascade gets to work, chaining tools to make it happen without asking you at every step. First, it can `create_contact` to add the new user to MailboxPower. Then it might use `add_contact_to_group` to put them in a 'New VIPs' list. Finally, it triggers `send_shipment` with the right gift. You state the goal, Cascade handles the execution.

Manage Ongoing Drip Campaigns

A one-off gift is good. A timed sequence of mail is better. You can ask Windsurf to enroll a specific contact into a predefined marketing campaign. It’s a simple, one-prompt operation. Your agent uses `list_automations` to see what sequences are available in your MailboxPower account. Once you pick one, it uses `add_contact_to_automation` to start the clock. Cascade can even plan a multi-step task to pull a list of contacts from one system and enroll them all.

Keep Your Contact Lists Clean with Windsurf

Your mail campaigns are only as good as your data. Ask Windsurf to audit a specific contact group. It can quickly pull the data so you can check it for accuracy. Cascade can use `list_groups` to find the right list, then `list_contacts` to get everyone in it. If you need to check a single person, `get_contact` pulls their record instantly. No more exporting CSVs just to find one person's address.

Setup guide

Set up MailboxPower 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 MailboxPower 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 MailboxPower payment history." If connected, Cascade will call the MailboxPower tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "mailboxpower-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 MailboxPower. 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 MailboxPower 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 MailboxPower MCP in Windsurf

You give Windsurf's Cascade agent a goal, like 'Send a thank you card to this user.' Cascade then uses the `send_shipment` tool from this MCP server to execute the request without any further input from you.

Yes. You can tell Windsurf to create a new list with `create_group` or add someone to an existing one with `add_contact_to_group`. It's perfect for segmenting customers for different campaigns.

Prompt Windsurf to check if a contact exists with `get_contact`. If they don't, your agent can use `create_contact` to add them. Cascade can chain these actions to run a full sync on a list of users.

No. This server is for automating actions like sending gifts and managing contacts. You'll still use the MailboxPower website to design your cards, select gifts, and create automation sequences.

The server only processes the customer contact information needed for shipping, like names and addresses. Vinkius runs each MCP server in an isolated sandbox, and your Windsurf client connects using a single, revocable token, so credentials are never exposed.

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