Server definition
- Hash
- sha256:eeb97d75bb1a7ace9138215737b120ee1752000c9e7348809ea722dc7fd20bdc
- What it is
- What a remote MCP server returned when asked what it offers: 12 tools
The blob, as servednamed by its sha256
{
"instructions": "Velarion Company Intelligence — exec and board compensation data, governance analysis, and Say-on-Pay risk signals for ~2,965 public companies across 12 industries. All tools require a valid X-Velarion-Agent-Token. Coverage is limited to Velarion's live universe; out-of-coverage tickers return structured errors, never fabricated data.",
"tools": [
{
"description": "Benchmark executive pay vs. disclosed peers using Velarion's canonical percentile data.\n\nReturns pay percentile, performance (TSR) percentile, pay-for-performance gap, and an\nalignment label.\n\nrole is CEO-only.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
},
"role": {
"default": "CEO",
"description": "Optional executive role to benchmark (default CEO-only).",
"type": "string"
},
"ticker": {
"description": "The company's ticker symbol (e.g. \"AAPL\").",
"type": "string"
}
},
"required": [
"ticker"
],
"type": "object"
},
"name": "benchmark_executive_pay",
"outputSchema": {
"anyOf": [
{
"required": [
"ticker"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"alignment_label": {
"description": "Pay-for-performance alignment label.",
"type": "string"
},
"attribution": {
"description": "Source citation, dataset DOI, and a ready-made cite_as string.",
"type": "object"
},
"error": {
"type": "string"
},
"p4p_gap_percentile_points": {
"type": "number"
},
"pay_percentile": {
"type": "number"
},
"peer_rank_caveat": {
"type": "string"
},
"ticker": {
"type": "string"
},
"tsr_percentile": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Compare multiple companies on pay, performance, and governance metrics.\n\nReturns a ranked table drawn from disclosed compensation, performance, and governance\ndata. The summary describes observed patterns in the returned data only.\nOut-of-coverage tickers are excluded (listed separately). Max 20 tickers.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
},
"tickers": {
"description": "List of ticker symbols to compare (e.g. [\"AAPL\", \"MSFT\"]), max 20.",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"tickers"
],
"type": "object"
},
"name": "compare_companies",
"outputSchema": {
"anyOf": [
{
"required": [
"tickers"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"attribution": {
"description": "Source citation, dataset DOI, and a ready-made cite_as string.",
"type": "object"
},
"comparisons": {
"description": "Ranked pay/performance/governance table.",
"items": {
"type": "object"
},
"type": "array"
},
"error": {
"type": "string"
},
"tickers": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Generate a Governance Alpha Card for a company.\n\nComposite deterministic card: pay alignment (Velarion's own P4P-style estimate, modeled\non public peer-advisory methodology concepts — not licensed ISS data), governance scorecard, SoP risk band,\npeer quality, top risks/strengths. Requires the company to be in Velarion's coverage\nuniverse with current-period data.\n\nThis tool was built as the free sample of the GOVERNANCE-ALPHA-CARD product. The owner\nkilled that product (chat, 2026-09-24, verbatim \"kill 15 through 41 … keep those 3\";\ndocs/orders/ORDER_20260924_NON_AD7_KILL.md), so there is no longer a paid card to sample\nand no purchase path to offer. THE FREE TOOL STAYS (the order keeps every free page and\nfree tool; only the buy option goes). Each agent may draw a limited number of cards per\nUTC day; beyond that the tool returns free_tier_cap_reached and nothing to buy.\n\nStructured errors returned (not raised) for:\n- not_in_coverage: ticker outside the covered universe\n- not_deliverable: the company's current-period disclosure does not support a card\n- free_tier_cap_reached: daily free allowance spent (wait for 00:00 UTC)",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"ticker": {
"description": "The company's ticker symbol (e.g. \"AAPL\").",
"type": "string"
},
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
}
},
"required": [
"ticker"
],
"type": "object"
},
"name": "generate_governance_alpha_card",
"outputSchema": {
"anyOf": [
{
"required": [
"ticker"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"attribution": {
"description": "Source citation, dataset DOI, and a ready-made cite_as string.",
"type": "object"
},
"error": {
"type": "string"
},
"governance_scorecard": {
"type": "object"
},
"risk_band": {
"type": "string"
},
"status": {
"description": "e.g. deliverable, free_tier_cap_reached.",
"type": "string"
},
"ticker": {
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Free plan: the most recent disclosed CEO pay ratio.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"ticker": {
"description": "The company's ticker symbol (e.g. \"AAPL\").",
"type": "string"
}
},
"required": [
"ticker"
],
"type": "object"
},
"name": "get_ceo_pay_ratio",
"outputSchema": {
"properties": {
"attribution": {
"properties": {
"cite_as": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"dataset_doi": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"reuse_terms": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"type": "object"
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"citation": {
"additionalProperties": true,
"type": "object"
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"directors": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"error": {
"type": "string"
},
"executives": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"fee_schedule": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"items": {
"type": "integer"
},
"type": "array"
},
"hold": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"industry": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"peers": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"say_on_pay_exempt": {
"type": "boolean"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"unpaid_directors": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"attribution"
],
"type": "object"
}
},
{
"description": "Free plan: executive compensation for a company in Velarion's covered universe.\n\nReturns Summary Compensation Table components for named executive officers, fiscal\nyear 2022 forward, with a citation for each figure. No benchmark context, no\npercentiles, no narrative analysis; those are in the paid product.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
},
"ticker": {
"description": "The company's ticker symbol (e.g. \"AAPL\").",
"type": "string"
}
},
"required": [
"ticker"
],
"type": "object"
},
"name": "get_company_compensation",
"outputSchema": {
"properties": {
"attribution": {
"properties": {
"cite_as": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"dataset_doi": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"reuse_terms": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"type": "object"
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"citation": {
"additionalProperties": true,
"type": "object"
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"directors": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"error": {
"type": "string"
},
"executives": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"fee_schedule": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"items": {
"type": "integer"
},
"type": "array"
},
"hold": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"industry": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"peers": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"say_on_pay_exempt": {
"type": "boolean"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"unpaid_directors": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"attribution"
],
"type": "object"
}
},
{
"description": "Free plan: non-employee director compensation and the board fee schedule.\n\nUnpaid directors (executive directors who serve without director fees) are\nlisted separately from the paid table.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
},
"ticker": {
"description": "The company's ticker symbol (e.g. \"AAPL\").",
"type": "string"
}
},
"required": [
"ticker"
],
"type": "object"
},
"name": "get_director_compensation",
"outputSchema": {
"properties": {
"attribution": {
"properties": {
"cite_as": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"dataset_doi": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"reuse_terms": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"type": "object"
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"citation": {
"additionalProperties": true,
"type": "object"
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"directors": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"error": {
"type": "string"
},
"executives": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"fee_schedule": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"items": {
"type": "integer"
},
"type": "array"
},
"hold": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"industry": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"peers": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"say_on_pay_exempt": {
"type": "boolean"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"unpaid_directors": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"attribution"
],
"type": "object"
}
},
{
"description": "Free plan: the company's own disclosed compensation peer group, most recent\nfiscal year on file.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"ticker": {
"description": "The company's ticker symbol (e.g. \"AAPL\").",
"type": "string"
}
},
"required": [
"ticker"
],
"type": "object"
},
"name": "get_disclosed_peer_group",
"outputSchema": {
"properties": {
"attribution": {
"properties": {
"cite_as": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"dataset_doi": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"reuse_terms": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"type": "object"
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"citation": {
"additionalProperties": true,
"type": "object"
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"directors": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"error": {
"type": "string"
},
"executives": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"fee_schedule": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"items": {
"type": "integer"
},
"type": "array"
},
"hold": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"industry": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"peers": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"say_on_pay_exempt": {
"type": "boolean"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"unpaid_directors": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"attribution"
],
"type": "object"
}
},
{
"description": "Free plan: say-on-pay vote history. Support percentages are calculated by\nVelarion from disclosed vote counts (marked as such in the citation).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"ticker": {
"description": "The company's ticker symbol (e.g. \"AAPL\").",
"type": "string"
}
},
"required": [
"ticker"
],
"type": "object"
},
"name": "get_say_on_pay_history",
"outputSchema": {
"properties": {
"attribution": {
"properties": {
"cite_as": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"dataset_doi": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"reuse_terms": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"type": "object"
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"citation": {
"additionalProperties": true,
"type": "object"
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"directors": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"error": {
"type": "string"
},
"executives": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"fee_schedule": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"items": {
"type": "integer"
},
"type": "array"
},
"hold": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"industry": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"peers": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"say_on_pay_exempt": {
"type": "boolean"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"unpaid_directors": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"attribution"
],
"type": "object"
}
},
{
"description": "List the Velarion product catalog.\n\nReturns every available report with full detail by default (name, price, currency,\ndelivery type, latency, caveats). Set `include_non_sellable=true` to also return\nproducts that are not currently on sale, each tagged with its status, so the full\nrange is visible. A product with no settled price is returned with its status rather\nthan a billable number.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"include_non_sellable": {
"default": false,
"description": "Also return products that are not currently on sale.",
"type": "boolean"
}
},
"type": "object"
},
"name": "list_skus",
"outputSchema": {
"properties": {
"attribution": {
"description": "Source citation, dataset DOI, and a ready-made cite_as string.",
"type": "object"
},
"counts": {
"type": "object"
},
"error": {
"type": "string"
},
"non_sellable": {
"items": {
"type": "object"
},
"type": "array"
},
"sellable": {
"description": "Products currently on sale.",
"items": {
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Look up executive compensation for a company in Velarion's coverage universe.\n\nReturns CEO/NEO total compensation, pay mix breakdown, and canonical metrics for the\nrequested fiscal year (latest available if omitted). Every figure comes from the\ncompany's own disclosure and carries its citation.\n\nOut-of-coverage tickers return a structured error (not_in_coverage).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
},
"ticker": {
"description": "The company's ticker symbol (e.g. \"AAPL\").",
"type": "string"
}
},
"required": [
"ticker"
],
"type": "object"
},
"name": "lookup_company_compensation",
"outputSchema": {
"anyOf": [
{
"required": [
"ticker"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"attribution": {
"description": "Source citation, dataset DOI, and a ready-made cite_as string.",
"type": "object"
},
"ceo_percentile": {
"type": "number"
},
"company_name": {
"type": "string"
},
"error": {
"type": "string"
},
"executives": {
"description": "Named executive officers with SCT pay components.",
"items": {
"type": "object"
},
"type": "array"
},
"fiscal_year": {
"type": "integer"
},
"p4p_gap": {
"type": "number"
},
"ticker": {
"type": "string"
},
"tsr_percentile": {
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Predict Say-on-Pay risk for a company using Velarion's deterministic risk compilers.\n\nReturns trend phrase, peer cohort distribution note, governance friction summary, and\noverall risk band, computed from disclosed vote results and compensation data.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
},
"ticker": {
"description": "The company's ticker symbol (e.g. \"AAPL\").",
"type": "string"
}
},
"required": [
"ticker"
],
"type": "object"
},
"name": "predict_say_on_pay_risk",
"outputSchema": {
"anyOf": [
{
"required": [
"ticker"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"attribution": {
"description": "Source citation, dataset DOI, and a ready-made cite_as string.",
"type": "object"
},
"error": {
"type": "string"
},
"fiscal_year": {
"type": "integer"
},
"risk_band": {
"description": "Overall say-on-pay risk band.",
"type": "string"
},
"ticker": {
"type": "string"
},
"trend": {
"description": "Trend phrase for the vote history.",
"type": "string"
}
},
"type": "object"
}
},
{
"description": "Free plan: search Velarion's covered universe by company name or ticker.\nRequires a query of at least two characters; returns at most 10 results.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"agent_token": {
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header.",
"type": "string"
},
"query": {
"description": "Company name or ticker fragment, at least 2 characters (e.g. \"apple\").",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "search_companies",
"outputSchema": {
"properties": {
"attribution": {
"properties": {
"cite_as": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"dataset_doi": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"reuse_terms": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"type": "object"
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"citation": {
"additionalProperties": true,
"type": "object"
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"directors": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"error": {
"type": "string"
},
"executives": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"fee_schedule": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"items": {
"type": "integer"
},
"type": "array"
},
"hold": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
]
},
"industry": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"peers": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"results": {
"items": {
"additionalProperties": true,
"type": "object"
},
"type": "array"
},
"say_on_pay_exempt": {
"type": "boolean"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"unpaid_directors": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"attribution"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:eeb97d75bb1a7ace9138215737b120ee1752000c9e7348809ea722dc7fd20bdc | sha256sum