@velaro/mcp-server

The only customer support platform with a native, self-updating MCP server.

Connect Claude, Claude Code, Claude Desktop, or any MCP-compatible AI agent directly to your Velaro account — knowledge base, workflows, conversation data, and 596 AI skills across 20+ commerce and CRM platforms.

npx @velaro/mcp-server

Set your key and go:

VELARO_MCP_KEY=vel_live_... npx @velaro/mcp-server

Why Velaro MCP Is Different

Most chat platforms require webhooks, custom API wrappers, or point-to-point integrations to give an AI agent access to customer data. Velaro ships a published npm package that turns Claude into a first-class operator of your entire support infrastructure — no wrapper code, no custom authentication layer, no waiting for an API integration to be built.

• One command install — npx @velaro/mcp-server pulls the latest version automatically
• Hosted HTTP endpoint — no Node.js required; point Claude Desktop at https://velaro-admin-staging.azurewebsites.net/mcp with a Bearer token
• Auto-updates — the package is republished on every production deploy; npx always runs the latest
• 596 AI skills — Shopify, BigCommerce, WooCommerce, Magento, HubSpot, Salesforce, NetSuite, ServiceNow, Dynamics 365, SAP, Square, QuickBooks, Jobber, and more — all callable from within Claude
• 25 built-in tools — conversations, workflows, bots, contacts, agents, teams, routing rules, conversion tracking, and full KB management

Quick Start

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "velaro": {
      "command": "npx",
      "args": ["@velaro/mcp-server"],
      "env": {
        "VELARO_MCP_KEY": "vel_live_..."
      }
    }
  }
}

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "velaro": {
      "command": "npx",
      "args": ["@velaro/mcp-server"],
      "env": {
        "VELARO_MCP_KEY": "vel_live_..."
      }
    }
  }
}

Hosted HTTP Endpoint (No Node Required)

If you prefer not to run a local Node process, point directly at Velaro's hosted MCP endpoint:

{
  "mcpServers": {
    "velaro": {
      "url": "https://api-admin-us-east.velaro.com/mcp",
      "headers": {
        "Authorization": "Bearer vel_live_..."
      }
    }
  }
}

This works with any MCP client that supports HTTP/SSE transport — including Claude Desktop 0.8+.

Available Tools

Knowledge Base

| Tool | What It Does | |------|-------------| | kb_list_topics | List all knowledge base topics | | kb_search_articles | Search articles by keyword, topic, or publish status | | kb_get_article | Retrieve full article content by ID | | kb_create_article | Create and optionally publish a new article | | kb_update_article | Update title, body, tags, or publish status | | kb_delete_article | Delete an article |

Conversations

| Tool | What It Does | |------|-------------| | conversation_list | List recent conversations filtered by channel, status, or agent | | conversation_get | Get full details for a single conversation | | conversation_search | Search conversations by phone number or call SID |

Workflows

| Tool | What It Does | |------|-------------| | workflow_list | List all workflows with enabled state and trigger type | | workflow_get | Get full workflow details by ID | | workflow_toggle | Enable or disable a workflow |

Bots & AI Configurations

| Tool | What It Does | |------|-------------| | bot_list | List all bot/AI configurations for this site | | bot_get | Get full bot config including system prompt | | bot_update_prompt | Update a bot's system prompt |

Contacts

| Tool | What It Does | |------|-------------| | contact_search | Search contacts by name, email, phone, or company | | contact_get | Get full contact details by ID |

Team & Routing

| Tool | What It Does | |------|-------------| | agent_list | List agents with availability status; filter by team | | team_list | List all teams for this site | | routing_list | List all routing rules ordered by priority | | routing_get | Get routing rule details including rule and value JSON | | routing_get_policy | Site auto-routing policy including reassignment mode and the agent inactivity chain | | routing_update_policy | Update the policy, reassignment mode and inactivity chain (mode is always sent back) | | routing_simulate_inactivity | DRY RUN of the inactivity chain for a mocked scenario, nothing is sent | | routing_explain_precedence | Which routing rule wins when an agent goes silent, plus conflict warnings | | routing_inactivity_transfers | Count agent inactivity transfers: total, per agent, per day |

Site

| Tool | What It Does | |------|-------------| | site_info | Get site settings, active channels, subscription features, and resource counts |

Live Operations

| Tool | What It Does | |------|-------------| | kpi_snapshot | Real-time ops dashboard — agents online/available/busy, open/queued conversations, bot-active count, resolved today, queue wait times, top agents, channel breakdown, per-team coverage status |

Bot Diagnostics

