{"openapi":"3.1.1","info":{"title":"Brownsmith Business Advisor Public Reference API","version":"1.0.0","description":"Public read-only business, service and offer data. GET and HEAD are supported; no API keys are required. This REST API does not expose contact submission. Use the separate authenticated Streamable HTTP MCP for interactive tools. No separate sandbox or fixed rate-limit commitment is published.","contact":{"name":"Brownsmith Dynamics","email":"contact@brownsmithdynamics.com","url":"https://brownsmithdynamics.com"}},"servers":[{"url":"https://mcp.brownsmithdynamics.com"}],"externalDocs":{"description":"Developer documentation, authentication and examples","url":"https://mcp.brownsmithdynamics.com/developers/"},"paths":{"/api":{"get":{"operationId":"getPublicCatalog","summary":"Get public reference catalog","description":"Retrieve published business information, services, offers and discovery links. No authentication; read-only.","security":[],"responses":{"200":{"description":"Published reference data. Amounts are indicative starting prices, with provenance and terms retained.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}},"400":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/v1/business":{"get":{"operationId":"getBusinessInformation","summary":"Get business information","description":"Retrieve the published business positioning, principles, email contact routes and source provenance.","security":[],"responses":{"200":{"description":"Published reference data. Amounts are indicative starting prices, with provenance and terms retained.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Business"}}}},"400":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/v1/services":{"get":{"operationId":"listServices","summary":"List services","description":"List published services. Optionally filter by the exact Discovery or BizFlow pillar. Unknown or repeated query parameters are rejected.","security":[],"parameters":[{"name":"pillar","in":"query","required":false,"description":"Return services in this published business pillar.","schema":{"type":"string","enum":["Discovery","BizFlow"]}}],"responses":{"200":{"description":"Published reference data. Amounts are indicative starting prices, with provenance and terms retained.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Service"}}}}},"400":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/v1/offers":{"get":{"operationId":"getServiceOffers","summary":"Get published offers","description":"Retrieve the current synchronized offer catalog with source snapshot, scopes, independent INR/USD starting prices and support terms. This is not a binding quotation.","security":[],"responses":{"200":{"description":"Published reference data. Amounts are indicative starting prices, with provenance and terms retained.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Offers"}}}},"400":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/health":{"get":{"operationId":"getServiceHealth","summary":"Get service health","description":"Check that the HTTP Worker is reachable. This does not verify downstream Telegram delivery or authenticated client setup.","security":[],"responses":{"200":{"description":"Published reference data. Amounts are indicative starting prices, with provenance and terms retained.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}},"400":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"405":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Structured HTTP problem with an error code and resolution hint.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"components":{"schemas":{"Problem":{"type":"object","required":["type","title","status","detail","instance","code","resolution"],"properties":{"type":{"type":"string","format":"uri","description":"Documentation for the problem type."},"title":{"type":"string","description":"Short error summary."},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string","description":"Explanation of this failure."},"instance":{"type":"string","format":"uri-reference","description":"API family where the failure occurred. Submitted values are not echoed."},"code":{"type":"string","description":"Stable machine-readable error code."},"resolution":{"type":"string","description":"Action the caller can take."}},"additionalProperties":false},"Business":{"type":"object","properties":{"name":{"type":"string","description":"Published name information."},"website":{"type":"string","description":"Published website information."},"source":{"type":"object","properties":{"url":{"type":"string","description":"Published url information."},"verifiedOn":{"type":"string","description":"Published verified on information."},"basis":{"type":"string","description":"Published basis information."}},"required":["url","verifiedOn","basis"],"additionalProperties":false,"description":"Published source information."},"positioning":{"type":"string","description":"Published positioning information."},"principles":{"type":"array","items":{"type":"string"},"description":"Published principles information."},"contact":{"type":"object","properties":{"contactUrl":{"type":"string","description":"Published contact url information."},"bookingUrl":{"type":"string","description":"Published booking url information."},"contactPageUrl":{"type":"string","description":"Published contact page url information."},"emailUrl":{"type":"string","description":"Published email url information."},"email":{"type":"string","description":"Published email information."}},"required":["contactUrl","bookingUrl","contactPageUrl","emailUrl","email"],"additionalProperties":false,"description":"Published contact information."}},"required":["name","website","source","positioning","principles","contact"],"additionalProperties":false},"Service":{"type":"object","properties":{"id":{"type":"string","description":"Published id information."},"name":{"type":"string","description":"Published name information."},"pillar":{"type":"string","description":"Published pillar information."},"category":{"type":"string","description":"Published category information."},"keywords":{"type":"array","items":{"type":"string"},"description":"Published keywords information."},"description":{"type":"string","description":"Published description information."},"url":{"type":"string","description":"Published url information."},"scope":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"Published title information."},"description":{"type":"string","description":"Published description information."}},"required":["title","description"],"additionalProperties":false},"description":"Published scope information."},"price_ids":{"type":"array","items":{"type":"string"},"description":"Published price ids information."}},"required":["id","name","pillar","category","keywords","description","url","scope","price_ids"],"additionalProperties":false},"Offers":{"type":"object","properties":{"source":{"type":"object","properties":{"branch":{"type":"string","description":"Published branch information."},"commit":{"type":"string","description":"Published commit information."},"localChanges":{"type":"boolean","description":"Published local changes information."},"capturedOn":{"type":"string","description":"Published captured on information."},"files":{"type":"object","properties":{"lib/service-pricing.ts":{"type":"string","description":"Published lib/service-pricing.ts information."},"lib/structured-pricing.ts":{"type":"string","description":"Published lib/structured-pricing.ts information."},"lib/service-details/efficiency.ts":{"type":"string","description":"Published lib/service-details/efficiency.ts information."},"lib/service-details/lead-generation.ts":{"type":"string","description":"Published lib/service-details/lead-generation.ts information."},"lib/website-estimator/config.ts":{"type":"string","description":"Published lib/website-estimator/config.ts information."},"lib/website-estimator/schema.ts":{"type":"string","description":"Published lib/website-estimator/schema.ts information."},"lib/website-estimator/scope.ts":{"type":"string","description":"Published lib/website-estimator/scope.ts information."},"lib/website-estimator/calculation.ts":{"type":"string","description":"Published lib/website-estimator/calculation.ts information."},"lib/website-estimator/engine.ts":{"type":"string","description":"Published lib/website-estimator/engine.ts information."},"lib/website-estimator/client.ts":{"type":"string","description":"Published lib/website-estimator/client.ts information."},"lib/website-estimator/examples.ts":{"type":"string","description":"Published lib/website-estimator/examples.ts information."},"lib/website-estimator/index.ts":{"type":"string","description":"Published lib/website-estimator/index.ts information."},"package.json":{"type":"string","description":"Published package.json information."},"package-lock.json":{"type":"string","description":"Published package-lock.json information."}},"required":["lib/service-pricing.ts","lib/structured-pricing.ts","lib/service-details/efficiency.ts","lib/service-details/lead-generation.ts","lib/website-estimator/config.ts","lib/website-estimator/schema.ts","lib/website-estimator/scope.ts","lib/website-estimator/calculation.ts","lib/website-estimator/engine.ts","lib/website-estimator/client.ts","lib/website-estimator/examples.ts","lib/website-estimator/index.ts","package.json","package-lock.json"],"additionalProperties":false,"description":"Published files information."},"refreshCommand":{"type":"string","description":"Published refresh command information."},"freshness":{"type":"string","description":"Published freshness information."},"validationRuntime":{"type":"object","properties":{"package":{"type":"string","description":"Published package information."},"version":{"type":"string","description":"Published version information."}},"required":["package","version"],"additionalProperties":false,"description":"Published validation runtime information."}},"required":["branch","commit","localChanges","capturedOn","files","refreshCommand","freshness","validationRuntime"],"additionalProperties":false,"description":"Published source information."},"startingPriceTerms":{"type":"string","description":"Published starting price terms information."},"bizFlowSupportTerms":{"type":"string","description":"Published biz flow support terms information."},"solutions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Published id information."},"name":{"type":"string","description":"Published name information."},"pillar":{"type":"string","description":"Published pillar information."},"url":{"type":"string","description":"Published url information."},"description":{"type":"string","description":"Published description information."},"scope":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"Published title information."},"description":{"type":"string","description":"Published description information."}},"required":["title","description"],"additionalProperties":false},"description":"Published scope information."},"requirements":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string","description":"Published question information."},"answer":{"type":"string","description":"Published answer information."}},"required":["question","answer"],"additionalProperties":false},"description":"Published requirements information."}},"required":["id","name","pillar","url","description","scope","requirements"],"additionalProperties":false},"description":"Published solutions information."},"prices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Published id information."},"service":{"type":"string","description":"Published service information."},"inr":{"type":"integer","description":"Published inr information."},"usd":{"type":"integer","description":"Published usd information."},"basis":{"type":"string","description":"Published basis information."},"solution":{"type":"string","description":"Published solution information."},"note":{"type":"string","description":"Published note information."},"pillar":{"type":"string","description":"Published pillar information."}},"required":["id","service","inr","usd","basis"],"additionalProperties":false},"description":"Published prices information."}},"required":["source","startingPriceTerms","bizFlowSupportTerms","solutions","prices"],"additionalProperties":false},"Catalog":{"type":"object","properties":{"name":{"type":"string","description":"Published name information."},"version":{"type":"string","description":"Published version information."},"description":{"type":"string","description":"Published description information."},"business":{"type":"object","properties":{"name":{"type":"string","description":"Published name information."},"website":{"type":"string","description":"Published website information."},"source":{"type":"object","properties":{"url":{"type":"string","description":"Published url information."},"verifiedOn":{"type":"string","description":"Published verified on information."},"basis":{"type":"string","description":"Published basis information."}},"required":["url","verifiedOn","basis"],"additionalProperties":false,"description":"Published source information."},"positioning":{"type":"string","description":"Published positioning information."},"principles":{"type":"array","items":{"type":"string"},"description":"Published principles information."},"contact":{"type":"object","properties":{"contactUrl":{"type":"string","description":"Published contact url information."},"bookingUrl":{"type":"string","description":"Published booking url information."},"contactPageUrl":{"type":"string","description":"Published contact page url information."},"emailUrl":{"type":"string","description":"Published email url information."},"email":{"type":"string","description":"Published email information."}},"required":["contactUrl","bookingUrl","contactPageUrl","emailUrl","email"],"additionalProperties":false,"description":"Published contact information."}},"required":["name","website","source","positioning","principles","contact"],"additionalProperties":false,"description":"Published business information."},"services":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Published id information."},"name":{"type":"string","description":"Published name information."},"pillar":{"type":"string","description":"Published pillar information."},"category":{"type":"string","description":"Published category information."},"keywords":{"type":"array","items":{"type":"string"},"description":"Published keywords information."},"description":{"type":"string","description":"Published description information."},"url":{"type":"string","description":"Published url information."},"scope":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"Published title information."},"description":{"type":"string","description":"Published description information."}},"required":["title","description"],"additionalProperties":false},"description":"Published scope information."},"price_ids":{"type":"array","items":{"type":"string"},"description":"Published price ids information."}},"required":["id","name","pillar","category","keywords","description","url","scope","price_ids"],"additionalProperties":false},"description":"Published services information."},"offers":{"type":"object","properties":{"source":{"type":"object","properties":{"branch":{"type":"string","description":"Published branch information."},"commit":{"type":"string","description":"Published commit information."},"localChanges":{"type":"boolean","description":"Published local changes information."},"capturedOn":{"type":"string","description":"Published captured on information."},"files":{"type":"object","properties":{"lib/service-pricing.ts":{"type":"string","description":"Published lib/service-pricing.ts information."},"lib/structured-pricing.ts":{"type":"string","description":"Published lib/structured-pricing.ts information."},"lib/service-details/efficiency.ts":{"type":"string","description":"Published lib/service-details/efficiency.ts information."},"lib/service-details/lead-generation.ts":{"type":"string","description":"Published lib/service-details/lead-generation.ts information."},"lib/website-estimator/config.ts":{"type":"string","description":"Published lib/website-estimator/config.ts information."},"lib/website-estimator/schema.ts":{"type":"string","description":"Published lib/website-estimator/schema.ts information."},"lib/website-estimator/scope.ts":{"type":"string","description":"Published lib/website-estimator/scope.ts information."},"lib/website-estimator/calculation.ts":{"type":"string","description":"Published lib/website-estimator/calculation.ts information."},"lib/website-estimator/engine.ts":{"type":"string","description":"Published lib/website-estimator/engine.ts information."},"lib/website-estimator/client.ts":{"type":"string","description":"Published lib/website-estimator/client.ts information."},"lib/website-estimator/examples.ts":{"type":"string","description":"Published lib/website-estimator/examples.ts information."},"lib/website-estimator/index.ts":{"type":"string","description":"Published lib/website-estimator/index.ts information."},"package.json":{"type":"string","description":"Published package.json information."},"package-lock.json":{"type":"string","description":"Published package-lock.json information."}},"required":["lib/service-pricing.ts","lib/structured-pricing.ts","lib/service-details/efficiency.ts","lib/service-details/lead-generation.ts","lib/website-estimator/config.ts","lib/website-estimator/schema.ts","lib/website-estimator/scope.ts","lib/website-estimator/calculation.ts","lib/website-estimator/engine.ts","lib/website-estimator/client.ts","lib/website-estimator/examples.ts","lib/website-estimator/index.ts","package.json","package-lock.json"],"additionalProperties":false,"description":"Published files information."},"refreshCommand":{"type":"string","description":"Published refresh command information."},"freshness":{"type":"string","description":"Published freshness information."},"validationRuntime":{"type":"object","properties":{"package":{"type":"string","description":"Published package information."},"version":{"type":"string","description":"Published version information."}},"required":["package","version"],"additionalProperties":false,"description":"Published validation runtime information."}},"required":["branch","commit","localChanges","capturedOn","files","refreshCommand","freshness","validationRuntime"],"additionalProperties":false,"description":"Published source information."},"startingPriceTerms":{"type":"string","description":"Published starting price terms information."},"bizFlowSupportTerms":{"type":"string","description":"Published biz flow support terms information."},"solutions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Published id information."},"name":{"type":"string","description":"Published name information."},"pillar":{"type":"string","description":"Published pillar information."},"url":{"type":"string","description":"Published url information."},"description":{"type":"string","description":"Published description information."},"scope":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"Published title information."},"description":{"type":"string","description":"Published description information."}},"required":["title","description"],"additionalProperties":false},"description":"Published scope information."},"requirements":{"type":"array","items":{"type":"object","properties":{"question":{"type":"string","description":"Published question information."},"answer":{"type":"string","description":"Published answer information."}},"required":["question","answer"],"additionalProperties":false},"description":"Published requirements information."}},"required":["id","name","pillar","url","description","scope","requirements"],"additionalProperties":false},"description":"Published solutions information."},"prices":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Published id information."},"service":{"type":"string","description":"Published service information."},"inr":{"type":"integer","description":"Published inr information."},"usd":{"type":"integer","description":"Published usd information."},"basis":{"type":"string","description":"Published basis information."},"solution":{"type":"string","description":"Published solution information."},"note":{"type":"string","description":"Published note information."},"pillar":{"type":"string","description":"Published pillar information."}},"required":["id","service","inr","usd","basis"],"additionalProperties":false},"description":"Published prices information."}},"required":["source","startingPriceTerms","bizFlowSupportTerms","solutions","prices"],"additionalProperties":false,"description":"Published offers information."},"links":{"type":"object","properties":{"docs":{"type":"string","description":"Published docs information."},"openapi":{"type":"string","description":"Published openapi information."},"mcpMetadata":{"type":"string","description":"Published mcp metadata information."},"mcp":{"type":"string","description":"Published mcp information."},"instructions":{"type":"string","description":"Published instructions information."},"business":{"type":"string","description":"Published business information."},"services":{"type":"string","description":"Published services information."},"offers":{"type":"string","description":"Published offers information."}},"required":["docs","openapi","mcpMetadata","mcp","instructions","business","services","offers"],"additionalProperties":false,"description":"Published links information."}},"required":["name","version","description","business","services","offers","links"],"additionalProperties":false},"Health":{"type":"object","properties":{"status":{"type":"string","const":"ok"},"transport":{"type":"string","const":"streamable-http"}},"required":["status","transport"],"additionalProperties":false}}}}