{"openapi":"3.1.0","info":{"title":"Moyne Ross Read API","version":"1.1.0","description":"Read-only HTTP access to the same public Moyne Ross corpus served by the Moyne Ross MCP server: the Capital Made Physical papers, the Technical Library, the methodology and the sample Capital Strategy. Every result carries the canonical moyneross.com URL to cite.","contact":{"name":"Moyne Ross","url":"https://moyneross.com/assistants"},"license":{"name":"MIT (server code); content subject to Moyne Ross terms","url":"https://moyneross.com/terms"}},"servers":[{"url":"https://mcp.moyneross.com"}],"paths":{"/v1/search":{"get":{"operationId":"searchResearch","summary":"Search Moyne Ross research","description":"Search the public Moyne Ross corpus on commercial property and capital: 49 Capital Made Physical papers, the Technical Library (103 pages on building elements and functional spaces: how each fails, what to look for, how serious a finding is, remedies), the Capital Register and MR Index methodology, and a sample Capital Strategy. Use for capital planning, lifecycle and condition, obsolescence, refurbish or redevelop, energy and solar, leases and make good, due diligence, the Australian, British and US markets, and for how a building element or system fails and is judged. For a question about one element or system (a roof, a façade, a chiller, lifts, fire services), scope technical searches the library alone. Returns ranked results with canonical URLs and a match strength with the matched and missing words; when the match is weak, the results are background only. General research: it does not assess a particular building.","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":500}},{"name":"scope","in":"query","required":false,"schema":{"type":"string","enum":["all","research","technical","methodology","sample"],"default":"all"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":5}},{"name":"response_format","in":"query","required":false,"schema":{"type":"string","enum":["concise","detailed"],"default":"concise"}}],"responses":{"200":{"description":"Ranked results with match strength","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter"}}}},"/v1/papers":{"get":{"operationId":"listPapers","summary":"List Moyne Ross papers","description":"List the Capital Made Physical papers in reading order, a page at a time, optionally for one of the seven parts (I to VII). Returns each paper's number, title, part, question, short answer, dates and canonical URL, and nextCursor for the next page.","parameters":[{"name":"part","in":"query","required":false,"schema":{"type":"string","enum":["I","II","III","IV","V","VI","VII"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25,"default":15}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":20}}],"responses":{"200":{"description":"Papers in reading order","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter"}}}},"/v1/paper":{"get":{"operationId":"getPaper","summary":"Get a Moyne Ross paper","description":"Retrieve one Capital Made Physical paper by slug, CMP number or canonical URL. By default a summary: the question it answers, its short answer, summary, limitations and its sections with anchored URLs. format full adds the complete text; section returns one section. Always includes a ready citation. Carry the limitations through when relying on it.","parameters":[{"name":"paper","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["summary","full"],"default":"summary"}},{"name":"section","in":"query","required":false,"schema":{"type":"string","maxLength":120}}],"responses":{"200":{"description":"One paper","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter"},"404":{"description":"No paper matches"}}}},"/v1/method":{"get":{"operationId":"explainMethod","summary":"Explain a Moyne Ross method","description":"Explain the Capital Register (the line-by-line capital document behind every Capital Strategy) or the MR Index (the MR 1 to MR 5 reading of how much attention a building needs, and how soon), from the public methodology pages. By default the definition and the list of sections; format full gives the whole page, section gives one part.","parameters":[{"name":"method","in":"query","required":true,"schema":{"type":"string","enum":["capital-register","mr-index"]}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["summary","full"],"default":"summary"}},{"name":"section","in":"query","required":false,"schema":{"type":"string","maxLength":120}}],"responses":{"200":{"description":"The method","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter"}}}},"/v1/sample":{"get":{"operationId":"getSampleStrategy","summary":"Get the sample Capital Strategy","description":"Read the sample Moyne Ross Capital Strategy, a real strategy for an industrial warehouse and office with identifying details changed, to see what such a strategy contains. part summary (default): the ten-year figures, MR Index, executive summary and where the capital sits. part register: an overview of the Capital Register by section, or, with section (e.g. roofs), that section's lines with condition, action, timing, cost and cost basis.","parameters":[{"name":"part","in":"query","required":false,"schema":{"type":"string","enum":["summary","register"],"default":"summary"}},{"name":"section","in":"query","required":false,"schema":{"type":"string","maxLength":80}}],"responses":{"200":{"description":"The sample Capital Strategy","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter"}}}},"/v1/cite":{"get":{"operationId":"citePaper","summary":"Cite Moyne Ross research","description":"Return an exact citation for a Capital Made Physical paper or a Technical Library page, optionally to one section, in BibTeX, RIS, CSL-JSON, APA or Harvard. Use the formatted text as given rather than retyping it.","parameters":[{"name":"paper","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"style","in":"query","required":false,"schema":{"type":"string","enum":["bibtex","ris","csl-json","apa","harvard"],"default":"apa"}},{"name":"section","in":"query","required":false,"schema":{"type":"string","maxLength":120}}],"responses":{"200":{"description":"An exact citation","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter"},"404":{"description":"No paper or section matches"}}}},"/v1/technical":{"get":{"operationId":"technicalLibrary","summary":"List Technical Library pages, or get a technical library page","description":"Without page: List the Moyne Ross Technical Library: one page for each building element and functional space a Capital Strategy assesses, in the order of the Building Check Framework (Substructure to Environmental), a page at a time, optionally for one section or page type. Returns each page's title, section, short answer and canonical URL, the framework sections, the severity scale every page grades findings on, and nextCursor for the next page. With page: Retrieve one Technical Library page by slug, element name or canonical URL: general technical guidance on how a building element or functional space is built, its service life, how it fails, what to look for, how to tell causes apart, how serious a finding is (graded safety, failure, condition, lifecycle, deadline, check or nil), investigation, remedies, the shape of the cost (never a price), standards in Australia, the UK and the US, and what to ask the owner or agent for. By default a summary with every section's anchored URL; section returns one section, format full the whole page. Always includes a ready citation. It describes how elements behave in general, never the condition of a particular building; carry its limitations through.","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":200}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["summary","full"],"default":"summary"}},{"name":"section","in":"query","required":false,"schema":{"type":"string","maxLength":120,"description":"With page: one section by id or heading. Without page: one framework section to list."}},{"name":"page_type","in":"query","required":false,"schema":{"type":"string","enum":["element","space"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":15}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string","maxLength":20}}],"responses":{"200":{"description":"One Technical Library page, or the library a page at a time","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter"},"404":{"description":"No page or section matches"}}}},"/v1/engage":{"get":{"operationId":"workingWithMoyneRoss","summary":"How working with Moyne Ross works","description":"Factual information on how Moyne Ross engagements work: who it works with and where (commercial and multi-unit property in Australia, the United Kingdom and the United States), the three stages, the published terms on which a Capital Strategy is released, and common questions. Use when the person asks about engaging Moyne Ross.","parameters":[],"responses":{"200":{"description":"How engagements work","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid parameter"}}}}}}