{"schema":"oleba-mcp-get-compat-v1","server":{"name":"Oleba MCP Server","version":"0.4.2","mcp_protocol_version":"2026-07-28","mcp_endpoint":"https://oleba.pl/mcp","mcp_transport":"POST JSON-RPC 2.0"},"interface":"http-get-read-only-compatibility","not_mcp_transport":true,"purpose":"Graceful-degradation facade for crawlers/AI agents that can follow ordinary GET URLs but cannot send MCP POST JSON-RPC requests.","discovery":{"manifest":"https://oleba.pl/ai/discovery.json","llms_txt":"https://oleba.pl/llms.txt","content_index":"https://oleba.pl/ai/content.json"},"get_usage":{"descriptor":"https://oleba.pl/mcp","server_discover":"https://oleba.pl/mcp?method=server/discover","tools_list":"https://oleba.pl/mcp?method=tools/list","resources_list":"https://oleba.pl/mcp?method=resources/list","tool_pattern":"https://oleba.pl/mcp?tool={tool_name}&arg=value","resource_pattern":"https://oleba.pl/mcp?resource={urlencoded_oleba_resource_uri}","examples":["https://oleba.pl/mcp?tool=ask_oleba&service=remont_lazienki&location=Piaseczno&area_m2=6&mode=compact","https://oleba.pl/mcp?tool=check_service_area&service=remont_lazienki&location=Piaseczno","https://oleba.pl/mcp?tool=list_services","https://oleba.pl/mcp?tool=get_prices&query=remont łazienki&limit=10","https://oleba.pl/mcp?tool=get_realizations&location=Piaseczno&service=remont_lazienki&limit=5","https://oleba.pl/mcp?tool=get_realization&identifier=16791","https://oleba.pl/mcp?resource=oleba://site/services"]},"tools":[{"name":"get_site_overview","title":"Oleba site overview","description":"Return public site identity, machine-readable endpoints and MCP endpoint information for ABC Remonty Oleba.","inputSchema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"search_site","title":"Search oleba.pl public content","description":"Search published public WordPress pages/posts on oleba.pl using locality-aware service relevance. Returns canonical URLs, titles, excerpts, match diagnostics and machine-readable representation URLs.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":2,"maxLength":160,"description":"Search phrase in Polish or another language."},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5},"content_type":{"type":"string","enum":["any","page","post"],"default":"any"}},"required":["query"],"additionalProperties":false}},{"name":"get_content","title":"Read a specific public Oleba page","description":"Resolve a public WordPress item by numeric ID, slug or same-site URL and return Markdown/text/metadata. Password-protected, unpublished and noindex content is refused.","inputSchema":{"type":"object","properties":{"identifier":{"type":["string","integer"],"description":"Post/page ID, slug, or canonical URL on oleba.pl."},"format":{"type":"string","enum":["markdown","text","metadata"],"default":"markdown"}},"required":["identifier"],"additionalProperties":false}},{"name":"list_services","title":"List structured Oleba services","description":"Return the curated public Oleba service catalog as stable machine-readable service objects linked to canonical public content.","inputSchema":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":20,"default":20}},"additionalProperties":false}},{"name":"get_service","title":"Get one structured Oleba service","description":"Resolve a service by stable service id or natural-language name and return its primary public page, structured price rows and related realizations.","inputSchema":{"type":"object","properties":{"identifier":{"type":"string","minLength":2,"maxLength":120,"description":"Stable service id such as remont_lazienki or a service phrase such as remont łazienki."},"location":{"type":"string","maxLength":100,"description":"Optional locality used to narrow related realizations."},"realization_limit":{"type":"integer","minimum":0,"maximum":10,"default":4},"price_limit":{"type":"integer","minimum":0,"maximum":20,"default":8}},"required":["identifier"],"additionalProperties":false}},{"name":"ask_oleba","title":"Resolve a renovation question from Oleba public data","description":"Compose a compact, source-linked answer bundle from the structured Oleba service catalog, public cennik, service-area evidence and realization portfolio. Deterministic and read-only: missing facts are reported, never guessed.","inputSchema":{"type":"object","properties":{"query":{"type":"string","maxLength":240,"description":"Optional natural-language renovation question. Used only for deterministic service/locality/filter extraction; no server-side LLM is used."},"service":{"type":"string","maxLength":120,"description":"Optional stable service id or service phrase."},"location":{"type":"string","maxLength":100},"area_m2":{"type":"number","minimum":0,"maximum":10000,"description":"Optional exact project area filter."},"min_area_m2":{"type":"number","minimum":0,"maximum":10000},"max_area_m2":{"type":"number","minimum":0,"maximum":10000},"year":{"type":"integer","minimum":2000,"maximum":2100},"object_type":{"type":"string","maxLength":100,"description":"Optional structured object-type filter; unknown project values are not guessed."},"initial_state":{"type":"string","maxLength":120,"description":"Optional initial condition, supported by quoted project evidence."},"scope":{"type":"string","maxLength":120,"description":"Optional scope/feature phrase matched against structured scope, quoted completed work or public tags."},"tag":{"type":"string","maxLength":120,"description":"Optional explicit public WordPress tag filter."},"mode":{"type":"string","enum":["compact","full"],"default":"compact"},"realization_limit":{"type":"integer","minimum":0,"maximum":5,"default":3},"price_limit":{"type":"integer","minimum":0,"maximum":10},"fallback_mode":{"type":"string","enum":["broad","strict_project","location_relaxed"],"default":"broad","description":"strict_project: no alternatives; location_relaxed: relax only locality; broad: labelled legacy alternatives."},"allow_fallback":{"type":"boolean","default":true}},"additionalProperties":false}},{"name":"check_service_area","title":"Check public evidence for an Oleba service area","description":"Distinguish a documented service/location offer from merely having (or not having) a published realization. Never interprets absence of public evidence as proof that Oleba refuses a locality.","inputSchema":{"type":"object","properties":{"service":{"type":"string","minLength":2,"maxLength":120},"location":{"type":"string","minLength":2,"maxLength":100},"realization_limit":{"type":"integer","minimum":0,"maximum":5,"default":3}},"required":["service","location"],"additionalProperties":false}},{"name":"get_prices","title":"Read structured Oleba price rows","description":"Parse the public renovation cennik into structured rows. Query is optional. Returned prices are public informational ranges/amounts, not binding offers.","inputSchema":{"type":"object","properties":{"query":{"type":"string","maxLength":120,"description":"Optional service or price phrase, e.g. remont łazienki, malowanie, elektryka."},"limit":{"type":"integer","minimum":1,"maximum":300,"default":20}},"additionalProperties":false}},{"name":"get_realization","title":"Read one structured Oleba realization","description":"Resolve one public realization/gallery post and return structured project metadata, evidence, media links and optional machine-readable content.","inputSchema":{"type":"object","properties":{"identifier":{"type":["string","integer"],"description":"Realization post ID, slug or same-site canonical URL."},"include_content":{"type":"boolean","default":false}},"required":["identifier"],"additionalProperties":false}},{"name":"get_price_information","title":"Find public Oleba pricing information","description":"Find context for a service or phrase on the public Oleba renovation price-list page. Returns informational excerpts, not a binding quote.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":2,"maxLength":120,"description":"Service or pricing phrase, e.g. remont łazienki, malowanie, gładź, elektryka."}},"required":["query"],"additionalProperties":false}},{"name":"get_location_pages","title":"Find Oleba local pages","description":"Find public Oleba pages/posts relevant to a locality such as Piaseczno, Ursynów, Mokotów, Józefosław or Konstancin-Jeziorna.","inputSchema":{"type":"object","properties":{"location":{"type":"string","minLength":2,"maxLength":100},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5}},"required":["location"],"additionalProperties":false}},{"name":"get_realizations","title":"Find Oleba renovation realizations","description":"Search public Oleba project/gallery realization content by locality and/or topic. Generic service, local landing and price-list pages are intentionally demoted or excluded. This searches published site content only and does not access private customer records.","inputSchema":{"type":"object","properties":{"location":{"type":"string","maxLength":100},"query":{"type":"string","maxLength":120},"service":{"type":"string","maxLength":120,"description":"Optional service id or phrase, e.g. remont_lazienki, glazura, antresole_stropy."},"min_area_m2":{"type":"number","minimum":0,"maximum":10000},"max_area_m2":{"type":"number","minimum":0,"maximum":10000},"year":{"type":"integer","minimum":2000,"maximum":2100},"object_type":{"type":"string","maxLength":100,"description":"Strict structured object-type filter; projects with unknown object type are omitted."},"initial_state":{"type":"string","maxLength":120,"description":"Optional initial condition, supported by quoted project evidence."},"scope":{"type":"string","maxLength":120,"description":"Scope/feature phrase matched against structured scope, quoted completed work or public tags."},"tag":{"type":"string","maxLength":120,"description":"Explicit public WordPress tag filter."},"mode":{"type":"string","enum":["compact","full"],"default":"full","description":"Legacy get_realizations keeps full as default for backwards compatibility; use compact to reduce payload."},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5}},"additionalProperties":false}}],"resources":[{"uri":"oleba://site/info","name":"site-info","title":"ABC Remonty Oleba — public site information","description":"Site identity and machine-readable endpoint information.","mimeType":"application/json"},{"uri":"oleba://site/content-index","name":"content-index","title":"Oleba public content index","description":"Read-only index of public eligible WordPress pages and posts with canonical and machine-readable URLs.","mimeType":"application/json"},{"uri":"oleba://site/llms","name":"llms-txt","title":"Oleba llms.txt","description":"Public llms.txt map if present.","mimeType":"text/plain"},{"uri":"oleba://site/services","name":"services","title":"Oleba structured service catalog","description":"Read-only structured service catalog with canonical public source pages.","mimeType":"application/json"},{"uri":"oleba://site/prices","name":"prices","title":"Oleba structured public price rows","description":"Structured rows parsed from the public renovation cennik. Informational, non-binding prices.","mimeType":"application/json"},{"uri":"oleba://site/cennik","name":"cennik","title":"Oleba public renovation price list","description":"Machine-readable public cennik page. Prices are informational and not binding offers.","mimeType":"text/markdown"}],"safety":{"access":"public-read-only","writes":false,"private_data":false,"rate_limited":true}}