The MCP server

Five tools that give a coding agent every design: list, get, read, find, and where the designs come from.

An MCP server that gives coding agents the Vertical-Driven Architectures: complete reference architectures for physical AI in ports, grids, mills, plants and construction sites. Each design says what to sense, where each model runs, what the object model holds, which open-weight models and hardware it needs, what it costs over three years, and who approves every action.

Every design was reasoned on Praxis and ships an object model in the hyper-ontology/1 format for Hyper Ontology. Papers, object models and data are CC BY 4.0; cite the design's DOI.

Tools

Tool	What it returns
`list_designs(sector, country)`	Every design, filterable, with DOI and object counts
`get_design(design_id)`	Summary, object model, model and hardware register with reasons, cost lines, write paths, human approval loop
`read_paper(design_id, page)`	The full paper as text, paged
`find(text)`	Where a model, system, regulation or object appears across all designs
`about_praxis_and_hyper_ontology()`	Where the designs come from, and how to request access

The server reads the published dataset at call time, so it always serves the latest designs. Set CODENINJA_RESEARCH_DATA to a local dataset/ folder to run offline.

Install

With uv:

{
  "mcpServers": {
    "codeninja-research": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/muhammadumar89/codeninja-research#subdirectory=mcp-server", "codeninja-research-mcp"]
    }
  }
}

Claude Code:

claude mcp add codeninja-research -- uvx --from "git+https://github.com/muhammadumar89/codeninja-research#subdirectory=mcp-server" codeninja-research-mcp

With pip: pip install "git+https://github.com/muhammadumar89/codeninja-research#subdirectory=mcp-server";, then use codeninja-research-mcp as the command.

Ask it

"Which designs run vision at the edge, and on what hardware?"
"Show me the object model for the container terminal design and turn it into Postgres tables."
"What does it cost to own versus rent the GPUs for the wildfire design?"

Licence: code Apache-2.0; data CC BY 4.0. By CodeNinja.

Source: mcp-server/README.md in the repository. This page is generated from it and updates with it.