X402 Git

genesis-mcp-production-readiness

Velqiris

Test & stress-verify Model Context Protocol servers

Top level of the repository
SizeFolderInside
28.2 kBsrc/6 source files
15.3 kBtests/5 test files
7.6 kBartifacts/2 config files · 1 doc
9.3 kBbin/2 scripts
638 B.github/1 CI file
1.2 kBexamples/1 example
1.7 kBtelemetry/1 config file
15 kB(root)5 docs · 3 config files
29 files · 79 kB · computed 2026-11-17
SizePath
638 B.github/workflows/velqiris-release-gate.yml
103 B.gitignore
2.6 kBCHANGELOG.md
954 BLICENSE
1.2 kBQUICKSTART.md
5.7 kBREADME.md
274 BSECURITY.md
6 BVERSION · binary
2.6 kBaction.yml
352 Bartifacts/velqiris-v2-evidence/manifest.sha256.json
4.6 kBartifacts/velqiris-v2-evidence/report.json
2.6 kBartifacts/velqiris-v2-evidence/report.md
4.1 kBbin/action-runner.js
5.2 kBbin/chitara-mcp-assure.js
1.2 kBexamples/safe-server.js
418 Bpackage-lock.json
1.1 kBpackage.json
15.6 kBsrc/harness.js
1.4 kBsrc/index.js
1.4 kBsrc/redaction.js
3.6 kBsrc/report.js
4.1 kBsrc/static-scan.js
2.1 kBsrc/telemetry.js
1.7 kBtelemetry/funnel-schema.json
6.6 kBtests/action.test.js
5.3 kBtests/assurance.test.js
37 Btests/fixtures/exiting_server.js
1.1 kBtests/fixtures/leaky_server.js
2.3 kBtests/fixtures/mock_mcp_server/server.js
computed 2026-11-17 21:36 UTC · analyzer 0.1.0

Already bought this?

View your purchases

README

Velqiris Release Gate (v2.2.0)

Run the release gate on your MCP server. Buy the signed evidence bundle only when you need release proof.

Deterministic pre-production readiness gate, protocol conformance harness, bounded static scanner, and SHA-256 evidence bundler for stdio Model Context Protocol (MCP) servers — by Chitara Trading.

  • Public Release Gate & benchmarks: https://genesiscode2026.github.io/velqiris/
  • Commercial signed bundle checkout (79 USDC on Base): https://x402git.com/genesiscode2026/genesis-mcp-production-readiness
  • Commercial support: chitara.trading@proton.me

1. 5-Minute GitHub Actions Release Gate

This package includes root action.yml and copy-paste workflow .github/workflows/velqiris-release-gate.yml.

name: Velqiris MCP Release Gate
on: [push, pull_request]

jobs:
  release-gate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: "22"
      - name: Run Velqiris Release Gate
        uses: ./
        with:
          command: node
          args: |
            ./dist/server.js
            --stdio
          source: ./src
          output: ./velqiris-evidence
          fail-on-review: "true"

Action Inputs (No Shell Interpolation)

All inputs pass to bin/action-runner.js via environment variables and spawn the MCP server with shell: false:

InputRequiredDefaultDescription
commandYes—Executable command (for example node, npx, python3)
argsNo""Whitespace/newline-separated arguments, including flags starting with --
sourceNo""Optional source directory for bounded static scan
outputNovelqiris-evidenceOutput directory for report.json, report.md, manifest.sha256.json
fail-on-reviewNo"false"Set "true" to fail the job (exit 1) on REVIEW as well as FAIL

The action writes a Job Summary and uploads velqiris-evidence (report.json, report.md, manifest.sha256.json) even when a control fails (if: always()).


2. What It Audits (9 Runtime Checks + Bounded Static Scan)

Zero external runtime dependencies (Node.js >= 20).

Check IDPhaseVerified Behavior
PROC_STARTStartupDirect process spawn (shell: false) and startup survival grace check
PROTO_INITHandshakeMCP initialize negotiation, notifications/initialized, server metadata
TOOLS_SCHEMADiscoverytools/list uniqueness, non-empty tool names, inputSchema structure & required keys
TOOL_RISK_REVIEWGovernanceFlags high-impact tool capabilities (funds-movement, destructive-mutation, command-execution, filesystem-write, credential-access)
UNKNOWN_TOOLFault HandlingConfirms JSON-RPC error response for unknown tool invocations
CONCURRENCYCorrelationParallel ping / tools/list correlation & JSON-RPC envelope validation
PROTOCOL_PURITYFramingDetects non-JSON stdout pollution that corrupts MCP stdio transport
SECRET_EXPOSURERedactionScans stdout/stderr for 10 secret classes (Anthropic, OpenAI, GitHub, AWS, Slack, Stripe, Postgres URI, private keys, Bearer, JWT) and redacts them
CAPTURE_BOUNDSDeterminismEnforces explicit maxCaptureBytes stream limits and safe UTF-8 decoding

