genesis-mcp-production-readiness
Test & stress-verify Model Context Protocol servers
| Size | Folder | Inside |
|---|---|---|
| 28.2 kB | src/ | 6 source files |
| 15.3 kB | tests/ | 5 test files |
| 7.6 kB | artifacts/ | 2 config files · 1 doc |
| 9.3 kB | bin/ | 2 scripts |
| 638 B | .github/ | 1 CI file |
| 1.2 kB | examples/ | 1 example |
| 1.7 kB | telemetry/ | 1 config file |
| 15 kB | (root) | 5 docs · 3 config files |
| Size | Path |
|---|---|
| 638 B | .github/workflows/velqiris-release-gate.yml |
| 103 B | .gitignore |
| 2.6 kB | CHANGELOG.md |
| 954 B | LICENSE |
| 1.2 kB | QUICKSTART.md |
| 5.7 kB | README.md |
| 274 B | SECURITY.md |
| 6 B | VERSION · binary |
| 2.6 kB | action.yml |
| 352 B | artifacts/velqiris-v2-evidence/manifest.sha256.json |
| 4.6 kB | artifacts/velqiris-v2-evidence/report.json |
| 2.6 kB | artifacts/velqiris-v2-evidence/report.md |
| 4.1 kB | bin/action-runner.js |
| 5.2 kB | bin/chitara-mcp-assure.js |
| 1.2 kB | examples/safe-server.js |
| 418 B | package-lock.json |
| 1.1 kB | package.json |
| 15.6 kB | src/harness.js |
| 1.4 kB | src/index.js |
| 1.4 kB | src/redaction.js |
| 3.6 kB | src/report.js |
| 4.1 kB | src/static-scan.js |
| 2.1 kB | src/telemetry.js |
| 1.7 kB | telemetry/funnel-schema.json |
| 6.6 kB | tests/action.test.js |
| 5.3 kB | tests/assurance.test.js |
| 37 B | tests/fixtures/exiting_server.js |
| 1.1 kB | tests/fixtures/leaky_server.js |
| 2.3 kB | tests/fixtures/mock_mcp_server/server.js |
Already bought this?
View your purchasesREADME
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 USDCon 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:
| Input | Required | Default | Description |
|---|---|---|---|
command | Yes | — | Executable command (for example node, npx, python3) |
args | No | "" | Whitespace/newline-separated arguments, including flags starting with -- |
source | No | "" | Optional source directory for bounded static scan |
output | No | velqiris-evidence | Output directory for report.json, report.md, manifest.sha256.json |
fail-on-review | No | "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 ID | Phase | Verified Behavior |
|---|---|---|
PROC_START | Startup | Direct process spawn (shell: false) and startup survival grace check |
PROTO_INIT | Handshake | MCP initialize negotiation, notifications/initialized, server metadata |
TOOLS_SCHEMA | Discovery | tools/list uniqueness, non-empty tool names, inputSchema structure & required keys |
TOOL_RISK_REVIEW | Governance | Flags high-impact tool capabilities (funds-movement, destructive-mutation, command-execution, filesystem-write, credential-access) |
UNKNOWN_TOOL | Fault Handling | Confirms JSON-RPC error response for unknown tool invocations |
CONCURRENCY | Correlation | Parallel ping / tools/list correlation & JSON-RPC envelope validation |
PROTOCOL_PURITY | Framing | Detects non-JSON stdout pollution that corrupts MCP stdio transport |
SECRET_EXPOSURE | Redaction | Scans stdout/stderr for 10 secret classes (Anthropic, OpenAI, GitHub, AWS, Slack, Stripe, Postgres URI, private keys, Bearer, JWT) and redacts them |
CAPTURE_BOUNDS | Determinism | Enforces 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(orREVIEWwithout--fail-on-review)1—FAIL(orREVIEWwith--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 USDCon Baseeip155:8453): - Artifact delivery: X402 Git automatically authorizes signed
.zipdownload after HTTP402payment completion (scan: pass, updates15 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
- v2.2.02026-11-17
feat: add Velqiris Release Gate action.yml, workflow, and zero-PII funnel telemetry (v2.2.0)
- v2.1.22026-11-17
fix: eliminate RegExp.exec false positive in static scanner (v2.1.2)
- v2.1.12026-11-17
fix: runtime-assembled test fixtures for v2.1.1 scanner compatibility (Chitara Trading)
- v2.1.02026-11-17
feat: ship Velqiris 2.1.0 assurance release (Chitara Trading)
- v2.0.02026-11-17
feat: ship Velqiris 2.0.0 assurance release
- v1.0.02026-09-17
Production-ready release. Audits MCP server configurations for production deployment readiness.