A Model Context Protocol server that gives AI coding agents (Claude, Copilot, Cursor and more) direct access to your Vynix annotations, so an agent can read the feedback, see the captured context and screenshots, run an AI diagnosis, generate a fix prompt, open a GitHub issue, update status, and comment, all without leaving the editor.

Every tool carries MCP annotations (read-only / idempotent / open-world hints) so a client can auto-approve safe reads and confirm before writes, AI spend, or GitHub calls.

Tools

Read-only:

Tool	Description
`list_projects`	List the projects you own.
`list_annotations`	List a project's annotations, filtered by status / type / priority.
`get_annotation`	Fetch one annotation with full page / element / DOM / diagnostics context.
`list_comments`	Read an annotation's discussion thread.
`get_annotation_analysis`	Read the latest AI diagnosis (root causes, fix, likely files).
`get_annotation_screenshots`	Return attached screenshots as viewable images.
`list_annotation_issues`	List the GitHub issues opened from an annotation (optionally live).
`list_project_issues`	List every tracker issue across a project, with a summary.
`generate_prompt`	Produce a ready-to-paste prompt (`claude`/`copilot`/`cursor`/`gemini`/`codex`/`generic`).
`get_metrics`	KPI counts, status breakdown, time series, recent activity.
`list_members`	A project's team members.
`get_activity`	A project's recent activity feed.

Writes (a client should confirm these):

Tool	Description
`update_annotation_status`	Move an annotation to `in_progress`, `completed`, etc.
`add_comment`	Post a comment to an annotation's thread (notifies the team).
`diagnose_annotation`	Run the AI Diagnosis Engine (uses an AI provider; stores the result).
`create_github_issue`	File a GitHub issue from an annotation.
`create_share_link`	Mint a read-only public review link for a project.

Prompts

Prompt	Description
`fix_annotation`	A guided, step-by-step workflow that walks the agent from an annotation through context → screenshots → AI diagnosis → fix → status + comment.

Install

Most MCP clients (Cursor, VS Code, Claude Desktop and more) just need a command and a token. Add this to your client's MCP config and npx fetches and runs the server automatically, no global install. Requires Node.js 18+:

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

Generate your token from the Vynix dashboard at https://www.vynix.in/mcp. Config file locations: Cursor ~/.cursor/mcp.json, VS Code .vscode/mcp.json, Claude Desktop claude_desktop_config.json. VS Code uses a top-level "servers" key instead of "mcpServers"; everything else is identical.

Configure

The server talks to the Vynix API. Authenticate with either a token (recommended) or email and password:

VYNIX_API_URL - your Vynix API base URL (default https://www.vynix.in).
VYNIX_API_TOKEN - a token generated at https://www.vynix.in/mcp, or
VYNIX_API_EMAIL + VYNIX_API_PASSWORD - the server logs in on demand and refreshes the token automatically when it expires.

Build & run

npm install
npm run build
npm start          # runs dist/index.js over stdio
npm run dev        # watch mode with tsx
npm test           # smoke test: launches the server and verifies the tool + prompt surface

Run from a local build (contributors)

If you are developing the server itself, point your client at the built dist/index.js instead of npx:

{
  "mcpServers": {
    "vynix": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "VYNIX_API_URL": "https://www.vynix.in",
        "VYNIX_API_TOKEN": "PASTE_YOUR_TOKEN_HERE"
      }
    }
  }
}