Vynix MCP Server

Model Context Protocol server for Vynix. It gives coding agents direct access to visual feedback, bug reports, screenshots, diagnostics, comments, and issue workflows so agents can reason from real context instead of guessing.

Why Vynix

• Feedback with evidence: page metadata, target element, screenshot, console/network context.
• End-to-end execution: inspect feedback, diagnose, generate coding prompts, create GitHub issues, update status, comment.
• Agent-safe hints: read-only/idempotent/open-world annotations for better approval behavior in MCP clients.
• Registry-ready metadata for modern MCP directories.

Architecture

flowchart LR
  A[MCP Client\nClaude/Cursor/Copilot/VS Code] -->|stdio or streamable-http| B[Vynix MCP Server]
  B --> C[Vynix API]
  B --> D[GitHub API via Vynix backend]
  C --> E[Projects]
  C --> F[Annotations]
  C --> G[Screenshots and diagnostics]

Features

• 17 production tools for read and write workflows.
• Resource catalog for server metadata, tool/prompt/skill references, and contextual summaries.
• Workflow prompts for QA, release readiness, PM briefings, and engineering planning.
• Dual transport support: stdio and Streamable HTTP.
• Auth via API token or email/password refresh flow.

Installation

Node.js 18+ is required.

NPX (recommended)

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_URL": "https://www.vynix.in",
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

npm global install

npm install -g @usevynix/mcp-server
vynix-mcp

Docker

docker run --rm -i \
  -e VYNIX_API_URL=https://www.vynix.in \
  -e VYNIX_API_TOKEN=PASTE_YOUR_TOKEN_HERE \
  ghcr.io/usevynix/vynix-mcp:latest

Local development

git clone https://github.com/UseVynix/vynix-mcp.git
cd vynix-mcp
npm install
npm run build
npm run check
node dist/index.js

Client Configuration

Claude Desktop

Use claude_desktop_config.json:

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Diagnostics are written to stderr; stdout is reserved for the protocol stream.

Cursor

Use ~/.cursor/mcp.json.

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

VS Code

Use .vscode/mcp.json with top-level servers:

{
  "servers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

Windsurf

Use your Windsurf MCP config file with this server block:

{
  "mcpServers": {
    "vynix": {
      "command": "npx",
      "args": ["-y", "@usevynix/mcp-server"],
      "env": {
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}

ChatGPT connectors

For hosted mode, use the Streamable HTTP endpoint:

• Base URL: https://mcp.vynix.in/mcp
• OAuth discovery: /.well-known/oauth-authorization-server

Generic mcp.json

See [examples/configs/mc

... View full README on GitHub