{
  "openapi": "3.1.0",
  "info": {
    "title": "Cognilode Marketplace Discovery",
    "version": "0.4.0",
    "description": "Read-only supply discovery, buyer-intent comparison guides, public seller intake, and buyer-demand contracts for Cognilode Marketplace. Sellers retain their own checkout and fulfillment during the founding program."
  },
  "servers": [
    {"url": "https://cognilode.com"}
  ],
  "x-cognilode-seller-intake": {
    "composition_origin": "https://cognilode.com/marketplace/sell/",
    "public_issue_form": "https://github.com/evanbrown3000/cognilode-mcp-capability-navigator/issues/new?template=marketplace-listing.yml",
    "normalized_index": "https://raw.githubusercontent.com/evanbrown3000/cognilode-mcp-capability-navigator/main/marketplace-applications/index.json",
    "automatic_catalog_publication": false,
    "payments_custodied_by_cognilode": false
  },
  "x-cognilode-buyer-demand": {
    "composition_origin": "https://cognilode.com/marketplace/request/",
    "public_issue_form": "https://github.com/evanbrown3000/cognilode-mcp-capability-navigator/issues/new?template=marketplace-demand.yml",
    "normalized_index": "https://raw.githubusercontent.com/evanbrown3000/cognilode-mcp-capability-navigator/main/marketplace-demand/index.json",
    "match_index": "https://raw.githubusercontent.com/evanbrown3000/cognilode-mcp-capability-navigator/main/marketplace-demand/matches.json",
    "email_required": false,
    "request_is_contract": false,
    "request_is_order": false,
    "request_is_income": false,
    "match_is_order": false,
    "match_is_income": false
  },
  "x-cognilode-buyer-guides": {
    "canonical_index": "https://cognilode.com/marketplace/compare/",
    "source_contract": "https://cognilode.com/marketplace/use-cases.json",
    "machine_index": "https://cognilode.com/marketplace/use-case-index.json",
    "ranking_model": "none",
    "paid_placement_affects_inclusion": false,
    "minimum_listings_per_surface": 2
  },
  "paths": {
    "/marketplace/catalog.json": {
      "get": {
        "operationId": "listMarketplaceProducts",
        "summary": "List current Cognilode Marketplace seller-managed products",
        "description": "Returns the canonical machine-readable seller inventory including category, provider checkout, listing URL, and founding-program metadata.",
        "responses": {"200": {"description": "Marketplace catalog", "content": {"application/json": {"schema": {"type": "object"}}}}}
      }
    },
    "/marketplace/external-catalog.json": {
      "get": {
        "operationId": "listMarketplaceExternalDirectory",
        "summary": "List current unclaimed public marketplace directory entries",
        "description": "Returns factual provider directory entries with relationship disclosure, Cognilode-owned outbound measurement paths, provider-native destinations, and claim/correction paths.",
        "responses": {"200": {"description": "External marketplace directory", "content": {"application/json": {"schema": {"type": "object"}}}}}
      }
    },
    "/marketplace/compare/": {
      "get": {
        "operationId": "listMarketplaceBuyerGuides",
        "summary": "Browse buyer-oriented marketplace comparison guides",
        "description": "Human-readable use-case guides organize multiple current listings around a concrete buyer decision. They are unranked and are not paid-placement surfaces.",
        "responses": {"200": {"description": "Buyer comparison guide index"}}
      }
    },
    "/marketplace/use-cases.json": {
      "get": {
        "operationId": "getMarketplaceBuyerGuideContract",
        "summary": "Read the source contract for buyer comparison guides",
        "responses": {"200": {"description": "Use-case configuration and quality gates", "content": {"application/json": {"schema": {"type": "object"}}}}}
      }
    },
    "/marketplace/use-case-index.json": {
      "get": {
        "operationId": "listMarketplaceBuyerGuideIndex",
        "summary": "List generated marketplace buyer comparison surfaces",
        "responses": {"200": {"description": "Machine-readable comparison guide index", "content": {"application/json": {"schema": {"type": "object"}}}}}
      }
    },
    "/marketplace/mcp": {
      "get": {
        "operationId": "getMarketplaceMcpDescriptor",
        "summary": "Read Cognilode Marketplace MCP endpoint metadata",
        "description": "The read-only MCP endpoint exposes search, fetch, and compare tools for marketplace and buyer-guide discovery.",
        "responses": {"200": {"description": "Marketplace MCP descriptor", "content": {"application/json": {"schema": {"type": "object"}}}}}
      }
    },
    "/marketplace/sell/": {
      "get": {
        "operationId": "getMarketplaceSellerProgram",
        "summary": "Read and compose a founding seller application",
        "description": "Application data is composed on cognilode.com and submitted by the seller as a public GitHub issue after review.",
        "responses": {"200": {"description": "Seller program and application composer"}}
      }
    },
    "/marketplace/intake.json": {
      "get": {
        "operationId": "getMarketplaceSellerIntakeContract",
        "summary": "Read the seller intake contract",
        "responses": {"200": {"description": "Seller intake contract", "content": {"application/json": {"schema": {"type": "object"}}}}}
      }
    },
    "/marketplace/request/": {
      "get": {
        "operationId": "getMarketplaceBuyerDemandComposer",
        "summary": "Compose a public marketplace buyer request",
        "description": "Buyer demand is composed on cognilode.com and submitted by the requester as a public GitHub issue after review. No email is required.",
        "responses": {"200": {"description": "Buyer demand composer"}}
      }
    },
    "/marketplace/demand.json": {
      "get": {
        "operationId": "getMarketplaceBuyerDemandContract",
        "summary": "Read the buyer-demand and automated matching contract",
        "description": "Returns the public queue, normalized demand index, demand-to-supply match index, response policy, automation behavior, privacy constraints, and economic-truth rules.",
        "responses": {"200": {"description": "Buyer demand contract", "content": {"application/json": {"schema": {"type": "object"}}}}}
      }
    },
    "/marketplace/seller-listing.schema.json": {
      "get": {
        "operationId": "getMarketplaceSellerListingSchema",
        "summary": "Read the founding seller listing JSON Schema",
        "responses": {"200": {"description": "JSON Schema for public seller listing metadata", "content": {"application/schema+json": {"schema": {"type": "object"}}}}}
      }
    },
    "/marketplace/supply-policy.json": {
      "get": {
        "operationId": "getMarketplaceSupplyPolicy",
        "summary": "Read the demand-backed first-party supply policy",
        "description": "Explains why new first-party marketplace supply is blocked without public external buyer-demand evidence while third-party supply remains open.",
        "responses": {"200": {"description": "Marketplace supply policy", "content": {"application/json": {"schema": {"type": "object"}}}}}
      }
    },
    "/marketplace/operating-model.json": {
      "get": {
        "operationId": "getMarketplaceOperatingModel",
        "summary": "Read the outcome-driven marketplace operating model",
        "responses": {"200": {"description": "Marketplace roles, funnels, allocation policy, phases, and economic metrics", "content": {"application/json": {"schema": {"type": "object"}}}}}
      }
    }
  }
}