How to Use the Chiirp MCP in Claude Code

Q: How do I use Claude Code to add a new Chiirp contact from a script?

In your shell script, call Claude Code with a prompt like claude mcp do "create a new Chiirp contact with phone 555-123-4567". It executes the createcontact tool for you.

Q: Can I get a list of all my Chiirp contacts to a file using Claude Code?

Yes. Just run claude mcp do "list all chiirp contacts" > contacts.json. It's a one-line command to get a full JSON dump of your contacts.

Automate Chiirp marketing tasks from the command line. Perfect for cron jobs, CI/CD pipelines, and shell scripts.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Chiirp MCP to Claude Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Chiirp Tasks in CI/CD

Use Claude Code to interact with your Chiirp account in a completely automated way. Add a step to your deployment pipeline that checks the API status with `check_chiirp_status` before pushing an update. You can also script routine tasks. For instance, run a nightly cron job that gets a list of all contacts using `list_contacts` and pipes the output to another script for backup or analysis. No browser or UI needed.

Bulk Contact Operations from the Terminal

This MCP server makes it easy to perform bulk operations. Write a simple shell script that reads a CSV of phone numbers and uses Claude Code to call `create_contact` for each one. You can also chain commands together. Pipe the output of `search_contacts` into `xargs` to then run `remove_tag` on a specific group of users. It's a powerful way to manage your Chiirp lists without ever leaving the command line.

Monitor Chiirp from your Shell

Need a quick status report? Just run Claude Code with a prompt like "list all my chiirp campaigns and tags". It will call `list_campaigns` and `list_tags` and print a clean report to your stdout. This is ideal for DevOps and SREs. You can build simple health checks or reporting scripts that pull key metrics from your marketing stack and feed them into your existing monitoring tools. This MCP Server handles all the connection details.

Setup guide

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

Start using tools

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

Terminal

claude mcp add --transport http chiirp-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 Chiirp 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": {
    "chiirp-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 Chiirp. 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 Chiirp 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 Chiirp MCP in Claude Code

In your shell script, call Claude Code with a prompt like `claude mcp do "create a new Chiirp contact with phone 555-123-4567"`. It executes the `create_contact` tool for you.

Yes. Just run `claude mcp do "list all chiirp contacts" > contacts.json`. It's a one-line command to get a full JSON dump of your contacts.

Definitely. Use the prompt "check chiirp api status". Claude Code runs the `check_chiirp_status` tool and returns a simple success or failure message, which is perfect for automated health checks.

This server handles authentication with a single token, so you don't have to manage raw API keys in your scripts. Vinkius also provides a stable, standardized interface, so your scripts won't break if the underlying Chiirp API changes.

All communication about your Chiirp contacts and campaigns goes through Vinkius's zero-trust infrastructure. Each request from Claude Code is individually authorized and executed in an ephemeral sandbox, ensuring your data and credentials aren't exposed in your terminal or CI/CD logs.

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