| Tool | What It Does | |------|-------------| | bot_analytics_summary | AI bot health — total skill calls, error count, success rate, top skill, training count | | bot_skill_usage | Per-skill call counts by integration + error counts — identifies over/underused skills and failing integrations | | bot_recent_errors | Last N AI skill errors with integration, message, and timestamp — for active troubleshooting |

Service Level

| Tool | What It Does | |------|-------------| | service_level_report | SLA compliance per period — % within threshold, avg response time, avg handle time. Granularity: hour/day/week/month |

Reporting & Analytics

| Tool | What It Does | |------|-------------| | report_roi_summary | Full ROI report — bot deflections, hours saved, cost savings, AI skill executions, resolution rate, response time, trends vs prior period, monthly breakdown, top skills by call count, channel breakdown | | report_agent_utilization | Per-agent stats — conversation count, avg handle time, active/away breakdown for any date range | | report_campaign_performance | Email campaign KPIs — open rate, click rate, delivery rate, complaint rate per campaign + aggregate totals | | report_campaign_deliverability | Deliverability health check — bounce rate, complaint rate, unsubscribe rate, open rate with traffic-light status and fix recommendations | | report_campaign_monthly | Month-by-month email volume for the last 12 months | | report_audience_growth | Total active contacts, net contacts (minus unsubscribes), month-by-month additions |

Conversion Tracking

| Tool | What It Does | |------|-------------| | conversion_list_goals | List all conversion goals | | conversion_create_goal | Create a new conversion goal (URL, Shopify, Square, custom event) | | conversion_get_report | Get conversion attribution report — revenue, rates, timeline |

More tools are added on every production release. Run tools/list to see the current full list from your Claude client.

Getting Your API Key

1. Log in to your Velaro admin at admin.velaro.com
2. Go to Settings → API → MCP Keys
3. Click Create Key → give it a label (e.g. "Claude Code")
4. Copy the vel_live_... key — it's shown once

Keys are site-isolated: the key is bound to your Velaro account and can only read/write data for that account. You can create multiple keys and revoke them independently.

Auth Options

| Variable | When to Use | |----------|-------------| | VELARO_MCP_KEY=vel_live_... | Production — create in Settings > API > MCP Keys | | VELARO_JWT=<token> | Development only — short-lived JWT from velaro login |

Staging / Custom API

VELARO_ADMIN_API=https://velaro-admin-staging.azurewebsites.net VELARO_MCP_KEY=vel_live_... npx @velaro/mcp-server

HTTP Mode (Self-Hosted)

Run as an HTTP/SSE server instead of stdio — useful for shared deployments:

VELARO_MCP_MODE=http PORT=3000 VELARO_MCP_KEY=vel_live_... node server.js

Clients connect via GET /mcp (SSE stream) and POST /mcp (JSON-RPC 2.0).

What You Can Do with Velaro + Claude

Once connected, Claude has direct operator access to your support infrastructure:

Knowledge Base Management

"Search my KB for any articles about refund policy and update them to reflect the new 30-day window we announced last week."

Workflow Diagnostics

"List all my disabled workflows and tell me which ones are AI-enhanced so I can decide which to turn back on."

Bot Prompt Tuning

"Read the current system prompt for bot #3 and rewrite it to be more concise and focus on checkout support."

Live Operations

"Show me the last 20 open conversations on the SMS channel and tell me which agents have the most active chats right now."

Contact Lookup

"Search for the contact with email [email protected] and show me their full profile."

Routing Audit

"List all routing rules in priority order — I want to review what fires before the 'Default Team' fallback."

Conversion Tracking

"Create a conversion goal that fires when a customer hits /order-confirmed, with a 24-hour attribution window and $50 default value."

ROI & Analytics

"Pull the last 30-day ROI report. How many conversations did the bot deflect, how many hours did that save, and which AI skills were called the most?"

Deliverability Monitoring

"Check our email deliverability health — is our bounce rate or complaint rate in the red? What should we fix?"

Site Health Check

"Give me a full site overview — active channels, agent count, workflow status, and which subscription features are enabled."

Claude handles these operations natively. No exports, no copy-paste, no waiting for a developer.

How It's Updated

This package is automatically published to npm on every Velaro production deploy. When Velaro ships new tools or improves existing ones, your next npx invocation pulls the latest version automatically. You don't need to update a package.json or run npm install.

If you want a pinned version for reproducible environments:

npx @velaro/[email protected]

Competitive Context

Intercom, Zendesk, and Freshdesk do not publish MCP servers. Connecting Claude to those platforms requires building a custom MCP wrapper against their REST APIs, handling authentication yourself, and maintaining the integration as their APIs change.

Velaro ships the MCP server, hosts it, auto-updates it, and publishes it to npm. The integration is one npx command.

Links

• Velaro Admin
• Documentation
• npm package
• Source
• MCP Specification