Orium · Fluent Commerce · 2025
An MCP server that lets Claude work with Fluent Commerce — a powerful but notoriously complex order-management platform — by reading its live GraphQL schema, generating and validating queries, then running them.
- Client
- Orium · Fluent Commerce
- Role
- Creator of the MCP server · OMS developer
- Year
- 2025
Outcomes
Context
Fluent Commerce is the order-management platform I've worked with most — and the hardest: orchestration lives in workflows and Java rules, and its GraphQL API is enormous, so even simple questions take a specialist. After an OMS engagement for Article, I built an MCP server so an agent could work with Fluent the way a senior developer does: instead of guessing queries, it reads the live schema, writes the exact query, validates it and only then runs it.
What I built
- 01
A Fluent GraphQL MCP server (TypeScript, MCP SDK, Zod) with five tools: execute, validate, list root fields, maximal selection and structured query generation.
- 02
Live schema introspection and SDL exposed as MCP resources, cached to keep the agent's context small.
- 03
Guided prompts with a Fluent domain assistant, built from external templates: describe what you need in plain language (“available stock for a product at a location”) and get a validated query, or explore the schema step by step.
- 04
Contributions to Orium's agentic Fluent CLI: MCP server fixes, prompt rework and agent test cases for rules and GraphQL queries, alongside a rule-embedding pipeline (rule JARs → embeddings → vector store).
- 05
The client OMS work that motivated it: Fluent's order, inventory and fulfilment modules, OMX UI components and API test suites.