mcpbundles.com

{
  "name": "search_mcp_servers",
  "kind": "answer",
  "impl": "imperative",
  "description": "Agent quick start: (1) search_mcp_servers with query or filters → (2) get_mcp_server with slug and include instructions or connect → (3) connect using connectAction/connectPath. Use harvest_only for independent servers; catalog_listing for MCPBundles bundles; connect_path/connect_action for actionability; verification instead of live_tools when you need probe precision. kind describes listing shape, not ownership — check catalogListing and connectAction on each result. Results include connectPath, connectAction, catalogListing, toolInventoryStatus, pageUrl, and toolsCount when observed. Provide query and/or at least one filter — enforced at execution time.",
  "inputSchema": {
    "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."
      }
    }
  },
  "page": "/getting-started"
}

{
  "name": "get_mcp_server",
  "kind": "answer",
  "impl": "imperative",
  "description": "Fetch one directory listing by slug. Default is summary (browse-card fields). Request include[] for server instructions (instructionsAvailable when missing) or connect/install guidance (installUrl, mcpServerUrl).",
  "inputSchema": {
    "type": "object",
    "properties": {
      "slug": {
        "type": "string",
        "description": "Directory listing slug, e.g. \"google-ads-mcp\"."
      },
      "include": {
        "type": "array",
        "items": {
          "type": "string",
          "enum": [
            "summary",
            "instructions",
            "connect"
          ]
        },
        "description": "Response tiers: summary (default), instructions (server markdown), connect (install URLs and guidance)."
      },
      "host": {
        "type": "string",
        "enum": [
          "claude-web",
          "cursor",
          "vscode",
          "lm-studio",
          "cherry-studio",
          "craft-agents"
        ],
        "description": "Preferred MCP host for install links when include contains connect."
      }
    },
    "required": [
      "slug"
    ]
  },
  "page": "/getting-started"
}