Agent Utility Suite (x402)

{
  "type": "object",
  "properties": {
    "cik": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{1,10}$"
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "domain": {
      "type": "string",
      "maxLength": 253,
      "minLength": 3,
      "description": "The company's website domain or any URL on it, e.g. \"stripe.com\". Use this, `company`, `ticker` or `cik`."
    },
    "ticker": {
      "type": "string",
      "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$",
      "description": "US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`."
    },
    "company": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "The company or person, e.g. \"Acme Robotics Inc.\" Screened against OFAC and looked up as a company."
    },
    "chain": {
      "enum": [
        "base",
        "ethereum"
      ],
      "type": "string",
      "default": "base",
      "description": "Chain of `wallet`: \"base\" (default) or \"ethereum\"."
    },
    "domain": {
      "type": "string",
      "maxLength": 300,
      "minLength": 3,
      "description": "Their website or email domain, e.g. \"acme.com\" (a URL or an email address is accepted)."
    },
    "wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "The EVM address you would pay or receive from, e.g. an x402 payTo."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "wallet"
  ],
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End date (inclusive, UTC), instead of `year`."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date (inclusive, UTC), instead of `year`."
    },
    "year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 2015,
      "description": "Tax year (calendar, UTC). Default: the current year. Use `from`/`to` for another period."
    },
    "chain": {
      "enum": [
        "base",
        "ethereum"
      ],
      "type": "string",
      "default": "base",
      "description": "\"base\" (default) or \"ethereum\"."
    },
    "wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "The wallet to report on, e.g. 0x6847231bD28E16A0A57c59793f6B8BD8CC0043aC."
    },
    "include_csv": {
      "type": "boolean",
      "default": false,
      "description": "Also return the rows as CSV text, ready for a spreadsheet or a CPA."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "include": {
      "type": "array",
      "items": {
        "enum": [
          "alerts",
          "earnings",
          "ipos",
          "economy"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Sections to include: alerts (SEC red flags and insider buys), earnings, ipos, economy. Default: all four."
    },
    "tickers": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$"
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "A watchlist: SEC alerts and earnings only for these tickers. Default: the whole market."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "Your HTTPS endpoint. Each morning's briefing is POSTed to it as JSON, signed (see `verify`). It must answer a test ping with 2xx, or you are not charged."
    },
    "delivery_hour_utc": {
      "type": "integer",
      "default": 11,
      "maximum": 23,
      "minimum": 0,
      "description": "The hour (UTC) the briefing is sent each day. Default 11 (7am New York, before the US market opens). The first one is sent within minutes of subscribing."
    },
    "renew_subscription_id": {
      "type": "string",
      "pattern": "^sub_[a-f0-9]{24}$",
      "description": "Extend this briefing subscription by 30 days instead of creating one (its webhook and settings stay)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "airflow"
  ],
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "mode": {
      "enum": [
        "cooling",
        "heating"
      ],
      "type": "string",
      "description": "When solving a state from loads: cooling (default) removes heat, heating adds it. Detected automatically when both states are given."
    },
    "units": {
      "enum": [
        "IP",
        "SI"
      ],
      "type": "string",
      "default": "IP",
      "description": "\"IP\" (°F, CFM, in, BTU) or \"SI\" (°C, L/s, mm, kW). Default IP. Applies to inputs and results."
    },
    "airflow": {
      "type": "number",
      "description": "Total airflow through the coil: CFM (IP) or L/s (SI).",
      "exclusiveMinimum": 0
    },
    "leaving": {
      "type": "object",
      "properties": {
        "grains": {
          "type": "number",
          "minimum": 0
        },
        "dry_bulb": {
          "type": "number"
        },
        "enthalpy": {
          "type": "number"
        },
        "wet_bulb": {
          "type": "number"
        },
        "dew_point": {
          "type": "number"
        },
        "humidity_ratio": {
          "type": "number",
          "minimum": 0
        },
        "relative_humidity": {
          "type": "number",
          "maximum": 100,
          "minimum": 0
        }
      },
      "description": "Air leaving the coil: two properties, like `entering`.",
      "additionalProperties": false
    },
    "entering": {
      "type": "object",
      "properties": {
        "grains": {
          "type": "number",
          "minimum": 0
        },
        "dry_bulb": {
          "type": "number"
        },
        "enthalpy": {
          "type": "number"
        },
        "wet_bulb": {
          "type": "number"
        },
        "dew_point": {
          "type": "number"
        },
        "humidity_ratio": {
          "type": "number",
          "minimum": 0
        },
        "relative_humidity": {
          "type": "number",
          "maximum": 100,
          "minimum": 0
        }
      },
      "description": "Air entering the coil: exactly two of dry_bulb, wet_bulb, dew_point, relative_humidity (%), humidity_ratio (lb/lb or g/kg), enthalpy (BTU/lb or kJ/kg), grains (gr/lb), in `units`. With outdoor_air and return_air but no outdoor air amount, it is the mixed air and the outdoor air % is back-calculated.",
      "additionalProperties": false
    },
    "elevation": {
      "type": "number",
      "default": 0,
      "maximum": 30000,
      "minimum": -1500,
      "description": "Site elevation, ft (IP) or m (SI); sets the atmospheric pressure. Default 0 (sea level)."
    },
    "return_air": {
      "type": "object",
      "properties": {
        "grains": {
          "type": "number",
          "minimum": 0
        },
        "dry_bulb": {
          "type": "number"
        },
        "enthalpy": {
          "type": "number"
        },
        "wet_bulb": {
          "type": "number"
        },
        "dew_point": {
          "type": "number"
        },
        "humidity_ratio": {
          "type": "number",
          "minimum": 0
        },
        "relative_humidity": {
          "type": "number",
          "maximum": 100,
          "minimum": 0
        }
      },
      "description": "Return air (two properties, like `entering`).",
      "additionalProperties": false
    },
    "latent_load": {
      "type": "number",
      "minimum": 0,
      "description": "Coil latent load, MBH or kW (default 0 when only sensible_load is given)."
    },
    "outdoor_air": {
      "type": "object",
      "properties": {
        "grains": {
          "type": "number",
          "minimum": 0
        },
        "dry_bulb": {
          "type": "number"
        },
        "enthalpy": {
          "type": "number"
        },
        "wet_bulb": {
          "type": "number"
        },
        "dew_point": {
          "type": "number"
        },
        "humidity_ratio": {
          "type": "number",
          "minimum": 0
        },
        "relative_humidity": {
          "type": "number",
          "maximum": 100,
          "minimum": 0
        }
      },
      "description": "Outdoor air (two properties, like `entering`), mixed with return_air ahead of the coil.",
      "additionalProperties": false
    },
    "sensible_load": {
      "type": "number",
      "minimum": 0,
      "description": "Coil sensible load, MBH (IP) or kW (SI): with one state, solves the other."
    },
    "outdoor_airflow": {
      "type": "number",
      "minimum": 0,
      "description": "Outdoor airflow, CFM or L/s (instead of outdoor_air_percent)."
    },
    "outdoor_air_percent": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "Outdoor air share of the total airflow, %."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "units": {
      "enum": [
        "IP",
        "SI"
      ],
      "type": "string",
      "default": "IP",
      "description": "\"IP\" (°F, CFM, in, BTU) or \"SI\" (°C, L/s, mm, kW). Default IP. Applies to inputs and results."
    },
    "width": {
      "type": "number",
      "description": "Rectangular width: in or mm. With height, the duct size; alone, a fixed side (e.g. a ceiling depth) the other side is solved for.",
      "exclusiveMinimum": 0
    },
    "height": {
      "type": "number",
      "description": "Rectangular height: in or mm.",
      "exclusiveMinimum": 0
    },
    "airflow": {
      "type": "number",
      "description": "Airflow: CFM (IP) or L/s (SI).",
      "exclusiveMinimum": 0
    },
    "diameter": {
      "type": "number",
      "description": "Round duct diameter: in (IP) or mm (SI).",
      "exclusiveMinimum": 0
    },
    "velocity": {
      "type": "number",
      "description": "Air velocity: FPM (IP) or m/s (SI).",
      "exclusiveMinimum": 0
    },
    "friction_rate": {
      "type": "number",
      "description": "Friction loss: in. w.g. per 100 ft (IP, typically 0.05-0.15) or Pa/m (SI, typically 0.4-1.2). With airflow, this is equal-friction sizing.",
      "exclusiveMinimum": 0
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "units": {
      "enum": [
        "IP",
        "SI"
      ],
      "type": "string",
      "default": "IP",
      "description": "\"IP\" (°F, CFM, in, BTU) or \"SI\" (°C, L/s, mm, kW). Default IP. Applies to inputs and results."
    },
    "grains": {
      "type": "number",
      "minimum": 0,
      "description": "Moisture in grains per lb dry air (gr/lb), in either unit system (7,000 gr = 1 lb)."
    },
    "dry_bulb": {
      "type": "number",
      "description": "Dry-bulb temperature, °F (IP) or °C (SI)."
    },
    "enthalpy": {
      "type": "number",
      "description": "Enthalpy: BTU per lb dry air (IP) or kJ/kg dry air (SI)."
    },
    "wet_bulb": {
      "type": "number",
      "description": "Wet-bulb temperature, °F or °C."
    },
    "dew_point": {
      "type": "number",
      "description": "Dew-point temperature, °F or °C."
    },
    "elevation": {
      "type": "number",
      "default": 0,
      "maximum": 30000,
      "minimum": -1500,
      "description": "Site elevation, ft (IP) or m (SI); sets the atmospheric pressure. Default 0 (sea level)."
    },
    "humidity_ratio": {
      "type": "number",
      "minimum": 0,
      "description": "Humidity ratio: lb water per lb dry air (IP, e.g. 0.0100) or g/kg (SI, e.g. 10.0)."
    },
    "relative_humidity": {
      "type": "number",
      "maximum": 100,
      "minimum": 0,
      "description": "Relative humidity, % (0-100)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 20,
      "minimum": 1,
      "description": "How many tokens to check, newest first (1-20, default 10). All new pools are counted either way."
    },
    "minutes": {
      "type": "integer",
      "default": 60,
      "maximum": 360,
      "minimum": 1,
      "description": "How far back to look, in minutes (1-360, default 60). Ignored when since_block is given."
    },
    "since_block": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Only pools created after this Base block: pass the previous answer's latest_block when polling (at most 6 hours back).",
      "exclusiveMinimum": 0
    },
    "hide_high_risk": {
      "type": "boolean",
      "default": false,
      "description": "Leave out tokens judged high_risk. Default false."
    },
    "min_liquidity_usd": {
      "type": "number",
      "default": 0,
      "minimum": 0,
      "description": "Leave out tokens with less measured liquidity than this (USD). Default 0."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "Person, company, vessel or aircraft name, e.g. \"Vladimir Putin\" or \"Rosneft\"."
    },
    "type": {
      "enum": [
        "individual",
        "entity",
        "vessel",
        "aircraft"
      ],
      "type": "string",
      "description": "Only this kind of listing: individual, entity, vessel or aircraft."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Most matches to return, best first (default 10)."
    },
    "country": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "Only listings with an address or nationality in this country, e.g. \"Iran\"."
    },
    "min_score": {
      "type": "integer",
      "default": 85,
      "maximum": 100,
      "minimum": 50,
      "description": "Lowest name-match score (0-100) to report. Default 85."
    },
    "crypto_address": {
      "type": "string",
      "maxLength": 120,
      "minLength": 20,
      "description": "A cryptocurrency address to check against the addresses OFAC lists (exact match), e.g. a Bitcoin or Ethereum address."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "urls"
  ],
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "mode": {
      "enum": [
        "main",
        "full"
      ],
      "type": "string",
      "default": "main",
      "description": "main (default): each page's article or main content only. full: whole pages, including navigation and footers."
    },
    "urls": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri",
        "maxLength": 2048
      },
      "maxItems": 5,
      "minItems": 2,
      "description": "2-5 different public http(s) URLs to read, e.g. [\"https://example.com/pricing\", \"https://example.com/docs\"]. Results come back in the same order."
    },
    "include_links": {
      "type": "boolean",
      "default": false,
      "description": "Also return each page's links as a list (url, text, internal). Default false."
    },
    "strip_link_urls": {
      "type": "boolean",
      "default": false,
      "description": "Write links as plain text in the Markdown (keeps the text, drops the URLs) to save tokens. Default false."
    },
    "max_chars_per_page": {
      "type": "integer",
      "default": 20000,
      "maximum": 50000,
      "minimum": 1000,
      "description": "Return at most this many characters of each page (1,000-50,000, default 20,000). Read the rest of a long page with scrape_markdown and its next_offset."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public http(s) URL to read: a web page, PDF, text, JSON or RSS/Atom feed, e.g. https://example.com/article."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "mode": {
      "enum": [
        "main",
        "full"
      ],
      "type": "string",
      "default": "main",
      "description": "main (default): the article or main content only. full: the whole page, including navigation and footers."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9007199254740991,
      "minimum": 0,
      "description": "Start at this character of the Markdown; pass the previous response's next_offset to read a long page in parts."
    },
    "max_chars": {
      "type": "integer",
      "default": 100000,
      "maximum": 100000,
      "minimum": 1000,
      "description": "Return at most this many characters (1,000-100,000, default 100,000)."
    },
    "include_links": {
      "type": "boolean",
      "default": false,
      "description": "Also return the page's links as a list (url, text, internal). Default false."
    },
    "strip_link_urls": {
      "type": "boolean",
      "default": false,
      "description": "Write links as plain text in the Markdown (keeps the text, drops the URLs) to save tokens. Default false."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "types": {
      "type": "array",
      "items": {
        "enum": [
          "bankruptcy",
          "restatement",
          "delisting_notice",
          "late_annual_report",
          "auditor_change",
          "cybersecurity_incident",
          "impairment",
          "debt_acceleration",
          "change_in_control",
          "late_quarterly_report",
          "insider_purchase",
          "leadership_change",
          "earnings",
          "material_agreement",
          "acquisition_or_disposal",
          "restructuring",
          "unregistered_share_sale"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Only these alert types: bankruptcy, restatement, delisting_notice, late_annual_report, auditor_change, cybersecurity_incident, impairment, debt_acceleration, change_in_control, late_quarterly_report, insider_purchase, leadership_change, earnings, material_agreement, acquisition_or_disposal, restructuring, unregistered_share_sale."
    },
    "levels": {
      "type": "array",
      "items": {
        "enum": [
          "red",
          "amber",
          "green",
          "info"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Only these levels (red, amber, green, info). Default: red, amber and green."
    },
    "tickers": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$"
      },
      "maxItems": 200,
      "minItems": 1,
      "description": "Watchlist: only alerts for these tickers. Default: the whole market."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "Your HTTPS endpoint. New alerts are POSTed to it as JSON, signed (see `verify`). It must answer a test ping with 2xx, or you are not charged."
    },
    "renew_subscription_id": {
      "type": "string",
      "pattern": "^sub_[a-f0-9]{24}$",
      "description": "Extend this subscription by 30 days instead of creating one (its webhook and filters stay)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "date": {
      "type": "string",
      "pattern": "^(?:\\d{4}-\\d{2}-\\d{2}|latest)$",
      "description": "The filing day (YYYY-MM-DD, US Eastern), or \"latest\" for the most recent day with releases (e.g. on a weekend). Default: today. EDGAR's live feed reaches back a few business days."
    },
    "limit": {
      "type": "integer",
      "default": 10,
      "maximum": 30,
      "minimum": 1,
      "description": "How many releases to read, newest first (1-30, default 10)."
    },
    "since": {
      "type": "string",
      "description": "Only releases EDGAR accepted after this time: pass the previous answer's `cursor` to get just the new ones."
    },
    "tickers": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$"
      },
      "maxItems": 200,
      "minItems": 1,
      "description": "A watchlist: only releases from these tickers. Default: every company."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "section"
  ],
  "properties": {
    "cik": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{1,10}$"
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "form": {
      "enum": [
        "10-K",
        "10-Q"
      ],
      "type": "string",
      "description": "Annual report (10-K, the default) or quarterly report (10-Q). With `accession_number`, taken from that filing."
    },
    "ticker": {
      "type": "string",
      "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$",
      "description": "US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`."
    },
    "company": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."
    },
    "section": {
      "enum": [
        "business",
        "risk_factors",
        "cybersecurity",
        "legal_proceedings",
        "mda",
        "market_risk"
      ],
      "type": "string",
      "description": "Which section to return: risk_factors, mda (Management's Discussion and Analysis), business, legal_proceedings, market_risk, or cybersecurity (10-K only, filings from late 2023 on)."
    },
    "fiscal_year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 2001,
      "description": "Return the report whose fiscal period ends in this calendar year instead of the latest one, e.g. 2022 for Apple's 10-K for the year ended September 24, 2022. For a 10-Q, the latest quarter ending in that year. EDGAR has HTML filings from 2001 on."
    },
    "accession_number": {
      "type": "string",
      "pattern": "^\\d{10}-\\d{2}-\\d{6}$",
      "description": "Return the section from this exact 10-K or 10-Q filing of the company, e.g. 0000320193-22-000108."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "sections"
  ],
  "properties": {
    "cik": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{1,10}$"
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "form": {
      "enum": [
        "10-K",
        "10-Q"
      ],
      "type": "string",
      "description": "Annual report (10-K, the default) or quarterly report (10-Q). With `accession_number`, taken from that filing."
    },
    "ticker": {
      "type": "string",
      "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$",
      "description": "US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`."
    },
    "company": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."
    },
    "sections": {
      "type": "array",
      "items": {
        "enum": [
          "business",
          "risk_factors",
          "cybersecurity",
          "legal_proceedings",
          "mda",
          "market_risk"
        ],
        "type": "string"
      },
      "maxItems": 3,
      "minItems": 2,
      "description": "2 or 3 sections to read from the same filing: risk_factors, mda, business, legal_proceedings, market_risk, cybersecurity. Business and cybersecurity exist only in 10-Ks."
    },
    "fiscal_year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 2001,
      "description": "Return the report whose fiscal period ends in this calendar year instead of the latest one, e.g. 2022 for Apple's 10-K for the year ended September 24, 2022. For a 10-Q, the latest quarter ending in that year. EDGAR has HTML filings from 2001 on."
    },
    "accession_number": {
      "type": "string",
      "pattern": "^\\d{10}-\\d{2}-\\d{6}$",
      "description": "Return the section from this exact 10-K or 10-Q filing of the company, e.g. 0000320193-22-000108."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cik": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{1,10}$"
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "limit": {
      "type": "integer",
      "default": 5,
      "maximum": 20,
      "minimum": 1,
      "description": "How many periods to return, newest first (1-20, default 5)."
    },
    "period": {
      "enum": [
        "annual",
        "quarterly"
      ],
      "type": "string",
      "default": "annual",
      "description": "Fiscal years from 10-Ks (annual, the default) or single quarters (quarterly)."
    },
    "ticker": {
      "type": "string",
      "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$",
      "description": "US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`."
    },
    "company": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."
    },
    "fiscal_year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 2001,
      "description": "Return periods up to this fiscal year (the calendar year the fiscal year ends in) instead of the latest, e.g. 2019."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "cik": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{1,10}$"
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "forms": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z0-9][A-Z0-9 ./-]{0,15}$"
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "Only these form types, e.g. [\"10-K\", \"10-Q\"] or [\"8-K\"], [\"S-1\"], [\"DEF 14A\"]. Default: all forms."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "How many documents to return, most relevant first (1-50, default 20)."
    },
    "query": {
      "type": "string",
      "maxLength": 500,
      "minLength": 2,
      "description": "What to search for in the filings' text. Put an exact phrase in double quotes, e.g. \"\\\"material weakness\\\"\" or \"\\\"going concern\\\" Nasdaq\"; words outside quotes must all appear."
    },
    "since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Only documents filed on or after this date (YYYY-MM-DD). Full-text search covers 2001 on."
    },
    "until": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Only documents filed on or before this date (YYYY-MM-DD)."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 9900,
      "minimum": 0,
      "description": "Skip this many results; pass the previous response's next_offset to page through more."
    },
    "ticker": {
      "type": "string",
      "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$",
      "description": "US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`."
    },
    "company": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cik": {
      "type": "string",
      "pattern": "^\\d{1,10}$",
      "description": "The manager's SEC CIK, e.g. 1067983 (Berkshire Hathaway)."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "fund": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "The investment manager or investor, e.g. \"Berkshire Hathaway\", \"Bridgewater\", \"Cathie Wood\" or \"Michael Burry\". Use this or `cik`."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 200,
      "minimum": 1,
      "description": "How many positions to list, largest first (1-200, default 25). Totals and changes always cover the whole portfolio."
    },
    "period": {
      "type": "string",
      "pattern": "^(?:latest|\\d{4}-\\d{2}-\\d{2}|\\d{4}-?Q[1-4])$",
      "description": "Which quarter: \"latest\" (default), a quarter-end date such as 2026-06-30, or 2026-Q2."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cik": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{1,10}$"
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "limit": {
      "type": "integer",
      "default": 15,
      "maximum": 40,
      "minimum": 1,
      "description": "How many Form 4 filings to return, newest first (1-40, default 15)."
    },
    "since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Only filings filed on or after this date (YYYY-MM-DD)."
    },
    "ticker": {
      "type": "string",
      "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$",
      "description": "US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`."
    },
    "company": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."
    },
    "transaction_codes": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z]$"
      },
      "minItems": 1,
      "description": "Only filings with these transaction codes, e.g. [\"P\"] for open-market purchases, [\"P\", \"S\"] for open-market buying and selling. Default: all filings."
    },
    "include_derivative": {
      "type": "boolean",
      "default": false,
      "description": "Also list derivative transactions (option and RSU grants, exercises, expirations). Default false."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "description": "Most filings to return, newest first (default 25)."
    },
    "since": {
      "type": "string",
      "description": "Only filings EDGAR accepted after this time: pass the previous answer's `cursor` to get just the new ones."
    },
    "spacs": {
      "enum": [
        "include",
        "exclude",
        "only"
      ],
      "type": "string",
      "default": "include",
      "description": "SPACs (blank-check \"Acquisition Corp\" shells): include (default), exclude or only."
    },
    "stages": {
      "type": "array",
      "items": {
        "enum": [
          "filed",
          "amended",
          "upsized",
          "priced"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Only these stages: filed (first S-1/F-1/S-11), amended (…/A), upsized (…MEF, just before pricing), priced (424B4 final prospectus). Default: all."
    },
    "include_public_companies": {
      "type": "boolean",
      "default": false,
      "description": "Also list registrations by companies that already trade (resale and follow-on offerings). Default false: IPOs only."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cik": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{1,10}$"
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "forms": {
      "type": "array",
      "items": {
        "enum": [
          "10-K",
          "10-Q",
          "8-K"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Which filings to list: 10-K (annual), 10-Q (quarterly), 8-K (material events). Default: all three."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d\\.\\d{2}$"
      },
      "minItems": 1,
      "description": "Only 8-Ks reporting any of these items, e.g. [\"2.02\"] for earnings, [\"5.02\"] for executive changes, [\"1.05\"] for cybersecurity incidents (words like \"earnings\" work too). Implies forms [\"8-K\"]."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "How many filings to return, newest first (1-50, default 20)."
    },
    "since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Only filings filed on or after this date (YYYY-MM-DD). Reaches back to 2001 for one company; the market-wide feed covers about the last few business days."
    },
    "ticker": {
      "type": "string",
      "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$",
      "description": "US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`; leave all three out for the latest filings of all companies."
    },
    "company": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "How many alerts to return, most serious first, then newest (1-50, default 20)."
    },
    "since": {
      "type": "string",
      "description": "Only alerts found after this time: pass the previous answer's `cursor` to get just what is new. Default: every alert in the store (about the last day)."
    },
    "types": {
      "type": "array",
      "items": {
        "enum": [
          "bankruptcy",
          "restatement",
          "delisting_notice",
          "late_annual_report",
          "auditor_change",
          "cybersecurity_incident",
          "impairment",
          "debt_acceleration",
          "change_in_control",
          "late_quarterly_report",
          "insider_purchase",
          "leadership_change",
          "earnings",
          "material_agreement",
          "acquisition_or_disposal",
          "restructuring",
          "unregistered_share_sale"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Only these alert types: bankruptcy, restatement, delisting_notice, late_annual_report, auditor_change, cybersecurity_incident, impairment, debt_acceleration, change_in_control, late_quarterly_report, insider_purchase, leadership_change, earnings, material_agreement, acquisition_or_disposal, restructuring, unregistered_share_sale. Default: all."
    },
    "levels": {
      "type": "array",
      "items": {
        "enum": [
          "red",
          "amber",
          "green",
          "info"
        ],
        "type": "string"
      },
      "minItems": 1,
      "description": "Only these levels: red (restatement, delisting, bankruptcy, late 10-K), amber, green (insider buying), info (earnings, leadership changes, deals). Default: all."
    },
    "tickers": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$"
      },
      "maxItems": 200,
      "minItems": 1,
      "description": "A watchlist: only alerts for these tickers. Default: the whole market."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "cik": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{1,10}$"
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d\\.\\d{2}$"
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "Only events reporting one of these 8-K items, e.g. [\"5.02\"] for executive and director changes, [\"2.02\"] for earnings releases, [\"1.01\", \"2.01\"] for deals, [\"1.05\"] for cybersecurity incidents."
    },
    "limit": {
      "type": "integer",
      "default": 5,
      "maximum": 10,
      "minimum": 1,
      "description": "How many events to return, newest first (1-10, default 5)."
    },
    "since": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Only events filed on or after this date (YYYY-MM-DD)."
    },
    "ticker": {
      "type": "string",
      "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$",
      "description": "US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`."
    },
    "company": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."
    },
    "accession_number": {
      "type": "string",
      "pattern": "^\\d{10}-\\d{2}-\\d{6}$",
      "description": "Return only this 8-K, e.g. one found with the free sec_list_filings tool."
    },
    "include_exhibits": {
      "type": "boolean",
      "default": true,
      "description": "Include the text of press-release exhibits (EX-99), e.g. the earnings release. Default true."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "section"
  ],
  "properties": {
    "cik": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^\\d{1,10}$"
        },
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        }
      ],
      "description": "SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "ticker": {
      "type": "string",
      "pattern": "^[A-Z][A-Z0-9.\\-]{0,9}$",
      "description": "US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`."
    },
    "company": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."
    },
    "section": {
      "enum": [
        "business",
        "risk_factors",
        "cybersecurity",
        "legal_proceedings",
        "mda",
        "market_risk"
      ],
      "type": "string",
      "description": "Which 10-K section to compare: risk_factors, mda, business, legal_proceedings, market_risk or cybersecurity."
    },
    "fiscal_year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 2001,
      "description": "The newer report: the 10-K whose fiscal year ends in this year. Default: the latest 10-K."
    },
    "accession_number": {
      "type": "string",
      "pattern": "^\\d{10}-\\d{2}-\\d{6}$",
      "description": "The newer report as an exact 10-K filing, instead of `fiscal_year`."
    },
    "compare_to_fiscal_year": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 2001,
      "description": "The older report to compare against: the 10-K for this fiscal year. Default: the 10-K just before the newer one."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "The website, or any page on it, e.g. https://example.com. Its origin (scheme and host) is mapped."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "limit": {
      "type": "integer",
      "default": 200,
      "maximum": 1000,
      "minimum": 1,
      "description": "How many URLs to return (1-1,000, default 200)."
    },
    "search": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only URLs containing every word of this text (case-insensitive) in the URL, or in the title or lastmod when known, e.g. \"pricing\" or \"blog 2026\"."
    },
    "path_prefix": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Only URLs whose path starts with this, e.g. \"/blog/\" or \"/docs\"."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "num": {
      "type": "integer",
      "default": 8,
      "maximum": 10,
      "minimum": 1,
      "description": "How many results (1-10, default 8)."
    },
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "query": {
      "type": "string",
      "maxLength": 400,
      "minLength": 1,
      "description": "What to search for, e.g. \"best open-source vector database 2026\" or \"site:sec.gov Apple 10-K\"."
    },
    "country": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "Two-letter country for local results, e.g. us, gb, de. Default: us."
    },
    "language": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "Two-letter language code, e.g. en, de, fr."
    },
    "time_range": {
      "enum": [
        "day",
        "week",
        "month",
        "year"
      ],
      "type": "string",
      "description": "Only results from the past day, week, month or year (news, recent events)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "via": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional: the tool whose next_calls suggested this call (filled in for you)."
    },
    "read": {
      "type": "integer",
      "default": 3,
      "maximum": 3,
      "minimum": 1,
      "description": "How many of the top results to read as Markdown (1-3, default 3). Pages that cannot be read are skipped for the next result."
    },
    "query": {
      "type": "string",
      "maxLength": 400,
      "minLength": 1,
      "description": "What to search for, e.g. \"best open-source vector database 2026\" or \"site:sec.gov Apple 10-K\"."
    },
    "country": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "Two-letter country for local results, e.g. us, gb, de. Default: us."
    },
    "language": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "Two-letter language code, e.g. en, de, fr."
    },
    "time_range": {
      "enum": [
        "day",
        "week",
        "month",
        "year"
      ],
      "type": "string",
      "description": "Only results from the past day, week, month or year (news, recent events)."
    },
    "max_chars_per_page": {
      "type": "integer",
      "default": 8000,
      "maximum": 20000,
      "minimum": 500,
      "description": "Markdown characters per page (500-20000, default 8,000)."
    }
  },
  "additionalProperties": false
}