Optional --source <dir> flags COMMAND_EXEC (without RegExp.exec() false positives), SHELL_TRUE, DYNAMIC_EVAL, UNBOUNDED_FS_WRITE, HTTP_WITHOUT_TIMEOUT, and SECRET_* patterns with <source-root> normalization.


3. CLI Usage & Exit Codes

# Built-in compliant server (< 1 second)
node ./bin/chitara-mcp-assure.js --command node --arg ./examples/safe-server.js --json

# Audit with forwarded flags and static source scan
node ./bin/chitara-mcp-assure.js --command node --arg ./dist/server.js --arg --stdio --source ./src --output ./velqiris-evidence --fail-on-review
  • 0 — PASS (or REVIEW without --fail-on-review)
  • 1 — FAIL (or REVIEW with --fail-on-review)
  • 2 — Invalid CLI/Action configuration or missing target

4. Telemetry, Settlement & Scope Separation

  • Zero-PII Funnel Telemetry Schema: telemetry/funnel-schema.json (page_view -> gate_run -> checkout_open -> settlement_verified). Optional local recording via --telemetry-out <file> and --campaign-id <id>. No centralized telemetry endpoint is enabled by default.
  • Commercial Checkout Separation (79 USDC on Base eip155:8453):
  • Artifact delivery: X402 Git automatically authorizes signed .zip download after HTTP 402 payment completion (scan: pass, updates 15 USDC).
  • Platform settlement: On-chain USDC payment (eip155:8453) clears to the X402 Git settlement contract receiver (payTo).
  • Payout wallet: Net seller proceeds target the authorized Chitara Trading Base wallet bound in the merchant account.
  • Platform sweep window: Funds are swept by X402 Git on its published 7-day settlement schedule (separate from instant buyer delivery).
  • Scope & Limitations: Velqiris produces reproducible technical evidence of observable local stdio behavior and bounded static patterns. It is not legal certification, formal penetration testing, dependency provenance guarantee, or a promise of zero vulnerabilities.

5. License

Commercial — Chitara Trading. See LICENSE.

Security scan report

Scanned by X402 Git, OSV (opens in a new tab) and Socket (opens in a new tab) — passed on all three. Findings from X402 Git and OSV are listed below.

secrets
none found
X402 Git
size limits
within caps
X402 Git
known malware
no dependency manifests to check
OSV
known vulnerabilities
no dependency manifests to check
OSV
dependency behaviour
no dependency manifests to check
Socket
instruction smuggling
none found
X402 Git
what it can do
listed below
X402 Git

What this can do

Tools
none
Runs
  • .github/workflows/velqiris-release-gate.yml (push, pull_request, workflow_dispatch)
  • bin/action-runner.js
  • bin/chitara-mcp-assure.js
  • examples/safe-server.js
  • tests/fixtures/exiting_server.js
  • tests/fixtures/leaky_server.js
  • tests/fixtures/mock_mcp_server/server.js
Talks to
genesiscode2026.github.io
Reads
  • GITHUB_ACTIONS
  • JSON
  • PACKAGE_VERSION
At install
nothing runs
Links to
  • genesiscode2026.github.io
  • x402git.com
Findings (12)
  • MODERATE.github/workflows/velqiris-release-gate.yml — A GitHub Actions workflow runs on push, pull_request, workflow_dispatch
  • LOWbin/chitara-mcp-assure.js — Reads the environment variable GITHUB_ACTIONS
  • LOWexamples/safe-server.js — Reads the environment variable JSON
  • LOWbin/chitara-mcp-assure.js — Reads the environment variable PACKAGE_VERSION
  • LOWpackage.json — Talks to genesiscode2026.github.io
  • LOWbin/action-runner.js — Ships the script bin/action-runner.js
  • LOWbin/chitara-mcp-assure.js — Ships the script bin/chitara-mcp-assure.js
  • LOWexamples/safe-server.js — Ships the script examples/safe-server.js
  • LOWtests/fixtures/exiting_server.js — Ships the script tests/fixtures/exiting_server.js
  • LOWtests/fixtures/leaky_server.js — Ships the script tests/fixtures/leaky_server.js
  • LOWtests/fixtures/mock_mcp_server/server.js — Ships the script tests/fixtures/mock_mcp_server/server.js
  • noticeNo package is declared in, or could be read from, this release's dependency manifests (package-lock.json, package.json); nothing it ships was checked against OSV.

Releases 6

  1. v2.2.02026-11-17

    feat: add Velqiris Release Gate action.yml, workflow, and zero-PII funnel telemetry (v2.2.0)

  2. v2.1.22026-11-17

    fix: eliminate RegExp.exec false positive in static scanner (v2.1.2)

  3. v2.1.12026-11-17

    fix: runtime-assembled test fixtures for v2.1.1 scanner compatibility (Chitara Trading)

  1. v2.1.02026-11-17

    feat: ship Velqiris 2.1.0 assurance release (Chitara Trading)

  2. v2.0.02026-11-17

    feat: ship Velqiris 2.0.0 assurance release

  3. v1.0.02026-09-17

    Production-ready release. Audits MCP server configurations for production deployment readiness.

Show moreShow less

$79updates $15

Buy — go to the order block