How to Use the Cardly MCP in Windsurf

Q: How do I install the Cardly MCP Server in Windsurf?

Open your MCP settings panel or edit /.codeium/windsurf/mcpconfig.json. Add the Vinkius endpoint URL and click refresh. Cascade will automatically detect the new tools.

Let Windsurf Cascade design and mail physical greeting cards right from your IDE by connecting the Cardly MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Cardly MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Browse physical card designs in Windsurf

Cascade grabs the catalog when you ask it to find a birthday card. It runs `list_card_artwork` to pull available designs directly into your editor context. You never have to leave the IDE to pick a cover. Once it spots a good match, the agent pulls specific dimensions and metadata using `get_artwork_details`. The AI reads the exact physical specs before generating any inside text.

Manage address books automatically

Storing recipient details happens without manual data entry. Your agent checks existing groups via `list_contact_lists` and searches for specific emails using `find_contact`. If a team member is missing, Cascade inserts them right then and there. Calling `add_contact_to_list` pushes their shipping info straight to your account.

Preview and ship physical cards

Writing a custom message takes seconds because the AI drafts the text and generates a visual proof. Running `preview_greeting_card` returns a mockup so you know exactly how the printed version will look. Approving that mockup triggers the final step in the MCP workflow. Cascade executes `place_greeting_card_order` to send a real, physical piece of mail through the postal system.

Setup guide

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

mcp_config.json

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

Open your MCP settings panel or edit `~/.codeium/windsurf/mcp_config.json`. Add the Vinkius endpoint URL and click refresh. Cascade will automatically detect the new tools.

Yes, it places actual physical orders. The agent drafts the message and calls the order tool to print and mail the envelope.

Ask your agent to generate a mockup first. It will use the preview tool to show you the final layout before charging your account.

You just tell Cascade to send holiday cards to everyone in a specific contact list. The agent iterates through the addresses and places individual orders autonomously.

This integration only reads the emails and physical mailing addresses you explicitly target. Vinkius runs the connection in an ephemeral V8 Isolate sandbox, meaning your contact lists are never stored or logged after the request finishes.

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