mcpbundles.com

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search term, e.g. \"stripe\", \"postgres\", or \"weather\". Optional when a filter facet is set."
    },
    "kind": {
      "type": "string",
      "enum": [
        "managed",
        "provider",
        "webmcp"
      ],
      "description": "Browse chip shape (not ownership): managed = MCPBundles API integrations (api_bundle); provider = remote_mcp (publisher wire; may still have catalogListing true); webmcp = in-browser surface. For independent harvest servers use harvest_only."
    },
    "catalog_listing": {
      "type": "boolean",
      "description": "When true, only rows with a global MCPBundles bundle. When false, only rows without one."
    },
    "harvest_only": {
      "type": "boolean",
      "description": "Independent remote servers only (remote_mcp, no global bundle). Best for long-tail discovery."
    },
    "connect_path": {
      "type": "string",
      "enum": [
        "managed",
        "importable",
        "import_auth_required",
        "browse_only",
        "connect_now",
        "import_server",
        "import_may_need_sign_in",
        "view_only"
      ],
      "description": "Filter by what Hub can do: managed/importable/import_auth_required/browse_only or aliases connect_now, import_server, import_may_need_sign_in, view_only."
    },
    "connect_action": {
      "type": "string",
      "enum": [
        "managed",
        "importable",
        "import_auth_required",
        "browse_only",
        "connect_now",
        "import_server",
        "import_may_need_sign_in",
        "view_only"
      ],
      "description": "Alias for connect_path using agent vocabulary."
    },
    "verification": {
      "type": "string",
      "enum": [
        "tools_listed",
        "auth_handshake",
        "curated",
        "reachable"
      ],
      "description": "Evidence level: tools_listed, auth_handshake, curated, reachable (same as live_tools when omitted)."
    },
    "category": {
      "type": "string",
      "description": "Single category slug (legacy). Aliases map narrowly (e.g. productivity → PROJECT_MANAGEMENT). Prefer categories when ANDing."
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Category slugs ANDed together, e.g. [\"marketing\", \"developer-tools\"]. Same as browse categories=."
    },
    "exclude_categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Omit listings in these categories (primary category or harvest flag slug, e.g. ecommerce)."
    },
    "mcp_app": {
      "type": "boolean",
      "description": "Only servers shipping an MCP App / interactive UI surface."
    },
    "live_tools": {
      "type": "boolean",
      "description": "Shorthand for verification=reachable when verification is omitted."
    },
    "no_upstream_sign_in": {
      "type": "boolean",
      "description": "Only servers that need no upstream service sign-in or OAuth (public \"No sign in\" facet)."
    },
    "no_account_needed": {
      "type": "boolean",
      "description": "Deprecated alias for no_upstream_sign_in."
    },
    "one_click_sign_in": {
      "type": "boolean",
      "description": "Only listings with OAuth dynamic client registration (one-click sign-in facet)."
    },
    "min_tools": {
      "type": "integer",
      "description": "Only servers reporting at least this many tools from the probe. Null toolsCount means unknown or auth-gated, not zero tools.",
      "minimum": 1
    },
    "limit": {
      "type": "integer",
      "description": "Results per page (default 12, max 100). Use cursor from nextCursor for the next page.",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "type": "string",
      "description": "Opaque pagination cursor from pagination.nextCursor or nextCursor on the prior response."
    }
  }
}