vynix-mcp
Vynix MCP server. Give AI coding agents access to your visual feedback and bug reports.
Install / Use
claude mcp add UseVynix -- npx -y github:UseVynix/vynix-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of vynix-mcp
vynix-mcp scores 80/100 on our quality scale, 3579th of 4,700 Development & Engineering skills we index.
Its MCP Server is 6.1 KB long, well organised into 28 sections with 10 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 3 months ago, so vynix-mcp is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
vynix-mcp compared with similar skills
All 4 of these similar skills score higher than vynix-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| vynix-mcp (this skill)by UseVynix | 80 | 10 | 3mo ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install vynix-mcp?
- Run
claude mcp add UseVynix -- npx -y github:UseVynix/vynix-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does vynix-mcp work with?
- It is written for Claude Code, Claude Desktop and GitHub Copilot, as a MCP Server file. Other agents that read the same format can often use it too.
- Is vynix-mcp safe to use?
- It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is vynix-mcp still maintained?
- The repository was last updated about 3 months ago, so vynix-mcp is actively maintained.
Skill content
View source on GitHubVynix 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:
stdioand 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": "PAST…[redacted]"
}
}
}
}
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=PAST…[redacted] \
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": "PAST…[redacted]"
}
}
}
}
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": "PAST…[redacted]"
}
}
}
}
VS Code
Use .vscode/mcp.json with top-level servers:
{
"servers": {
"vynix": {
"command": "npx",
"args": ["-y", "@usevynix/mcp-server"],
"env": {
"VYNIX_API_TOKEN": "PAST…[redacted]"
}
}
}
}
Windsurf
Use your Windsurf MCP config file with this server block:
{
"mcpServers": {
"vynix": {
"command": "npx",
"args": ["-y", "@usevynix/mcp-server"],
"env": {
"VYNIX_API_TOKEN": "PAST…[redacted]"
}
}
}
}
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/mcp.json.
Authentication
Environment variables:
VYNIX_API_URL(optional, default:https://www.vynix.in)VYNIX_API_TOKEN(recommended)VYNIX_API_EMAILandVYNIX_API_PASSWORD(fallback login mode)VYNIX_MCP_MODE(stdioorhttp)VYNIX_MCP_HOST,VYNIX_MCP_PORT,VYNIX_MCP_PATH(HTTP mode)
Generate a token from: https://www.vynix.in/mcp
Tools, Prompts, and Resources
- Tool reference: docs/tools.md
- Prompt reference: docs/prompts.md
- Resource reference: docs/resources.md
- Skill/workflow reference: docs/skills.md
- Deployment guide: docs/deployment.md
- Agent discovery guide: docs/agent-discovery.md
- LLM index file: llms.txt
- Directory listing tracker: docs/listings-status.md
Examples
- Conversation workflows: examples/workflows
- Prompt library (100+ prompts): examples/prompts.md
Troubleshooting
Not configurederror: setVYNIX_API_TOKENor bothVYNIX_API_EMAILandVYNIX_API_PASSWORD.401errors: regenerate token and verify API URL.- No tools listed: confirm the MCP config key (
mcpServersvsservers) for your client. - Hosted mode not reachable: verify
VYNIX_MCP_MODE=httpand check/health.
FAQ
Does this send data to third-party AI providers?
Only diagnose_annotation can invoke external AI providers through your Vynix workspace configuration.
Is this read-only?
No. It includes read tools and write tools. MCP annotations identify mutating/open-world calls so clients can request confirmation.
Can I self-host?
Yes. Run in stdio mode locally or HTTP mode behind your own infrastructure.
Contributing
See CONTRIBUTING.md. For local validation run:
npm run check
Security
- Never commit API tokens.
- Prefer short-lived tokens where possible.
- See SECURITY.md (create one if your org requires a disclosure policy).
License
Changelog
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
