How to Use the JustCall MCP in Claude Code

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

Run claude mcp add --transport http justcall -- in your terminal. This command registers the MCP server in your /.claude.json configuration file, allowing the CLI agent to access all 12 communication tools immediately.

Q: How does Claude Code fetch my team roster from JustCall?

The agent uses the listteamusers tool to fetch your complete team list. This allows you to quickly map phone numbers to specific agents or check team availability directly from your shell.

Run headless telephony audits, send bulk texts, and query call logs directly from your terminal 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 JustCall MCP to Claude Code

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Telephony Scripting via Claude Code

This JustCall MCP Server brings complete call history queries directly into your terminal workspace. Claude Code lets you query your entire phone history using `list_calls` directly from your bash prompt. You can pipe the output to grep, awk, or local files to run instant audits. This CLI-first approach makes it easy to write shell scripts that fetch individual call records using `get_call_details`. You can automate system status checks or generate daily call volume reports without writing a single line of boilerplate code.

Bulk SMS Operations and Verification

This JustCall MCP Server enables terminal-based bulk SMS operations and instant message dispatch. With this MCP Server, Claude Code can parse a local text file of phone numbers and use `send_message` to dispatch texts sequentially right from the command line. After running the batch, you can have the agent check `list_messages` to verify delivery status or troubleshoot failed messages using `get_message_details` to inspect error codes without leaving your terminal session.

Command-Line Directory Management

This JustCall MCP Server gives you direct command-line control over your customer contacts directory. Claude Code can pull your current phone directory using `list_contacts` and search for duplicates or formatting errors. It handles dirty data directly in the terminal interface. If you need to add a new contact on the fly, just tell the agent to run `create_contact` with the person's name and number. It executes instantly, updating your business directory across all connected team devices.

Setup guide

Set up JustCall 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 justcall-alternative-mcp with a green status indicator.
3

Start using tools

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

Terminal

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

Run `claude mcp add --transport http justcall -- ` in your terminal. This command registers the MCP server in your `~/.claude.json` configuration file, allowing the CLI agent to access all 12 communication tools immediately.

Yes. You can query your webhook configuration by asking the CLI to list them. It uses the `list_webhooks` tool to display all active endpoints, making it simple to audit your real-time data pipelines from the terminal.

The agent uses the `list_team_users` tool to fetch your complete team list. This allows you to quickly map phone numbers to specific agents or check team availability directly from your shell.

Yes, you can pass a specific message ID to Claude Code and ask it to inspect the payload. It will call the `get_message_details` tool to retrieve the status, timestamp, and body of the text message.

All communication is routed through Vinkius's secure, zero-trust MCP infrastructure using HTTPS transport. Your raw contact directories, message payloads, and active API keys are processed in a secure memory space that is wiped immediately after execution, ensuring no data leakage to third parties.

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