How to Use the MailboxPower MCP in Claude Code

Q: How do I add a new contact to MailboxPower from the terminal using Claude Code?

Pipe a JSON object containing the name and address to the claude command and specify the createcontact tool. It's a single command to add a contact to your account.

Q: Can I use Claude Code to put a MailboxPower contact into an automation?

Yes. Just invoke Claude Code with the addcontacttoautomation tool, providing the contact ID and the automation ID. You can script this to enroll batches of users at once.

Run headless direct mail from the terminal. Pipe data to Claude Code to trigger physical shipments and manage contacts in your CI/CD pipelines.

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 Claude Code

Create your Vinkius account to connect MailboxPower to Claude Code 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Trigger Shipments from a Shell Script

This server connects your terminal directly to a physical shipping service. You can pipe a JSON object with a contact ID and gift ID to Claude Code and tell it to use the `send_shipment` tool. It’s a one-liner that sends a real-world package. This is built for automation. Put that command in a GitHub Action to send swag when a PR is merged. Or use it in any script where you need to trigger a physical action from a digital event. No UI, no clicks, just a command.

Sync Contacts in a Cron Job

Keep your MailboxPower contacts in sync with your primary database without manual work. Write a simple shell script that exports new users, then pipes them to Claude Code to run `create_contact` for each one. Set it up as a nightly cron job and forget about it. Your script can also use `list_contacts` to fetch existing records and `add_contact_to_group` to sort them. It’s a powerful way to manage your lists programmatically from any server with a terminal.

Your MailboxPower MCP Server for CI/CD

Manage your direct mail campaigns as part of your deployment process. Use Claude Code in a pipeline to automatically enroll new high-value signups into a welcome sequence. Your script just needs to call `add_contact_to_automation`. You can query your campaigns with `list_automations` and manage groups with `create_group` and `list_groups`. This MCP server gives you all the building blocks for headless campaign management.

Setup guide

Set up MailboxPower MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see mailboxpower-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest MailboxPower transactions." It will automatically discover and invoke the available MailboxPower tools.

Terminal

claude mcp add --transport http mailboxpower-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "mailboxpower-mcp": {
      "type": "url",
      "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 Claude Code

Absolutely. In your workflow file, just call the Claude Code CLI with the `send_shipment` tool and pass in the required data. It’s ideal for sending developer swag or contributor thank-yous automatically.

Pipe a JSON object containing the name and address to the `claude` command and specify the `create_contact` tool. It's a single command to add a contact to your account.

Yes. Just invoke Claude Code with the `add_contact_to_automation` tool, providing the contact ID and the automation ID. You can script this to enroll batches of users at once.

No, you don't. Vinkius handles the server-side authentication with MailboxPower. All you need is your single Vinkius token to configure Claude Code, and you're set.

The server is designed to only handle customer contact information required for mailing. Your Claude Code client communicates with the MCP server through a secure endpoint managed by Vinkius, using a single, revocable token for access.

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