{"_id":"@blackwell-systems/jest-mcp-assert","_rev":"2-89c55667c6208216da842ef41863600a","name":"@blackwell-systems/jest-mcp-assert","dist-tags":{"latest":"0.12.3"},"versions":{"0.12.2":{"name":"@blackwell-systems/jest-mcp-assert","version":"0.12.2","keywords":["jest","mcp","testing","assertions","model-context-protocol"],"author":{"name":"Blackwell Systems","email":"dayna@blackwell-systems.com"},"license":"MIT","_id":"@blackwell-systems/jest-mcp-assert@0.12.2","maintainers":[{"name":"daynajblackwell","email":"dayna@blackwell-systems.com"}],"homepage":"https://github.com/blackwell-systems/mcp-assert","bugs":{"url":"https://github.com/blackwell-systems/mcp-assert/issues"},"dist":{"shasum":"98781d8f8c416eb26e01a44c322df9a99dc88444","tarball":"https://registry.npmjs.org/@blackwell-systems/jest-mcp-assert/-/jest-mcp-assert-0.12.2.tgz","fileCount":12,"integrity":"sha512-H6MieceFwNJNEpXhbFQVl1NqzdhPGFwmexDNJv1S0a/BimFQ344bG8zkCcPqGkeIOLNHGjKAfL4wy1k4EG65qA==","signatures":[{"sig":"MEQCIAp2ayPc7RuJXjWfGuuHyqzVWzh4IkgjHUS40QVvvyrFAiA63NsGR2/enV8gtkRHfM4QlH8gRFmMIjhhEfCHuJZEZQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":13394},"main":"dist/index.js","types":"dist/index.d.ts","gitHead":"c71b2438751ebddcb96fa6429281feb7c0aec8aa","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"daynajblackwell","email":"dayna@blackwell-systems.com"},"repository":{"url":"git+https://github.com/blackwell-systems/mcp-assert.git","type":"git","directory":"jest-plugin"},"_npmVersion":"10.8.2","description":"Jest integration for mcp-assert: run MCP server assertion YAML files as Jest tests","directories":{},"_nodeVersion":"20.20.2","_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.0","@types/node":"^20.0.0","@jest/globals":"^29.7.0"},"peerDependencies":{"@jest/globals":">=29.0.0"},"_npmOperationalInternal":{"tmp":"tmp/jest-mcp-assert_0.12.2_1780555923953_0.7802045374776452","host":"s3://npm-registry-packages-npm-production"}},"0.12.3":{"name":"@blackwell-systems/jest-mcp-assert","version":"0.12.3","description":"Jest integration for mcp-assert: run MCP server assertion YAML files as Jest tests","main":"dist/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc","prepublishOnly":"npm run build"},"keywords":["jest","mcp","testing","assertions","model-context-protocol"],"author":{"name":"Blackwell Systems","email":"dayna@blackwell-systems.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/blackwell-systems/mcp-assert.git","directory":"jest-plugin"},"homepage":"https://github.com/blackwell-systems/mcp-assert","peerDependencies":{"@jest/globals":">=29.0.0"},"devDependencies":{"@jest/globals":"^29.7.0","typescript":"^5.4.0","@types/node":"^20.0.0"},"_id":"@blackwell-systems/jest-mcp-assert@0.12.3","gitHead":"927afecba3edcd90270816884757ebecb7056a01","bugs":{"url":"https://github.com/blackwell-systems/mcp-assert/issues"},"_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-uv4dTWs2c5FTiaGp8umzaVTjjY6sN4obvu2Z7nHURTYHMlNZ5outo3zUlJKXuZZavvlXChWqS284bOFsryeNog==","shasum":"a3bb02bffa67a3daf4dc6eda618ebf495290de77","tarball":"https://registry.npmjs.org/@blackwell-systems/jest-mcp-assert/-/jest-mcp-assert-0.12.3.tgz","fileCount":12,"unpackedSize":13394,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCK40L1JVRnI9UX2z0cLFwwHMIVSp5tdP9sqgKjZaoWzQIgaPDmiSYIQ/s8vdQMoDFnpbvveKKPsRAjlMtaPq977WI="}]},"_npmUser":{"name":"daynajblackwell","email":"dayna@blackwell-systems.com"},"directories":{},"maintainers":[{"name":"daynajblackwell","email":"dayna@blackwell-systems.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/jest-mcp-assert_0.12.3_1780601764102_0.8724298284192855"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-04T06:52:03.832Z","modified":"2026-06-04T19:36:04.373Z","0.12.2":"2026-06-04T06:52:04.106Z","0.12.3":"2026-06-04T19:36:04.262Z"},"bugs":{"url":"https://github.com/blackwell-systems/mcp-assert/issues"},"author":{"name":"Blackwell Systems","email":"dayna@blackwell-systems.com"},"license":"MIT","homepage":"https://github.com/blackwell-systems/mcp-assert","keywords":["jest","mcp","testing","assertions","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/blackwell-systems/mcp-assert.git","directory":"jest-plugin"},"description":"Jest integration for mcp-assert: run MCP server assertion YAML files as Jest tests","maintainers":[{"name":"daynajblackwell","email":"dayna@blackwell-systems.com"}],"readme":"# @blackwell-systems/jest-mcp-assert\n\nJest integration for [mcp-assert](https://github.com/blackwell-systems/mcp-assert). Run MCP server assertion YAML files as Jest tests.\n\nSame YAML files work across Jest, Vitest, pytest, and the CLI.\n\n## Install\n\n```bash\nnpm install -D @blackwell-systems/jest-mcp-assert @blackwell-systems/mcp-assert\n```\n\n## Usage\n\n### Suite mode (auto-discover YAML files)\n\n```ts\n// mcp.test.ts\nimport { describeMcpSuite } from '@blackwell-systems/jest-mcp-assert'\n\ndescribeMcpSuite('my mcp server', 'evals/')\n```\n\nEach YAML file in `evals/` becomes a Jest test case.\n\n### Single assertion mode\n\n```ts\nimport { runMcpAssert } from '@blackwell-systems/jest-mcp-assert'\n\ntest('echo tool returns message', () => {\n  runMcpAssert('evals/echo.yaml')\n})\n\ntest('greet tool with timeout', () => {\n  runMcpAssert('evals/greet.yaml', { timeout: '60s' })\n})\n```\n\n### Options\n\n```ts\nrunMcpAssert('evals/echo.yaml', {\n  timeout: '30s',           // per-assertion timeout\n  fixture: 'test/fixtures', // {{fixture}} substitution\n  server: 'node server.js', // server override\n  binary: '/path/to/mcp-assert', // explicit binary path\n})\n```\n\n## How it works\n\n@blackwell-systems/jest-mcp-assert is a thin bridge (~100 lines). It shells out to the mcp-assert Go binary with `--json`, parses the result, and maps it to Jest pass/fail outcomes. The Go binary handles all MCP protocol logic.\n\nBinary resolution (in order):\n1. Explicit `binary` option\n2. `mcp-assert` on PATH (brew, go install, curl install)\n3. `@blackwell-systems/mcp-assert` npm package\n\n## Writing assertions\n\nAssertions are YAML files. See the [mcp-assert docs](https://blackwell-systems.github.io/mcp-assert) for the full reference.\n\n```yaml\nname: echo returns the input message\nserver:\n  command: node\n  args: [\"server.js\"]\nassert:\n  tool: echo\n  args:\n    message: \"hello\"\n  expect:\n    not_error: true\n    contains: [\"hello\"]\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}