lookup_company_compensation
Look up executive compensation
Look up executive compensation for a company in Velarion's coverage universe.
Returns CEO/NEO total compensation, pay mix breakdown, and canonical metrics for the
requested fiscal year (latest available if omitted). Every figure comes from the
company's own disclosure and carries its citation.
Out-of-coverage tickers return a structured error (not_in_coverage).
輸入參數ticker必填agent_tokenfiscal_year
predict_say_on_pay_risk
Predict say-on-pay risk
Predict Say-on-Pay risk for a company using Velarion's deterministic risk compilers.
Returns trend phrase, peer cohort distribution note, governance friction summary, and
overall risk band, computed from disclosed vote results and compensation data.
輸入參數ticker必填agent_tokenfiscal_year
benchmark_executive_pay
Benchmark executive pay vs peers
Benchmark executive pay vs. disclosed peers using Velarion's canonical percentile data.
Returns pay percentile, performance (TSR) percentile, pay-for-performance gap, and an
alignment label.
role is CEO-only.
輸入參數roleticker必填agent_tokenfiscal_year
compare_companies
Compare companies on pay, performance, governance
Compare multiple companies on pay, performance, and governance metrics.
Returns a ranked table drawn from disclosed compensation, performance, and governance
data. The summary describes observed patterns in the returned data only.
Out-of-coverage tickers are excluded (listed separately). Max 20 tickers.
輸入參數tickers必填agent_tokenfiscal_year
generate_governance_alpha_card
Generate a governance alpha card
Generate a Governance Alpha Card for a company.
Composite deterministic card: pay alignment (Velarion's own P4P-style estimate, modeled
on public peer-advisory methodology concepts — not licensed ISS data), governance scorecard, SoP risk band,
peer quality, top risks/strengths. Requires the company to be in Velarion's coverage
universe with current-period data.
This tool was built as the free sample of the GOVERNANCE-ALPHA-CARD product. The owner
killed that product (chat, 2026-09-24, verbatim "kill 15 through 41 … keep those 3";
docs/orders/ORDER_20260924_NON_AD7_KILL.md), so there is no longer a paid card to sample
and no purchase path to offer. THE FREE TOOL STAYS (the order keeps every free page and
free tool; only the buy option goes). Each agent may draw a limited number of cards per
UTC day; beyond that the tool returns free_tier_cap_reached and nothing to buy.
Structured errors returned (not raised) for:
- not_in_coverage: ticker outside the covered universe
- not_deliverable: the company's current-period disclosure does not support a card
- free_tier_cap_reached: daily free allowance spent (wait for 00:00 UTC)
輸入參數yearticker必填agent_token
list_skus
List the product catalog
List the Velarion product catalog.
Returns every report this token can order with `place_order` under `sellable`, with full
detail (name, price, currency, delivery type, latency, caveats). Reports on sale but not
orderable over MCP are under `buy_on_web`, each with the `buy_url` a human buys it at. Set `include_non_sellable=true` to also return
products that are not currently on sale, each tagged with its status, so the full
range is visible. A product with no settled price is returned with its status rather
than a billable number.
輸入參數agent_tokeninclude_non_sellable
get_company_compensation
Executive compensation (free)
Free plan: executive compensation for a company in Velarion's covered universe.
Returns Summary Compensation Table components for named executive officers, fiscal
year 2022 forward, with a citation for each figure. No benchmark context, no
percentiles, no narrative analysis; those are in the paid product.
輸入參數ticker必填agent_tokenfiscal_year
get_director_compensation
Director compensation (free)
Free plan: non-employee director compensation and the board fee schedule.
Unpaid directors (executive directors who serve without director fees) are
listed separately from the paid table.
輸入參數ticker必填agent_tokenfiscal_year
get_disclosed_peer_group
Disclosed peer group (free)
Free plan: the company's own disclosed compensation peer group, most recent
fiscal year on file.
輸入參數ticker必填agent_token
get_say_on_pay_history
Say-on-pay vote history (free)
Free plan: say-on-pay vote history. Support percentages are calculated by
Velarion from disclosed vote counts (marked as such in the citation).
輸入參數ticker必填agent_token
get_ceo_pay_ratio
CEO pay ratio (free)
Free plan: the most recent disclosed CEO pay ratio.
輸入參數ticker必填agent_token
search_companies
Search companies (free)
Free plan: search Velarion's covered universe by company name or ticker.
Requires a query of at least two characters; returns at most 10 results.
輸入參數query必填agent_token