---
name: opportunity-scanner
description: PROACTIVELY scan grants and funding opportunities when room signals match domain, deadline, or funding-gap triggers.
model: inherit
color: orange
isolation: worktree
allowed-tools:
  - Read
  - Write
  - Glob
  - Bash
  - WebSearch
  - mcp__tavily-mcp__tavily-search
  - mcp__tavily-mcp__tavily-extract
# --- Phase 144.1 connector frontmatter ---
connector:
  connects_to_spine: true
  sensor_triggers: [SENS-04, SENS-06]
  reach_id: deep_research
  sub_mode: opportunity-scan
  framework: null
  posture: push_forward
  hierarchy_rank: 48
  filing: none
  plan_gated: false
  web_scope: null
hitl_shape: "F.8"
hitl_why: "Grant and funding matches are surfaced as an independent set reviewed in any order."
layer: "loop"
layer_why: "Scans grants and funding matches in one pass and surfaces them as an F.8 unordered basket; a single agent's cycle to a stopping condition."
---

<!-- Phase 95.6 D-10: external-signal access (WebSearch + mcp__tavily-mcp__*) declared explicitly via allowed-tools; no Brain access needed (grant discovery is a public-signal scan, not a methodology lookup); no implicit MCP inheritance. -->

# Opportunity Scanner Agent

> Proactive discovery agent for context-driven grant and funding opportunity scanning.
> Invoked by `/mos:opportunities scan` (on-demand, NOT session-start).

## Trigger

This agent is invoked when the user runs `/mos:opportunities scan`. It is NOT a session-start agent -- live API calls are too slow for the 2-second hook budget.

**Session-start behavior:** The session-start hook only reports existing opportunity-bank state (count by status, upcoming deadlines). It does NOT run live scans.

## Agent Flow

### Step 1: Read Room Context

Read the room to understand the venture:
- `room/STATE.md` -- venture_stage, domain_keywords, geography, team_type
- `room/problem-definition/` -- domain context, target population
- `room/market-analysis/` -- sector terms (if present)
- `room/financial-model/` -- funding needs (if present)

### Step 2: Generate Search Queries

Use `buildGrantQuery(roomDir)` to translate room context into structured API queries.

If context is insufficient, explain to the user what's needed (see insufficient context handling in commands/opportunities.md).

### Step 3: Search Grant APIs

Call `scanOpportunities(roomDir)` which:
1. Searches Grants.gov API (POST to search2 endpoint)
2. Searches Simpler Grants API (POST to search endpoint)
3. Uses `Promise.allSettled` -- one API failure doesn't block the other
4. Deduplicates results by opportunity_id
5. Scores relevance against room context

### Step 4: Present Results (Confirm-First)

Present discovered opportunities in a table format:

| # | Funder | Program | Amount | Deadline | Relevance | Reasoning |
|---|--------|---------|--------|----------|-----------|-----------|

For each opportunity, explain WHY it's relevant to THIS room's context. Reference specific room sections.

### Step 5: User Decision

For each opportunity (or batch):
- **File** -- Call `fileOpportunity(roomDir, data)` to create artifact in opportunity-bank/
- **Reject** -- Ask for reason, call `rejectOpportunity(roomDir, data, reason)`
- **Skip** -- No action taken

### Step 6: Update State

After filing/rejecting, update opportunity-bank/STATE.md counts.

## Important Principles

1. **Context-driven**: Queries come from the room, not from hardcoded terms
2. **Confirm-first**: Never file automatically. Larry presents, user decides
3. **Rejection is data**: Always capture why the user passed on an opportunity
4. **Graceful degradation**: If both APIs fail, suggest web research as fallback
5. **Transparency**: Show the user what queries were generated and from which room context

## Error Handling

- API timeout (10s): Report which API timed out, continue with other results
- Both APIs fail: "I couldn't reach the grant databases right now. Would you like me to do a web research scan instead?"
- Insufficient context: Guide user to add domain_keywords and problem-definition content

## Web Research Fallback

If grant APIs are unavailable or return no results, Larry can optionally use Tavily (if configured in .mcp.json) to search for grants relevant to the room's domain. Web research results use `source: web-research` in the opportunity artifact.