How to Use the Joomag MCP in Claude Code

Q: How do I connect Claude Code to my Joomag account?

First, add the server by running claude mcp add ... with the Vinkius URL. This configures the Joomag MCP server in your local /.claude.json file, making the tools available in your terminal.

Q: Can I use Claude Code to manage my Joomag contacts?

You can list them. Use claude ask 'list all contacts' --tool joomag-mcp/listcontacts to export your audience list for use in other scripts or for auditing. You can't add or delete contacts with this server.

Q: How can I check my Joomag publication IDs with Claude Code?

Just run claude ask 'list all my publications' --tool joomag-mcp/listpublications. You can pipe the output to jq to extract just the IDs and titles for use in other scripts.

Pipe Joomag data into your shell scripts and CI/CD pipelines. Headless, terminal-only MCP access with Claude Code.

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

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Account Health Checks in CI

Put this in your deployment pipeline. Before deploying an app that depends on Joomag, run a quick check to make sure the API is accessible and your credentials are valid. A simple command like `claude ask 'check my Joomag account status' --tool joomag-mcp/get_account` can be added to any shell script. If it fails, the script exits and your GitHub Action stops the deploy.

Export Joomag Data for Cron Jobs

This MCP server is built for headless automation. You can run a nightly cron job to back up your contact list or sync it somewhere else. It's just one line in your crontab. `claude ask 'list all contacts' --tool joomag-mcp/list_contacts | jq -c '.[]' >> contacts_backup.jsonl`. This pipes the raw JSON output from the tool directly into a file, perfect for backend processing.

Monitor Publication Releases

You can write a script to monitor when new content goes live. For example, check if this week's newsletter issue has been published before sending out a marketing email. Your script would use `list_issues` for a specific publication and check the date of the latest entry. If it's not today's date, the script can alert a Slack channel or hold the email campaign.

Setup guide

Set up Joomag 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 joomag-mcp with a green status indicator.
3

Start using tools

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

Terminal

claude mcp add --transport http joomag-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 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

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": {
    "joomag-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 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 Claude Code

First, add the server by running `claude mcp add ...` with the Vinkius URL. This configures the Joomag MCP server in your local `~/.claude.json` file, making the tools available in your terminal.

You can list them. Use `claude ask 'list all contacts' --tool joomag-mcp/list_contacts` to export your audience list for use in other scripts or for auditing. You can't add or delete contacts with this server.

Just run `claude ask 'list all my publications' --tool joomag-mcp/list_publications`. You can pipe the output to `jq` to extract just the IDs and titles for use in other scripts.

Yes. You don't manage auth tokens, headers, or pagination. You connect Claude Code once with your Vinkius key, and this MCP server handles the rest. The MCP standard simplifies everything for scripting.

Your Vinkius token is the only secret you need to manage. The connection from Claude Code to the server is secure, and the server itself is ephemeral. It processes your request to access Joomag campaign data and doesn't persist anything.

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