OODS Foundry

com.oods-foundryPublished by oods-foundry.comOfficial publisherv0.14.0Updated Nov 14, 2026

OODS Foundry is an object-oriented design system that extends the one you already have.

VerifiedStreamable HTTPWeb executableDeveloper ToolsData & AnalyticsMedia & Design

Overview

AI-generated overview

Read-only design-system server that lets an assistant inspect objects, components and tokens, generate React or Vue screens, and render and certify charts.

What you can do
  • Inspect service status, version, registry counts, brands, themes and token scopes
  • Browse the component catalog and object registry, and read registry snapshots and single object definitions
  • Fetch token and manifest datasets, paged by JSON Pointer
  • Render charts from inline data and certify them for accuracy, accessibility, contrast and determinism
  • Look up recorded design previews by object, context and framework, and read shipped tool schemas
When to use it
Useful when a product has recurring objects and workflows, screens must share rules across frameworks and themes, or generated UI should follow an existing design system. Also handy for checking chart accessibility and contrast before shipping.
Requirements
Either the hosted streamable HTTP endpoint or a local install via the npm package, which needs Node.js 22.0.0 or newer on macOS or Linux; a Docker stdio image is also described. No authentication, environment variables or headers are declared.
Before you install
The hosted endpoint exposes a narrower tool surface and release schedule than the local install. Chart certification covers only the rendered chart specification, not a whole application. Reproduction details are returned only when explicitly requested.

Installation

In SourceWeft

  1. Open OODS Foundry in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.oods-foundry%2Ffoundry/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "oods-foundry": {
      "type": "http",
      "url": "https://oods-foundry.com/mcp"
    }
  }
}

README

OODS Foundry

OODS Foundry is an object-oriented design system that extends the one you already have. Your AI assistant drives it over MCP. Describe a screen by its object and context, such as a subscription detail view. OODS Foundry composes governed components and design tokens, generates React or Vue code, and renders charts from your data.

Use it when your product has recurring objects and workflows, your screens need to share rules across frameworks and themes, or you want generated UI to follow an existing design system. You can define your own objects, traits, brand and component mappings.

Generated code comes with a receipt naming the static checks performed and the work still needed. Chart certification measures the rendered specification's accuracy, accessibility equivalence, contrast and determinism. It does not certify an entire application.

The optional a11y_scan tool checks the text and icon contrast pairs declared by the component stylesheet in every built brand and theme. Given a screen schema, it also renders the screen and checks its document accessibility rules; see the tool reference for scope and thresholds.

Try the five-minute demo

Turn Cal.com’s real schema into React and Vue screens in your own shadcn components. Follow the prompts, review what is proposed, accept it, and open list, detail, form and timeline in light or dark.

Install

Use Node.js 22.0.0 or newer on macOS or Linux. For a local server in Claude Code:

sh
claude mcp add oods-foundry -- npx -y @oods/foundryclaude mcp get oods-foundry

For the Claude Code plugin, which includes the server and its guided skill:

sh
claude plugin marketplace add https://github.com/kneelinghorse/oods-foundry-claude-plugin.gitclaude plugin install oods-foundry@oods-foundry

Restart Claude Code and invoke /oods-foundry:oods-foundry. Ask your assistant to call health_check, then compose a Subscription in detail context. The package guide includes Claude Desktop and Cursor configuration and explains local files and network access. The walkthrough takes you from an object definition to a generated application.

For a hosted connection, use the streamable HTTP endpoint https://oods-foundry.com/mcp in a compatible MCP client. The website describes its available tools. Local installation provides the full authoring workflow; the hosted service has its own tool surface and release schedule.

Docker stdio server

Build the supplied Dockerfile, then keep stdin open for your MCP client:

sh
docker build -t oods-foundry .docker run --rm -i -v oods-data:/data oods-foundry

The image runs as the unprivileged node user. The volume preserves registered objects and import drafts. Mount schema files separately, for example -v "$PWD/schemas:/schemas:ro", and give object_import their container paths. The running-app preview binds to loopback inside the container; use the local npm installation for browser previews on the host.

Source and releases

This repository mirrors each release, one commit per version. The source includes the design system, React and Vue libraries, MCP server, bridge, adapter and packaging scripts. The tool reference describes the calls and their contracts.

To install the workspace from this snapshot:

sh
corepack pnpm install --frozen-lockfile

Building and testing from source describes the package builds, runtime assembly and public test command.

Bug reports and feedback are welcome in Issues. This release mirror does not accept pull requests; they will be closed. See CONTRIBUTING and SECURITY.

License

OODS Foundry is licensed under Apache-2.0; see NOTICE for the copyright holder, third-party notices and the license FAQ.

Commits before the release snapshot carried an MIT declaration in package.json and no LICENSE file.

Source: README.md at commit 804b9e6

Tools

9

health_check

Check Health

