{"openapi":"3.1.0","info":{"title":"pampling-wiki-mcp","description":"MCP server read-only para la wiki interna de Pampling (Wiki.js).","version":"1.0.0"},"paths":{"/api/pages":{"get":{"tags":["wiki"],"summary":"List all pages","description":"Catálogo completo de páginas. Filtro opcional por tag (case-insensitive).","operationId":"list_pages_api_pages_get","parameters":[{"name":"tag","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Tag exacto, sin distinguir mayúsculas","title":"Tag"},"description":"Tag exacto, sin distinguir mayúsculas"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageList"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/search":{"get":{"tags":["wiki"],"summary":"Full-text search","description":"Búsqueda full-text usando el motor de Wiki.js.","operationId":"search_api_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"description":"Query de búsqueda","title":"Q"},"description":"Query de búsqueda"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"description":"Máximo de resultados (1-50)","default":10,"title":"Limit"},"description":"Máximo de resultados (1-50)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResults"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/navigation":{"get":{"tags":["wiki"],"summary":"Sidebar tree","description":"Estructura jerárquica del sidebar de la wiki.","operationId":"navigation_api_navigation_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Navigation"}}}}}}},"/api/tags":{"get":{"tags":["wiki"],"summary":"Tags with page counts","description":"Lista de tags con conteo de páginas, ordenado por uso desc.","operationId":"tags_api_tags_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagList"}}}}}}},"/api/pages/{path}":{"get":{"tags":["wiki"],"summary":"Read page by path","description":"Lee una página por su path. Acepta `home`, `infraestructura/servidor`, `en/home`, etc. Devuelve markdown crudo + metadatos.","operationId":"read_page_api_pages__path__get","parameters":[{"name":"path","in":"path","required":true,"schema":{"type":"string","description":"Path de la página, sin barra inicial","title":"Path"},"description":"Path de la página, sin barra inicial"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}},"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Navigation":{"properties":{"sections":{"items":{"$ref":"#/components/schemas/NavigationItem"},"type":"array","title":"Sections"}},"type":"object","required":["sections"],"title":"Navigation"},"NavigationItem":{"properties":{"label":{"type":"string","title":"Label"},"type":{"type":"string","enum":["header","link","divider"],"title":"Type","default":"link"},"target":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target"},"children":{"items":{"$ref":"#/components/schemas/NavigationItem"},"type":"array","title":"Children"}},"type":"object","required":["label"],"title":"NavigationItem"},"Page":{"properties":{"id":{"type":"integer","title":"Id"},"path":{"type":"string","title":"Path"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"content":{"type":"string","title":"Content"},"contentType":{"type":"string","title":"Contenttype","default":"markdown"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatedat"},"url":{"type":"string","title":"Url"}},"type":"object","required":["id","path","title","content","url"],"title":"Page"},"PageList":{"properties":{"pages":{"items":{"$ref":"#/components/schemas/PageSummary"},"type":"array","title":"Pages"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["pages","total"],"title":"PageList"},"PageSummary":{"properties":{"id":{"type":"integer","title":"Id"},"path":{"type":"string","title":"Path"},"locale":{"type":"string","title":"Locale"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"updatedAt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Updatedat"}},"type":"object","required":["id","path","locale","title"],"title":"PageSummary"},"SearchResult":{"properties":{"id":{"type":"integer","title":"Id"},"path":{"type":"string","title":"Path"},"title":{"type":"string","title":"Title"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"snippet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snippet"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"}},"type":"object","required":["id","path","title"],"title":"SearchResult"},"SearchResults":{"properties":{"query":{"type":"string","title":"Query"},"results":{"items":{"$ref":"#/components/schemas/SearchResult"},"type":"array","title":"Results"},"total":{"type":"integer","title":"Total"}},"type":"object","required":["query","results","total"],"title":"SearchResults"},"TagInfo":{"properties":{"tag":{"type":"string","title":"Tag"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["tag","count"],"title":"TagInfo"},"TagList":{"properties":{"tags":{"items":{"$ref":"#/components/schemas/TagInfo"},"type":"array","title":"Tags"}},"type":"object","required":["tags"],"title":"TagList"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}