How to Use the Heymarket MCP in Claude Code

Q: How do I add the Heymarket MCP Server to Claude Code?

Run the command claude mcp add --transport sse heymarket-mcp -- in your terminal to link Heymarket. This registers the MCP server and configures your /.claude.json file automatically for Claude Code.

Q: How does Claude Code search for contacts in Heymarket?

The terminal tool inside Claude Code runs listcontacts with phone number filters to locate specific Heymarket customer profiles. It displays the results directly in your shell for quick inspection.

Script, pipe, and automate your Heymarket SMS workflows from the terminal using 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 Heymarket MCP to Claude Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Send Heymarket texts from your command line

`send_sms_message` turns your terminal into a high-speed dispatch tool for Heymarket customer alerts using Claude Code. The CLI agent processes CSV files or database dumps and pipes the phone numbers directly into the messaging tool. This command-line approach lets you build shell scripts that trigger Heymarket text updates via Claude Code after successful deployments or server events. You avoid manual web consoles entirely, keeping your operations fast and lightweight.

Audit Heymarket chat queues using this CLI MCP Server

`list_active_chats` allows Claude Code to query your Heymarket business inbox status directly from an active SSH session or terminal window. The terminal agent parses the returned JSON list to identify stale threads or unassigned conversations. You can then run `update_chat_status` to close resolved conversations or reassign Heymarket threads in bulk using Claude Code. This terminal-first control makes managing large support volumes incredibly efficient for sysadmins and backend developers.

Sync Heymarket contacts using Claude Code

`list_contacts` retrieves your entire Heymarket customer directory inside Claude Code, allowing you to filter by phone number or custom criteria. The tool handles the filtering locally, letting you search your customer database without opening a browser. When details change, Claude Code uses `update_contact_profile` to apply Heymarket changes instantly. It integrates your contact management directly into your command-line scripts, making database maintenance straightforward.

Setup guide

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

Start using tools

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

Terminal

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

Run the command `claude mcp add --transport sse heymarket-mcp -- ` in your terminal to link Heymarket. This registers the MCP server and configures your ~/.claude.json file automatically for Claude Code.

Yes, you can instruct Claude Code to capture command outputs or build logs and send them via Heymarket. The CLI agent then uses `send_sms_message` to transmit those logs directly to your phone.

The terminal tool inside Claude Code runs `list_contacts` with phone number filters to locate specific Heymarket customer profiles. It displays the results directly in your shell for quick inspection.

Yes, you can instruct the CLI agent inside Claude Code to update assignments in Heymarket. It uses `update_chat_status` to change the owner or status of any chat thread from your terminal.

Your Heymarket customer phone numbers, SMS text contents, and contact details are processed in memory by Claude Code and never written to persistent third-party storage. Vinkius ensures the transit tunnel is encrypted, protecting sensitive terminal-based communication data from exposure.

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