{
  "markdown": "# Vynix MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@usevynix/mcp-server)](https://www.npmjs.com/package/@usevynix/mcp-server)\n[![npm downloads](https://img.shields.io/npm/dm/@usevynix/mcp-server)](https://www.npmjs.com/package/@usevynix/mcp-server)\n[![license](https://img.shields.io/github/license/UseVynix/vynix-mcp)](LICENSE)\n[![ci](https://img.shields.io/github/actions/workflow/status/UseVynix/vynix-mcp/ci.yml?branch=main)](https://github.com/UseVynix/vynix-mcp/actions)\n[![vynix-mcp MCP server](https://glama.ai/mcp/servers/UseVynix/vynix-mcp/badges/score.svg)](https://glama.ai/mcp/servers/UseVynix/vynix-mcp)\n\nModel 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.\n\n## Why Vynix\n\n- Feedback with evidence: page metadata, target element, screenshot, console/network context.\n- End-to-end execution: inspect feedback, diagnose, generate coding prompts, create GitHub issues, update status, comment.\n- Agent-safe hints: read-only/idempotent/open-world annotations for better approval behavior in MCP clients.\n- Registry-ready metadata for modern MCP directories.\n\n## Architecture\n\n```mermaid\nflowchart LR\n  A[MCP Client\\nClaude/Cursor/Copilot/VS Code] -->|stdio or streamable-http| B[Vynix MCP Server]\n  B --> C[Vynix API]\n  B --> D[GitHub API via Vynix backend]\n  C --> E[Projects]\n  C --> F[Annotations]\n  C --> G[Screenshots and diagnostics]\n```\n\n## Features\n\n- 17 production tools for read and write workflows.\n- Resource catalog for server metadata, tool/prompt/skill references, and contextual summaries.\n- Workflow prompts for QA, release readiness, PM briefings, and engineering planning.\n- Dual transport support: `stdio` and Streamable HTTP.\n- Auth via API token or email/password refresh flow.\n\n## Installation\n\nNode.js 18+ is required.\n\n### NPX (recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"vynix\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@usevynix/mcp-server\"],\n      \"env\": {\n        \"VYNIX_API_URL\": \"https://www.vynix.in\",\n        \"VYNIX_API_TOKEN\": \"PASTE_YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n### npm global install\n\n```bash\nnpm install -g @usevynix/mcp-server\nvynix-mcp\n```\n\n### Docker\n\n```bash\ndocker run --rm -i \\\n  -e VYNIX_API_URL=https://www.vynix.in \\\n  -e VYNIX_API_TOKEN=PASTE_YOUR_TOKEN_HERE \\\n  ghcr.io/usevynix/vynix-mcp:latest\n```\n\n### Local development\n\n```bash\ngit clone https://github.com/UseVynix/vynix-mcp.git\ncd vynix-mcp\nnpm install\nnpm run build\nnpm run check\nnode dist/index.js\n```\n\n## Client Configuration\n\n### Claude Desktop\n\nUse `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vynix\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@usevynix/mcp-server\"],\n      \"env\": {\n        \"VYNIX_API_TOKEN\": \"PASTE_YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\nDiagnostics are written to stderr; stdout is reserved for the protocol stream.\n\n### Cursor\n\nUse `~/.cursor/mcp.json`.\n\n```json\n{\n  \"mcpServers\": {\n    \"vynix\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@usevynix/mcp-server\"],\n      \"env\": {\n        \"VYNIX_API_TOKEN\": \"PASTE_YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n### VS Code\n\nUse `.vscode/mcp.json` with top-level `servers`:\n\n```json\n{\n  \"servers\": {\n    \"vynix\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@usevynix/mcp-server\"],\n      \"env\": {\n        \"VYNIX_API_TOKEN\": \"PASTE_YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nUse your Windsurf MCP config file with this server block:\n\n```json\n{\n  \"mcpServers\": {\n    \"vynix\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@usevynix/mcp-server\"],\n      \"env\": {\n        \"VYNIX_API_TOKEN\": \"PASTE_YOUR_TOKEN_HERE\"\n      }\n    }\n  }\n}\n```\n\n### ChatGPT connectors\n\nFor hosted mode, use the Streamable HTTP endpoint:\n\n- Base URL: `https://mcp.vynix.in/mcp`\n- OAuth discovery: `/.well-known/oauth-authorization-server`\n\n### Generic mcp.json\n\nSee [examples/configs/mcp.json](examples/configs/mcp.json).\n\n## Authentication\n\nEnvironment variables:\n\n- `VYNIX_API_URL` (optional, default: `https://www.vynix.in`)\n- `VYNIX_API_TOKEN` (recommended)\n- `VYNIX_API_EMAIL` and `VYNIX_API_PASSWORD` (fallback login mode)\n- `VYNIX_MCP_MODE` (`stdio` or `http`)\n- `VYNIX_MCP_HOST`, `VYNIX_MCP_PORT`, `VYNIX_MCP_PATH` (HTTP mode)\n\nGenerate a token from: <https://www.vynix.in/mcp>\n\n## Tools, Prompts, and Resources\n\n- Tool reference: [docs/tools.md](docs/tools.md)\n- Prompt reference: [docs/prompts.md](docs/prompts.md)\n- Resource reference: [docs/resources.md](docs/resources.md)\n- Skill/workflow reference: [docs/skills.md](docs/skills.md)\n- Deployment guide: [docs/deployment.md](docs/deployment.md)\n- Agent discovery guide: [docs/agent-discovery.md](docs/agent-discovery.md)\n- LLM index file: [llms.txt](llms.txt)\n- Directory listing tracker: [docs/listings-status.md](docs/listings-status.md)\n\n## Examples\n\n- Conversation workflows: [examples/workflows](examples/workflows)\n- Prompt library (100+ prompts): [examples/prompts.md](examples/prompts.md)\n\n## Troubleshooting\n\n- `Not configured` error: set `VYNIX_API_TOKEN` or both `VYNIX_API_EMAIL` and `VYNIX_API_PASSWORD`.\n- `401` errors: regenerate token and verify API URL.\n- No tools listed: confirm the MCP config key (`mcpServers` vs `servers`) for your client.\n- Hosted mode not reachable: verify `VYNIX_MCP_MODE=http` and check `/health`.\n\n## FAQ\n\n### Does this send data to third-party AI providers?\n\nOnly `diagnose_annotation` can invoke external AI providers through your Vynix workspace configuration.\n\n### Is this read-only?\n\nNo. It includes read tools and write tools. MCP annotations identify mutating/open-world calls so clients can request confirmation.\n\n### Can I self-host?\n\nYes. Run in stdio mode locally or HTTP mode behind your own infrastructure.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md). For local validation run:\n\n```bash\nnpm run check\n```\n\n## Security\n\n- Never commit API tokens.\n- Prefer short-lived tokens where possible.\n- See [SECURITY.md](SECURITY.md) (create one if your org requires a disclosure policy).\n\n## License\n\n[MIT](LICENSE)\n\n## Changelog\n\n[CHANGELOG.md](CHANGELOG.md)\n",
  "bytes": 6197,
  "sha": "8ae99480a2da1cb8552a70c0463e40f4f082a461e19151fdf693d69fcf4accb4",
  "repo_slug": "usevynix/vynix-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_in_vynix_vynix_mcp_afb72af0/readme"
}