{"openapi":"3.1.0","info":{"title":"STMK Public Knowledge API","version":"1.1.0","description":"Anonymous read-only HTTP access to the same published catalogue as https://stmk.pro/mcp. No model calls, write operations or access to private systems. Cite canonical source URLs."},"servers":[{"url":"https://stmk.pro"}],"security":[],"paths":{"/mcp/api/search":{"get":{"operationId":"search","description":"Search published STMK projects, services and engineering articles in Russian or English. Fetch a returned id for source text; cite canonical URLs.","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":500}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","text"],"default":"json"}}],"responses":{"200":{"description":"Published STMK data with canonical source citations.","content":{"application/json":{"schema":{"type":"object"}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid arguments."},"404":{"description":"Published document not found."},"429":{"description":"Aggregate request budget exceeded; respect Retry-After."},"503":{"description":"Catalogue temporarily unavailable."}}}},"/mcp/api/fetch":{"get":{"operationId":"fetch","description":"Read an STMK document returned by search or catalog, including canonical URL, source text, dates and project facts. Arbitrary URLs and files are not supported.","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":250}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","text"],"default":"json"}}],"responses":{"200":{"description":"Published STMK data with canonical source citations.","content":{"application/json":{"schema":{"type":"object"}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid arguments."},"404":{"description":"Published document not found."},"429":{"description":"Aggregate request budget exceeded; respect Retry-After."},"503":{"description":"Catalogue temporarily unavailable."}}}},"/mcp/api/find_projects":{"get":{"operationId":"find_projects","description":"Select published STMK projects by area in square metres, published status, category and language. Approximate areas remain marked; date ranges do not imply completion.","parameters":[{"name":"min_area_m2","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":1000000}},{"name":"max_area_m2","in":"query","required":false,"schema":{"type":"number","minimum":0,"maximum":1000000}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["any","delivered","in_progress"],"default":"any"}},{"name":"language","in":"query","required":false,"schema":{"type":"string","enum":["ru","en"],"default":"ru"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":20,"default":12}},{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["any","private_residential","commercial"],"default":"any"}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","text"],"default":"json"}}],"responses":{"200":{"description":"Published STMK data with canonical source citations.","content":{"application/json":{"schema":{"type":"object"}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid arguments."},"404":{"description":"Published document not found."},"429":{"description":"Aggregate request budget exceeded; respect Retry-After."},"503":{"description":"Catalogue temporarily unavailable."}}}},"/mcp/api/get_company":{"get":{"operationId":"get_company","description":"Get published STMK company information, services, business contacts and office hours. These are first-party publications, not an independent endorsement.","parameters":[{"name":"language","in":"query","required":false,"schema":{"type":"string","enum":["ru","en"],"default":"ru"}},{"name":"format","in":"query","schema":{"type":"string","enum":["json","text"],"default":"json"}}],"responses":{"200":{"description":"Published STMK data with canonical source citations.","content":{"application/json":{"schema":{"type":"object"}},"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Invalid arguments."},"404":{"description":"Published document not found."},"429":{"description":"Aggregate request budget exceeded; respect Retry-After."},"503":{"description":"Catalogue temporarily unavailable."}}}}}}