Portfolio Alerts

Scan multiple companies for red flags and compute severity classifications (critical / warning / info). Builds on the carta-portfolio-query pattern.

Prerequisites

No inputs required — this skill loops the full portfolio. Call list_accounts to get all corporation_pk accounts automatically.

Data Retrieval

Portfolio Enumeration

Call list_accounts to get all portfolio companies. Filter to accounts where id starts with corporation_pk:. Extract up to 20 numeric corporation IDs. If more than 20 companies exist, ask the user to narrow scope.

Per-Company Commands

For each company, these are the relevant checks:

• fetch("cap_table:get:409a_valuations", {"corporation_id": corporation_id}) -- 409A expiry check
• fetch("cap_table:get:cap_table_by_share_class", {"corporation_id": corporation_id}) -- option pool check
• fetch("cap_table:get:convertible_notes", {"corporation_id": corporation_id}) -- note maturity check (summary includes maturity.nearest_date)
• fetch("cap_table:list:safes", {"corporation_id": corporation_id}) -- SAFE exposure check

The gateway defaults to detail=summary for list commands. All four commands use summary mode — the convertible notes summary includes a maturity block with nearest_date and total_outstanding_debt for outstanding debt notes.

If the user asks about a specific check only (e.g. "any expiring 409As?"), fetch only the relevant command per company.

Parallel execution: The fetch tool has readOnlyHint=true, so Claude Code executes parallel fetch calls concurrently. Issue ALL fetch calls for ALL companies in a single response — do NOT loop company-by-company. See Workflow Step 2.

Key Fields

From 409A: expiration_date, price, effective_date From cap table option plans: available_ownership, name From convertible notes (summary): maturity.nearest_date, maturity.total_outstanding_debt, by_status, by_type

Workflow

Step 1 — Get Portfolio

Call list_accounts to get all corporation_pk accounts. Extract up to 20 numeric corporation IDs.

Step 2 — Fetch Data for All Companies (parallel)

Issue ALL fetch calls for ALL companies in a single response — do NOT loop company-by-company. Each fetch call is independent and will execute concurrently.

For example, with 5 companies and all 4 checks, issue all 20 fetch calls at once:

fetch("cap_table:get:409a_valuations", {"corporation_id": 1})
fetch("cap_table:get:cap_table_by_share_class", {"corporation_id": 1})
fetch("cap_table:get:convertible_notes", {"corporation_id": 1})
fetch("cap_table:list:safes", {"corporation_id": 1})
fetch("cap_table:get:409a_valuations", {"corporation_id": 2})
fetch("cap_table:get:cap_table_by_share_class", {"corporation_id": 2})
... (all companies)

If the user asks about a specific check only (e.g. "any expiring 409As?"), issue only the relevant command per company — but still all companies in one response.

Step 3 — Classify Findings

Apply severity thresholds to the results for each company:

1. Expiring 409A Valuations

Companies with no 409A data should never be silently skipped — always include them in the output as a distinct category.

2. Low Option Pool

3. SAFEs/Notes Approaching Maturity

Use maturity.nearest_date and maturity.total_outstanding_debt from the convertible notes summary. These fields are pre-filtered to outstanding debt notes by the backend.

4. Large Unconverted SAFE Exposure

Sum outstanding SAFE amounts per company.

Step 4 — Present Results

Present a summary dashboard (see Presentation section).

Gates

Required inputs: None — portfolio enumeration is automatic.

AI computation: Yes — severity classifications (critical, warning, info) for 409A expiry, option pool health, note maturity, and SAFE exposure are AI-derived. Trigger the AI computation gate (see carta-interaction-reference §6.2) before outputting any severity classifications or health assessments.

Subagent prohibition: Not applicable.

Presentation

Format: Summary dashboard + detail table

BLUF lead: Lead with the count of companies scanned and the critical/warning/healthy breakdown.

Sort order: Severity (critical first), then urgency (nearest deadline first).

Date format: MMM d, yyyy (e.g. "Jan 15, 2026").

Summary Dashboard

Portfolio Health Check — 12 companies scanned

Critical (2):
  - Beta Inc: 409A EXPIRED (expired Jan 14, 2025, 63 days ago)
  - Gamma Corp: Option pool at 1.2% available

Warning (3):
  - Acme Corp: 409A expires in 37 days (Apr 24, 2025)
  - Delta LLC: Convertible note matures in 45 days
  - Epsilon Inc: Option pool at 4.1% available

Healthy (7): Alpha, Zeta, Eta, Theta, Iota, Kappa, Lambda

Detail Table (for specific checks)

Caveats

• Portfolio data reflects point-in-time API calls, not a single atomic snapshot
• Companies with restricted permissions may have incomplete data
• Rate limit: maximum 20 companies per invocation — ask the user to narrow scope if more than 20
• Some companies may error (permissions, incomplete setup) — skip gracefully and note which failed
• Always show the scan date and count: "Scanned 12 companies on Mar 18, 2025"