Read the running service status, pinned version, registry counts, built brands, themes, token scopes and retained proof summaries. Uptime and latency are current process measurements; host paths are omitted. includeChangelog adds the DSL changelog, and sinceVersion keeps entries after that version. catalog_list and object_registry read the definitions behind the counts.

ParametersreproducesinceVersionincludeChangelog

catalog_list

List Components

Read components a page at a time. category, trait, context and status filter the list; status describes the HTML renderer. detail is brief by default, or full when filtering; summary includes tags, contexts, regions and traits. Brief and summary allow up to 200 entries; full clamps pageSize to 10 and reports the adjustment. totalCount, hasMore and nextPage describe pagination. object_registry reads objects instead.

ParameterspagetraitdetailstatuscontextcategorypageSizereproduceincludeInternal

object_registry

Read Object Registry

Read objects from the pinned registry. action list returns names, traits and field counts; domain, trait and maturity filter them, and includeInternal adds internal objects. action show requires name and returns its composed definition; context narrows view extensions. registry_snapshot provides an overview; design_preview looks up recorded screens.

ParametersnametraitactionrequireddomaincontextmaturityreproduceincludeInternal

registry_snapshot

Snapshot Registry

Read the registry summary: active objects and traits, loaded names, loader issues, etag and generatedAt. detail full includes definitions; names narrows them. includeInternal adds internal objects. Replies larger than 100,000 characters are refused with their size. object_registry reads one composed object; catalog_list reads components.

ParametersnamesdetailreproduceincludeInternal

structured_data_fetch

Fetch Structured Data

Read the tokens or manifest dataset. Full data is the default; detail summary returns section counts and the first page call. page reads lossless JSON Pointer entries; pageSize defaults to 10, at most 100, also bounded by size. meta.next continues and meta.full requests full data. includePayload false returns metadata; listVersions lists dates, version selects one, and ifNoneMatch returns matched true without unchanged payload. catalog_list reads components.

ParameterspagedetaildatasetrequiredversionpageSizereproduceifNoneMatchlistVersionsincludePayload

viz_render

Render Chart

Draw and certify a chart from inline data. Provide chartType and encodings with rows, a pattern with its own data, or an intent to recommend a tabular chart. Brand and theme apply to drawing and certification. The compact reply contains hashes, warnings and certification; output.svg adds the SVG drawing, includeA11y adds the table and narrative, and includeNormalizedSpec adds its specification. Request SVG when a displayed chart is needed. Up to 500 rows; optional outputs still share the 100,000-character reply bound. artifact_certify returns the same drawing and checks for an input in chart.

Parametersidgeonamerowsbrandchordthemeintentoutputsankeynetworkopacity+8 more

artifact_certify

Certify Chart

Draw and certify a chart from the input in chart, using matching data, brand and theme. Returns the same result as viz_render: hashes, warnings and the certification verdict, including accessibility equivalence, determinism, contrast and accuracy. Optional chart.output fields add SVG, the accessible table and narrative, or the normalized specification. A verdict can be conformant false; each pillar explains its result.

Parameterschartrequiredreproduce

design_preview

Look Up Recorded Screen

Look up a recorded screen by object, context and framework. Returns its running screen URL, content hash, brand and theme. No new screen is generated. object_registry reads the definition behind the screen. Set reproduce true when the command and calls used to generate it are requested.

Parametersobjectrequiredcontextframeworkreproduce

tool_schema

Read Tool Schema

Read a shipped tool schema by name and kind (input or output). Returns its JSON Schema, package-relative file, recorded file hash and source URL. tools/list describes this endpoint’s narrower accepted inputs; the full schema may describe operations outside the hosted tools.

Parameterskindnamerequiredreproduce

Version history

27
  1. v0.14.0LatestNov 14, 2026
  2. v0.13.1Nov 12, 2026
  3. v0.13.0Nov 11, 2026
  4. v0.12.0Nov 8, 2026
  5. v0.11.3Nov 3, 2026
  6. v0.11.2Oct 11, 2026
  7. v0.11.1Oct 10, 2026
  8. v0.11.0Oct 9, 2026
  9. v0.10.2Oct 9, 2026
  10. v0.10.1Oct 8, 2026
  11. v0.10.0Oct 8, 2026
  12. v0.9.0Oct 7, 2026
  13. v0.8.0Oct 7, 2026
  14. v0.7.0Oct 6, 2026
  15. v0.6.2Oct 5, 2026
  16. v0.6.1Oct 4, 2026
  17. v0.6.0Oct 4, 2026
  18. v0.5.0Oct 3, 2026
  19. v0.4.6Oct 3, 2026
  20. v0.4.4Oct 2, 2026
  21. v0.4.3Oct 2, 2026
  22. v0.4.2Oct 1, 2026
  23. v0.4.1Oct 1, 2026
  24. v0.4.0Oct 1, 2026
  25. v0.3.3Sep 30, 2026
  26. v0.3.2Sep 29, 2026
  27. v0.3.1Sep 27, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Oods-Foundry integrations