How to Use the AMcards MCP in Windsurf

Q: Can Windsurf fetch my AMcards history?

Yes, use the getcardsendinghistory tool. Cascade will output the log directly in your chat window.

Send physical greeting cards directly from Windsurf using Cascade to automate your client outreach.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AMcards MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Trigger campaigns in Windsurf

Cascade handles the logic for your automated outreach. Instead of manual entry, you just tell the agent to `trigger_drip_campaign` for a specific contact. This MCP Server lets the agent pull from your `list_drip_campaigns` automatically. It saves time by handling the sequence without you switching tabs.

Manage card templates through Windsurf

You can browse your inventory using `list_card_templates` directly inside the IDE. It pulls the data so you know exactly which designs are ready to ship. Once you pick a design, use `send_greeting_card` to execute the mailer. Cascade fills in the details and confirms the request immediately.

Verify your AMcards connection

The `check_api_health` tool confirms the link between the server and your account. If things go sideways, you'll know exactly where the connection dropped. It also lets you audit your `list_configured_webhooks` to ensure your events trigger as expected. Windsurf keeps the status visible in the MCP panel.

Setup guide

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

mcp_config.json

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

You give Cascade the command to run a campaign. It calls the `trigger_drip_campaign` tool to start the sequence for your selected recipient.

Yes, use the `get_card_sending_history` tool. Cascade will output the log directly in your chat window.

It does. You can loop through your contact list and call the sending tools to handle high-volume mailings without leaving your code editor.

Vinkius handles the auth layer. You provide the endpoint token once, and the server manages the secure handshake for your sessions.

The server only touches the specific card metadata and contact info you provide. All communication happens over encrypted channels to keep your client lists private.

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