Back to the catalog

io.github.WimSuenens/gs1belu-mpm-upload

Unofficial MCP tool surface for GS1 Belgium & Luxembourg's My Product Manager Upload API (v17).

Open source Open in the app JSON README (API)

About

Unofficial MCP tool surface for GS1 Belgium & Luxembourg's My Product Manager Upload API (v17).

Details

Kind
MCP servers
Topic
No topic detected
Publisher
wimsuenens
Origin
official
Category
ferramentas
Transport
local
Version
0.2.0
Last push
2026-07-28T05:49:54Z
Repository state
ativo
Language
C#
License
MIT
Added
2026-08-29 03:02:20
Updated
2026-08-29 03:02:20
Origin id
io.github.WimSuenens/gs1belu-mpm-upload

README

# 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/`](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/`](sdks/) → `dotnet/` |
| **TypeScript SDK** | TS/JS | npm — `@gs1belu/mpm-upload`, `@gs1belu/mpm-fetch` _(coming soon)_ | [`sdks/`](sdks/) → `typescript/` |
| **Upload MCP server** | Python | `uvx gs1belu-mpm-upload-mcp` / the MCP registry _(coming soon)_ | [`mcp/upload/`](mcp/upload/) |
| **Download MCP server** | Python | `uvx gs1belu-mpm-download-mcp` / the MCP registry _(coming soon)_ | [`mcp/download/`](mcp/download/) |

The two SDKs are generated with [Kiota](https://learn.microsoft.com/openapi/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](https://github.com/WimSuenens/gs1belu.myproductmanager/issues/82)):
a data-supplier installs only the Upload server, a data-recipient only the Download
one. [`mcp/combined/`](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`](CONTEXT.md); the decisions behind
the layout are in [`docs/adr/`](docs/adr/).

## Contributing

See [`CONTRIBUTING.md`](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.

More