@bbradar/mcp 0.1.10 → 0.1.11

package/README.md

@@ -58,17 +58,17 @@ The server needs your [bbradar.io](https://bbradar.io) Pro key. In the MCP clien
 Add with the Codex CLI:
 
 ```bash
-codex mcp add bbradar.io --env BBRADAR_API_KEY="your_pro_mcp_api_key" -- npx -y @bbradar/mcp
+codex mcp add bbradar_io --env BBRADAR_API_KEY="your_pro_mcp_api_key" -- npx -y @bbradar/mcp
 ```
 
 Or add it to `~/.codex/config.toml`:
 
 ```toml
-[mcp_servers."bbradar.io"]
+[mcp_servers.bbradar_io]
 command = "npx"
 args = ["-y", "@bbradar/mcp"]
 
-[mcp_servers."bbradar.io".env]
+[mcp_servers.bbradar_io.env]
 BBRADAR_API_KEY = "your_pro_mcp_api_key"
 ```
 
@@ -77,13 +77,13 @@ BBRADAR_API_KEY = "your_pro_mcp_api_key"
 Add a private user-level server:
 
 ```bash
-claude mcp add bbradar.io --scope user --env BBRADAR_API_KEY="your_pro_mcp_api_key" -- npx -y @bbradar/mcp
+claude mcp add bbradar_io --scope user --env BBRADAR_API_KEY="your_pro_mcp_api_key" -- npx -y @bbradar/mcp
 ```
 
 On native Windows, wrap `npx` with `cmd /c`:
 
 ```bash
-claude mcp add bbradar.io --scope user --env BBRADAR_API_KEY="your_pro_mcp_api_key" -- cmd /c npx -y @bbradar/mcp
+claude mcp add bbradar_io --scope user --env BBRADAR_API_KEY="your_pro_mcp_api_key" -- cmd /c npx -y @bbradar/mcp
 ```
 
 ### Generic MCP JSON
@@ -127,6 +127,7 @@ After adding the MCP config, restart your client and call `get_mcp_status`. A wo
 - `find_stack_matches`
 - `find_low_noise_programs`
 - `find_recent_by_type`
+- `find_recently_updated_programs`
 - `find_programs_by_target`
 - `find_program_candidates`
 - `find_hunt_candidates`

package/dist/server.js

@@ -94,7 +94,7 @@ const filterValueSchema = z
 });
 const stringListSchema = z
     .preprocess(normalizeStringListInput, z.array(filterValueSchema).max(50).default([]))
-    .describe("Filter values.");
+    .describe("Optional filter values. Empty or omitted means all values; do not infer a platform filter.");
 const acceptedTargetLimitSchema = z.number().int().min(1).max(MAX_TARGETS_PER_PROGRAM);
 const searchTextSchema = z
     .string()
@@ -228,7 +228,8 @@ export function createBbradarServer(client, config) {
             "For BBRadar asks, use these tools first and avoid external skills unless methodology is explicitly requested.",
             "Partial program name + action: run_program_name_action. Partial program name only: resolve_program.",
             "Default to bounty-eligible in-scope data. Include out-of-scope, ineligible, VDP, disclosure-only, or no-bounty data only when the user explicitly asks.",
-            "Freshness: get_latest_added_targets, check_program_new_targets, check_watchlist_new_targets, find_recent_by_type, get_program_scope_delta.",
+            "Recently updated programs across platforms: find_recently_updated_programs. Do not infer a platform such as Immunefi unless the user explicitly names it.",
+            "Freshness: find_recently_updated_programs, get_latest_added_targets, check_program_new_targets, check_watchlist_new_targets, find_recent_by_type, get_program_scope_delta.",
             "Discovery: find_program_candidates, find_stack_matches, find_language_programs, find_target_type_programs, find_reward_programs, find_paid_programs, find_vdp_programs, find_web3_contests, find_low_noise_programs.",
             "Details: get_program_brief, get_program_scope_summary, get_program_target_breakdown, find_programs_by_target, compare_programs_compact.",
             "Prefer compact/identifier outputs and disclose sampled ranking scope when present."
@@ -1146,6 +1147,31 @@ export function createBbradarServer(client, config) {
         output_mode: args.output_mode,
         upstream_request_budget: args.upstream_request_budget
     })));
