MCP Server

neru-mcp is a Model Context Protocol (MCP) server that lets your AI assistant publish and deploy applications to Code Hub without leaving your chat interface. You can create Code Hub products, upload source code, publish versions, and deploy running VCR instances entirely through natural language instructions.

Connect to the Hosted Server

neru-mcp runs on VCR and is available as a remote endpoint — no local installation is required. Choose the endpoint closest to your region.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "neru-mcp": {
      "type": "http",
      "url": "https://vcr-mcp.euw1.runtime.vonage.cloud/mcp",
      "headers": {
        "X-Account-ID": "<your-api-key>",
        "X-Account-Secret": "<your-api-secret>",
        "X-Region": "euw1"
      }
    }
  }
}

VS Code / GitHub Copilot

Add to .vscode/mcp.json (or your workspace MCP config):

{
  "servers": {
    "neru-mcp": {
      "type": "http",
      "url": "https://vcr-mcp.euw1.runtime.vonage.cloud/mcp",
      "headers": {
        "X-Account-ID": "<your-api-key>",
        "X-Account-Secret": "<your-api-secret>",
        "X-Region": "euw1"
      }
    }
  }
}

OpenCode

Add to your OpenCode config:

{
  "mcp": {
    "neru-mcp": {
      "type": "remote",
      "url": "https://vcr-mcp.euw1.runtime.vonage.cloud/mcp",
      "enabled": true,
      "headers": {
        "X-Account-ID": "<your-api-key>",
        "X-Account-Secret": "<your-api-secret>",
        "X-Region": "euw1"
      }
    }
  }
}

Replace <your-api-key> and <your-api-secret> with your Vonage API credentials). Set X-Region to the region where you want to deploy.

Credentials

Every tool accepts credentials either as HTTP headers (recommended) or as explicit tool parameters. Headers take precedence when both are present.

Standard Deployment Workflow

You can ask your AI assistant to run this entire flow: "Publish my VCR app to Code Hub". The assistant will call each tool in order, prompt you for any missing values, and return the live instance URL at the end.

Create Code Hub product
        |
Create product version
        |
Upload source code  (POST zip to returned proxy_url)
        |
Submit version for review
        |
Release version
        |
Install as VCR instance

Tools Reference

marketplace_create_product

Create a new product in Code Hub.

Returns: {"id": "<uuid>", "codehub_url": "https://developer.vonage.com/..."}

marketplace_create_version

Create a new version for an existing Code Hub product. Deployment is enabled automatically after creation.

Returns: {"id": "<uuid>", "productId": "<uuid>"}

marketplace_upload_source

Returns a proxy URL for uploading the source code zip archive. POST the zip directly to proxy_url — do not base64-encode it. The zip must contain vcr.yml at its root (not inside a subdirectory).

Returns: {"proxy_url": "...", "method": "POST", "field_name": "source", "instructions": "..."}

Example upload:

marketplace_submit_version

Submit a version for review. Required before a version can be published publicly on Code Hub.

Returns: {"message": "Version submitted for review"}

marketplace_release_version

Release an approved version to Code Hub. The version must have been submitted and approved first.

Returns: {"message": "Version released to the Marketplace"}

marketplace_install_version

Install a released Code Hub product version as a live VCR instance.

Returns: {"instance_url": "...", "codehub_url": "...", ...}

Additional Tools

Run Locally

If you prefer to run the MCP server locally instead of using the hosted endpoints:

Set the following environment variables before running: