gs1belu.myproductmanager

Generated C#/TypeScript SDKs and an MCP server for the GS1 Belgium & Luxembourg "My Product Manager" REST APIs (Upload + Download, v17), built from the vendor OpenAPI schemas under schemas/.

[!IMPORTANT] Unofficial. This project is a community effort and is not affiliated with, endorsed by, or supported by GS1 in any way. "GS1" and "My Product Manager" are the property of their respective owners. Use at your own risk.

Artifacts

Four artifacts are generated from the same source schemas. None are published yet — the links below are where each will land. Per-package READMEs carry the real quickstart for each.

Artifact	Language	Consume via	Source
C# SDK	.NET	NuGet — `dotnet add package …` (coming soon)	`sdks/` → `dotnet/`
TypeScript SDK	TS/JS	npm — `@gs1belu/mpm-upload`, `@gs1belu/mpm-fetch` (coming soon)	`sdks/` → `typescript/`
Upload MCP server	Python	`uvx gs1belu-mpm-upload-mcp` / the MCP registry (coming soon)	`mcp/upload/`
Download MCP server	Python	`uvx gs1belu-mpm-download-mcp` / the MCP registry (coming soon)	`mcp/download/`

The two SDKs are generated with Kiota (one client per API document, never merged). The two MCP servers build their tools at runtime with FastMCP — no code generation — and are independent, single-role processes (map #82): a data-supplier installs only the Upload server, a data-recipient only the Download one. mcp/combined/ is their deprecated, pre-split predecessor — see its README for the migration guide.

Monorepo map

schemas/     Vendor OpenAPI specs + overlays — the single source of truth
  upload/    · download/   (each: v17.yaml vendor original, v17.json, v17.overlay.yaml)
sdks/        The two Kiota SDKs (dotnet/, typescript/)
mcp/         The FastMCP MCP servers (Python): shared/, upload/, download/, and the
             deprecated combined/
scripts/     Schema-prep build + tests, driven by the justfile
docs/        ADRs, research, manuals, the schema-ingestion runbook
justfile     Task front door — `just gen` / `just build` / `just test`

The project's ubiquitous language (pristine vendor original, overlay, effective spec, dead patch) is defined in CONTEXT.md; the decisions behind the layout are in docs/adr/.

Contributing

See CONTRIBUTING.md for the toolchain prerequisites, the schema-editing rule, and the PR flow. The one rule that must never be broken: never hand-edit a vendor schema or generated code — correct it through the overlay and regenerate.

License

MIT.