genesis-openapi-mcp-builder

Generate ready-to-run MCP servers directly from OpenAPI specs

Download v1.0.0: $99
Future updates: $15 each

You're only charged when you choose to update.

Turn on JavaScript to pay from this page, or pay from the terminal — see Docs.

Buy with your agent

Buy genesiscode2026/genesis-openapi-mcp-builder from X402 Git for me. Listing: https://x402git.com/genesiscode2026/genesis-openapi-mcp-builder How to pay: https://x402git.com/.well-known/agent-skills/buy-a-repo/SKILL.md x402 endpoint: https://x402git.com/api/r/genesiscode2026/genesis-openapi-mcp-builder

What you get

A .zip of the repository at v1.0.0 (12.9 kB)

Size: 24.5 kB
Files: 14
Folders: 3
Dependencies: None
Licence: licence undetermined
Class: Harness
Updated: 2026-09-17

Security scan

Secrets: none found
Size limits: within caps
Malware: no dependency manifests to check
Vulnerabilities: no dependency manifests to check
Dependencies: nothing on a direct dependency · 1 in transitive packages
Injection: none found
Capabilities: listed below

2026-09-17: scanned · scanner 2026.09.1

Show report

Languages

JavaScript 100%

FoldersFiles

Top level of the repository
Size	Folder	Inside
9.1 kB	src/	3 source files
5.4 kB	tests/	2 test files
3.8 kB	bin/	1 script
6.3 kB	(root)	5 docs · 1 asset

14 files · 24.5 kB · computed 2026-09-17
Size	Path
103 B	.gitignore
587 B	CHANGELOG.md
961 B	LICENSE
618 B	QUICKSTART.md
3 kB	README.md
274 B	SECURITY.md
6 B	VERSION · binary
3.8 kB	bin/genesis-openapi-mcp.js
687 B	package.json
6 kB	src/generator.js
201 B	src/index.js
2.9 kB	src/parser.js
1.5 kB	tests/fixtures/petstore_openapi.json
3.9 kB	tests/test_builder.js

computed 2026-09-17 11:43 UTC · analyzer 0.1.0

Already bought this?

View your purchases

README

Genesis OpenAPI to MCP Production Builder

Deterministic compiler generating ready-to-deploy, typed Model Context Protocol (MCP) servers directly from OpenAPI 3.x specifications.

1. What Problem Does This Solve?

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.

genesis-openapi-mcp-builder compiles any valid OpenAPI 3.x specification into a standalone, production-ready Node.js MCP server in seconds.

2. Who Buys It?

Backend Engineers and API Platform Teams enabling AI agent access to internal microservices.
SaaS companies distributing official MCP connectors for their developer platforms.
Autonomous agent developers integrating external REST APIs into multi-tool agent sessions.

3. What Does It Output?

A complete, self-contained MCP server package ready to run via stdio or deploy as a microservice:

server.js: Zero-dependency JSON-RPC 2.0 MCP server with path parameter interpolation and query mapping.
package.json: Manifest configured with engines and startup scripts.
README.md: Auto-generated tool documentation and agent configuration runbook.

4. How Fast Can You Test It?

Under 5 seconds. Run:

./bin/genesis-openapi-mcp.js --spec ./tests/fixtures/petstore_openapi.json --out ./my-mcp

5. Why Is This Different From Generic Wrappers?

Generic wrappers rely on heavy runtime SDKs or dynamically evaluate untyped endpoints at runtime. genesis-openapi-mcp-builder is an ahead-of-time deterministic compiler that generates clean, zero-dependency Node 18+ JavaScript with strict JSON Schema parameter validation, native fetch dispatch, and clean error masking.

Installation & Usage

# Compile an OpenAPI specification into an MCP server
npx genesis-openapi-mcp --spec ./swagger.json --out ./mcp-server

# Override API Base URL and specify custom token environment variable
npx genesis-openapi-mcp \
  --spec ./api-spec.json \
  --out ./orders-mcp \
  --base-url "https://api.internal.company.com/v2" \
  --auth-env "INTERNAL_SERVICE_KEY"

# Output compilation metadata in JSON for CI/CD pipelines
npx genesis-openapi-mcp --spec ./api.json --out ./out-mcp --json

Generated MCP Server Capabilities

Protocol Conformance: Full compliance with the official MCP 2024-11-05 specification over standard I/O.
Typed Input Schemas: OpenAPI properties converted to strict JSON Schema for high-precision model tool calls.
Authentication: Native forwarding of Bearer tokens or API keys via configurable environment variables.
Zero Dependencies: Generated servers run directly on native Node 18+ without requiring external npm packages.

License

Commercial — Genesis Code (genesiscode2026). 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 Socket 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: nothing on a direct dependency · 1 in transitive packages; Socket
instruction smuggling: none found; X402 Git
what it can do: listed below; X402 Git

What this can do

Tools: none
Runs: bin/genesis-openapi-mcp.js
Talks to: api.example.com
localhost:8080 (local)
mock.example.com
Reads: API_BASE_URL
At install: nothing runs
Links to: api.internal.company.com
api.mycompany.com

Findings (5)

LOWsrc/generator.js — Reads the environment variable API_BASE_URL
LOWtests/fixtures/petstore_openapi.json — Talks to api.example.com
LOWtests/test_builder.js — Talks to mock.example.com
LOWSocket SBOM Resolver — Socket SBOM Resolver (transitive) — no lockfile, so installs are not reproducible
LOWbin/genesis-openapi-mcp.js — Ships the script bin/genesis-openapi-mcp.js

Releases 1

v1.0.02026-09-17
Production-ready release. Converts OpenAPI specifications into fully functional MCP server implementations.