{"owner":"genesiscode2026","slug":"genesis-openapi-mcp-builder","channel":"genesiscode2026/genesis-openapi-mcp-builder","version":"1.0.0","artifact_sha256":"f47a2aa099a62ca96d5bb5e0b19411f80a65093c8a860a367f810b83dbe52b00","published_at":"2026-09-17T11:43:16.778Z","price_micro":"99000000","update_price_micro":"15000000","resource_endpoint":"https://x402git.com/api/r/genesiscode2026/genesis-openapi-mcp-builder","version_url":"https://x402git.com/api/v/genesiscode2026/genesis-openapi-mcp-builder","computed":{"artifact_class":"Harness","component_inventory":[{"kind":"scripts","count":1},{"kind":"source","count":3},{"kind":"tests","count":2},{"kind":"docs","count":5},{"kind":"config","count":1},{"kind":"assets","count":1},{"kind":"other","count":1}],"file_count":14,"dir_depth":2,"bytes_text":24534,"bytes_binary":6,"languages":{"JavaScript":16745},"tree":[{"path":".gitignore","size":103,"binary":false},{"path":"CHANGELOG.md","size":587,"binary":false},{"path":"LICENSE","size":961,"binary":false},{"path":"QUICKSTART.md","size":618,"binary":false},{"path":"README.md","size":3023,"binary":false},{"path":"SECURITY.md","size":274,"binary":false},{"path":"VERSION","size":6,"binary":true},{"path":"bin/genesis-openapi-mcp.js","size":3791,"binary":false},{"path":"package.json","size":687,"binary":false},{"path":"src/generator.js","size":5975,"binary":false},{"path":"src/index.js","size":201,"binary":false},{"path":"src/parser.js","size":2893,"binary":false},{"path":"tests/fixtures/petstore_openapi.json","size":1536,"binary":false},{"path":"tests/test_builder.js","size":3885,"binary":false}],"readme_html":"<h2>Genesis OpenAPI to MCP Production Builder</h2>\n<p>Deterministic compiler generating ready-to-deploy, typed Model Context Protocol (MCP) servers directly from OpenAPI 3.x specifications.</p>\n<hr />\n<h4>1. What Problem Does This Solve?</h4>\n<p>Engineering teams with existing REST APIs want autonomous agents (Claude Code, Cursor, Codex) to invoke their backend services via MCP. Manually writing boilerplate MCP servers, translating path parameters, validating query strings, wiring authentication headers, and formatting error envelopes takes days and introduces protocol inconsistencies.</p>\n<p><code>genesis-openapi-mcp-builder</code> compiles any valid OpenAPI 3.x specification into a standalone, production-ready Node.js MCP server in seconds.</p>\n<h4>2. Who Buys It?</h4>\n<ul><li>Backend Engineers and API Platform Teams enabling AI agent access to internal microservices.</li><li>SaaS companies distributing official MCP connectors for their developer platforms.</li><li>Autonomous agent developers integrating external REST APIs into multi-tool agent sessions.</li></ul>\n<h4>3. What Does It Output?</h4>\n<p>A complete, self-contained MCP server package ready to run via stdio or deploy as a microservice:</p>\n<ul><li><code>server.js</code>: Zero-dependency JSON-RPC 2.0 MCP server with path parameter interpolation and query mapping.</li><li><code>package.json</code>: Manifest configured with <code>engines</code> and startup scripts.</li><li><code>README.md</code>: Auto-generated tool documentation and agent configuration runbook.</li></ul>\n<h4>4. How Fast Can You Test It?</h4>\n<p>Under 5 seconds. Run:</p>\n<pre><code class=\"language-bash\">./bin/genesis-openapi-mcp.js --spec ./tests/fixtures/petstore_openapi.json --out ./my-mcp\n</code></pre>\n<h4>5. Why Is This Different From Generic Wrappers?</h4>\n<p>Generic wrappers rely on heavy runtime SDKs or dynamically evaluate untyped endpoints at runtime. <code>genesis-openapi-mcp-builder</code> is an <strong>ahead-of-time deterministic compiler</strong> that generates clean, zero-dependency Node 18+ JavaScript with strict JSON Schema parameter validation, native <code>fetch</code> dispatch, and clean error masking.</p>\n<hr />\n<h3>Installation &amp; Usage</h3>\n<pre><code class=\"language-bash\"># Compile an OpenAPI specification into an MCP server\nnpx genesis-openapi-mcp --spec ./swagger.json --out ./mcp-server\n\n# Override API Base URL and specify custom token environment variable\nnpx genesis-openapi-mcp \\\n  --spec ./api-spec.json \\\n  --out ./orders-mcp \\\n  --base-url &quot;https://api.internal.company.com/v2&quot; \\\n  --auth-env &quot;INTERNAL_SERVICE_KEY&quot;\n\n# Output compilation metadata in JSON for CI/CD pipelines\nnpx genesis-openapi-mcp --spec ./api.json --out ./out-mcp --json\n</code></pre>\n<h3>Generated MCP Server Capabilities</h3>\n<ul><li><strong>Protocol Conformance</strong>: Full compliance with the official MCP 2024-11-05 specification over standard I/O.</li><li><strong>Typed Input Schemas</strong>: OpenAPI properties converted to strict JSON Schema for high-precision model tool calls.</li><li><strong>Authentication</strong>: Native forwarding of Bearer tokens or API keys via configurable environment variables.</li><li><strong>Zero Dependencies</strong>: Generated servers run directly on native Node 18+ without requiring external npm packages.</li></ul>\n<h3>License</h3>\n<p>Commercial — Genesis Code (genesiscode2026). See <code>LICENSE</code>.</p>","dependencies":[],"licence":{"verdict":"manual"},"scan":{"verdict":"pass","scanner_version":"2026.09.1","at":"2026-09-17T11:43:19.692Z","checks":[{"id":"secrets","tool":"x402git/secrets","tool_version":"2026.09.1","status":"pass","at":"2026-09-17T11:43:19.692Z","findings":0},{"id":"limits","tool":"x402git/limits","tool_version":"2026.09.1","status":"pass","at":"2026-09-17T11:43:19.692Z","findings":0},{"id":"known_vulns","tool":"osv.dev","tool_version":"2026-09-17","status":"pass","at":"2026-09-17T11:43:19.692Z","findings":0,"packages":0},{"id":"known_malware","tool":"osv.dev/MAL","tool_version":"2026-09-17","status":"pass","at":"2026-09-17T11:43:19.692Z","findings":0,"packages":0},{"id":"dep_behaviour","tool":"socket.dev","tool_version":"2026-09-17","status":"findings","at":"2026-09-17T11:43:19.692Z","findings":1,"packages":1},{"id":"capabilities","tool":"x402git/caps","tool_version":"2026.09.1","status":"findings","at":"2026-09-17T11:43:19.692Z","findings":4},{"id":"injection","tool":"x402git/inject","tool_version":"2026.09.1","status":"pass","at":"2026-09-17T11:43:19.692Z","findings":0}],"findings":[{"kind":"capability","check":"capabilities","tier":"disclosed","rule_id":"script","severity":"LOW","description":"Ships the script bin/genesis-openapi-mcp.js","path":"bin/genesis-openapi-mcp.js"},{"kind":"capability","check":"capabilities","tier":"disclosed","rule_id":"host","severity":"LOW","description":"Talks to api.example.com","path":"tests/fixtures/petstore_openapi.json"},{"kind":"capability","check":"capabilities","tier":"disclosed","rule_id":"host","severity":"LOW","description":"Talks to mock.example.com","path":"tests/test_builder.js"},{"kind":"capability","check":"capabilities","tier":"disclosed","rule_id":"env","severity":"LOW","description":"Reads the environment variable API_BASE_URL","path":"src/generator.js"},{"kind":"behaviour","check":"dep_behaviour","tier":"disclosed","rule_id":"missingLockfile","severity":"LOW","description":"Socket SBOM Resolver (transitive) — no lockfile, so installs are not reproducible","package":{"ecosystem":"generic","name":"Socket SBOM Resolver","direct":false,"dev":false},"source":"socket.dev"}],"capabilities":{"tools":[],"runs":[{"path":"bin/genesis-openapi-mcp.js","kind":"script"}],"hosts":[{"host":"api.example.com","local":false,"from":"code","paths":["tests/fixtures/petstore_openapi.json"]},{"host":"localhost:8080","local":true,"from":"code","paths":["src/parser.js"]},{"host":"mock.example.com","local":false,"from":"code","paths":["tests/test_builder.js"]},{"host":"api.internal.company.com","local":false,"from":"docs","paths":["README.md"]},{"host":"api.mycompany.com","local":false,"from":"docs","paths":["QUICKSTART.md"]}],"env":[{"name":"API_BASE_URL","paths":["src/generator.js"]}],"install_runs":false,"summary":"runs a script · talks to 3 hosts · links to 2 hosts in its docs · reads 1 environment variable · nothing runs at install"},"counts":{"blocking":0,"disclosed":5,"review":0}},"cadence_sentence":"One release so far.","originality":{"blob_overlap_ratio":0.154,"blobs_seen_elsewhere":2,"blobs_total":13,"nearest_listing":"genesiscode2026/genesis-agent-skills-qa","derivative_of":null},"engineering":{"unique_5gram_ratio":0.621,"type_token_ratio":0.542,"effective_code_lines":271,"effective_doc_words":534,"code_files":5,"test_files":2,"padding_suspected":false},"cadence":{"releases":1,"median_days_between_releases":null,"on_time_fraction":null,"days_since_last":0,"score":null,"finished":false},"inventory_sentence":"1 script · 3 source files · 2 test files · 5 docs","extensions":{"js":5,"md":4,"json":2,"(none)":3},"lines_of_code":436,"warnings":["sbom_unavailable"],"repo_meta":{"repo_id":1374260991,"name":"genesis-openapi-mcp-builder","full_name":"genesiscode2026/genesis-openapi-mcp-builder","description":null,"homepage":null,"topics":[],"language":"JavaScript","default_branch":"main","size_kb":11,"created_at":"2026-09-17T10:21:40Z","pushed_at":"2026-09-17T10:21:45Z","licence_spdx":null,"open_issues":null,"stars":null,"forks":null,"watchers":null,"archived":false,"private":true,"html_url":null},"owner":{"login":"genesiscode2026","name":null,"avatar_url":"https://avatars.githubusercontent.com/u/329895054?v=4","bio":null,"blog":null,"company":null,"location":null,"twitter_username":null,"followers":null,"public_repos":6,"created_at":"2026-09-16T08:01:39Z","html_url":"https://github.com/genesiscode2026"},"computed_at":"2026-09-17T11:43:27.608Z","analyzer_version":"0.1.0"},"self_reported":{"description":"Generate ready-to-run MCP servers directly from OpenAPI specs","trigger_hint":"When requiring verified Developer Tools functionality in autonomous workflows"}}