+    server.registerTool("find_recently_updated_programs", {
+        title: "Find Recently Updated Programs",
+        description: "Recently updated program shortlist across all platforms by default. Platform filters are applied only when explicitly provided.",
+        inputSchema: {
+            platforms: stringListSchema,
+            tags: stringListSchema,
+            target_types: stringListSchema,
+            language_tags: stringListSchema,
+            web3: z.boolean().default(false),
+            updated_since: isoDateTimeSchema.optional(),
+            require_bounty: z.boolean().default(false),
+            min_eligible_targets: z.number().int().min(0).optional(),
+            exclude_ctf: z.boolean().default(true),
+            vdp_mode: vdpModeSchema.default("exclude").describe("VDP/no-bounty filter mode."),
+            max_pages: z.number().int().min(1).max(MAX_ACCEPTED_NUMERIC_LIMIT).default(5),
+            max_results: z.number().int().min(1).max(MAX_ACCEPTED_NUMERIC_LIMIT).default(10),
+            include_target_samples: z.boolean().default(false),
+            target_sample_programs: z.number().int().min(0).max(MAX_ACCEPTED_NUMERIC_LIMIT).default(3),
+            target_sample_size: z.number().int().min(1).max(MAX_ACCEPTED_NUMERIC_LIMIT).default(3),
+            output_mode: programListModeSchema.default("compact"),
+            upstream_request_budget: z.number().int().min(1).max(MAX_ACCEPTED_NUMERIC_LIMIT).default(DEFAULT_FIND_UPSTREAM_REQUEST_BUDGET)
+        },
+        outputSchema: findProgramsOutputShape,
+        annotations: readOnlyAnnotations
+    }, (args) => runTool("find_recently_updated_programs", config, rateLimiter, async () => findRecentlyUpdatedPrograms(client, config, args)));
     server.registerTool("list_filters", {
         title: "List BBRadar Filters",
         description: "Discover observed filter values.",
@@ -2280,6 +2306,48 @@ function findProgramCandidates(client, config, input) {
         upstream_request_budget: input.upstream_request_budget
     });
 }
+function findRecentlyUpdatedPrograms(client, config, input) {
+    return findPrograms(client, config, {
+        platforms: input.platforms,
+        tags: input.tags,
+        scope_tags: [],
+        target_types: input.target_types,
+        language_tags: input.language_tags,
+        web3: input.web3,
+        opportunity_levels: [],
+        updated_since: input.updated_since,
+        min_bounty_min: undefined,
+        min_bounty_max: undefined,
+        max_bounty_max: undefined,
+        require_bounty: input.require_bounty,
+        max_public_report_count: undefined,
+        require_known_report_count: false,
+        include_unknown_report_count: true,
+        exclude_ctf: input.exclude_ctf,
+        exclude_mobile_only: false,
+        exclude_non_web: false,
+        has_api_scope: input.target_types.some((targetType) => normalizeTag(targetType).includes("api")),
+        contest_like: false,
+        vdp_mode: input.vdp_mode,
+        fresh_launch_days: undefined,
+        min_wildcards: 0,
+        min_eligible_targets: input.min_eligible_targets,
+        min_total_targets: undefined,
+        min_added_24h: undefined,
+        min_added_7d: undefined,
+        max_pages: input.max_pages,
+        max_results: input.max_results,
+        sort_by: "recently_updated",
+        include_target_samples: input.include_target_samples,
+        target_sample_programs: input.target_sample_programs,
+        target_sample_size: input.target_sample_size,
+        only_in_scope_targets: true,
+        only_bounty_eligible_targets: true,
+        target_samples_only_wildcards: false,
+        output_mode: input.output_mode ?? "compact",
+        upstream_request_budget: input.upstream_request_budget
+    });
+}
 function findRewardPrograms(client, config, input) {
     return findPrograms(client, config, {
         platforms: input.platforms,
@@ -4876,6 +4944,9 @@ async function findPrograms(client, config, input) {
         .sort((left, right) => compareProgramCandidates(left, right, input.sort_by));
     const candidates = filteredCandidates.slice(0, input.max_results);
     const targetSamplePrograms = Math.min(input.target_sample_programs, candidates.length, Math.max(0, budget.remaining));
+    if (input.sort_by === "recently_updated" && input.platforms.length === 0) {
+        addUniqueWarning(warnings, "No platform filter was provided; recently updated ranking considered all platforms returned by the scanned BBRadar pages.");
+    }
     if (input.include_target_samples && input.target_sample_programs > targetSamplePrograms) {
         warnings.push(`target_sample_programs was reduced from ${input.target_sample_programs} to ${targetSamplePrograms} to stay within the upstream request budget.`);
     }
@@ -4923,6 +4994,7 @@ async function findPrograms(client, config, input) {
         },
         ranking_scope: {
             mode: "sampled",
+            platform_filter: input.platforms.length > 0 ? input.platforms : "all_platforms",
             max_pages_scanned_per_source: input.max_pages,
             upstream_total_pages: collected.totalPagesBySource,
             possibly_incomplete: isRankingPossiblyIncomplete(collected.totalPagesBySource, input.max_pages)