Velarion Company Intelligence MCP
Provides an MCP server interface to access cited executive and director compensation data for approximately 3,000 US public companies, allowing agents to retrieve pay ratios, say-on-pay votes, and detailed compensation figures with source citations.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://api.velarion.ai/mcpWhat its tools do
12 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to velarion.ai ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Retrieve CEO pay ratios for US public companies
- Access cited executive and director compensation data
- Analyze say-on-pay vote outcomes and related grants
Source and maintenance
Protocol and capabilities
- Server
- velarion-mcp 3.3.1
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 12 advertised
- Resources
- 0 advertised
- Resource templates
- 0 advertised
- Prompts
- 0 advertised
{
"tools": {
"listChanged": true
},
"logging": {},
"prompts": {
"listChanged": true
},
"resources": {
"subscribe": false,
"listChanged": true
},
"extensions": {
"io.modelcontextprotocol/ui": {}
},
"experimental": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
12 advertised
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).
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"description": "The company's ticker symbol (e.g. \"AAPL\")."
},
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
}
},
"additionalProperties": false
}{
"type": "object",
"anyOf": [
{
"required": [
"ticker"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string"
},
"ticker": {
"type": "string"
},
"p4p_gap": {
"type": "number"
},
"executives": {
"type": "array",
"items": {
"type": "object"
},
"description": "Named executive officers with SCT pay components."
},
"attribution": {
"type": "object",
"description": "Source citation, dataset DOI, and a ready-made cite_as string."
},
"fiscal_year": {
"type": "integer"
},
"company_name": {
"type": "string"
},
"ceo_percentile": {
"type": "number"
},
"tsr_percentile": {
"type": "number"
}
}
}{
"title": "Look up executive compensation",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"description": "The company's ticker symbol (e.g. \"AAPL\")."
},
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
}
},
"additionalProperties": false
}{
"type": "object",
"anyOf": [
{
"required": [
"ticker"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string"
},
"trend": {
"type": "string",
"description": "Trend phrase for the vote history."
},
"ticker": {
"type": "string"
},
"risk_band": {
"type": "string",
"description": "Overall say-on-pay risk band."
},
"attribution": {
"type": "object",
"description": "Source citation, dataset DOI, and a ready-made cite_as string."
},
"fiscal_year": {
"type": "integer"
}
}
}{
"title": "Predict say-on-pay risk",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"role": {
"type": "string",
"default": "CEO",
"description": "Optional executive role to benchmark (default CEO-only)."
},
"ticker": {
"type": "string",
"description": "The company's ticker symbol (e.g. \"AAPL\")."
},
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
}
},
"additionalProperties": false
}{
"type": "object",
"anyOf": [
{
"required": [
"ticker"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string"
},
"ticker": {
"type": "string"
},
"attribution": {
"type": "object",
"description": "Source citation, dataset DOI, and a ready-made cite_as string."
},
"pay_percentile": {
"type": "number"
},
"tsr_percentile": {
"type": "number"
},
"alignment_label": {
"type": "string",
"description": "Pay-for-performance alignment label."
},
"peer_rank_caveat": {
"type": "string"
},
"p4p_gap_percentile_points": {
"type": "number"
}
}
}{
"title": "Benchmark executive pay vs peers",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"tickers"
],
"properties": {
"tickers": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of ticker symbols to compare (e.g. [\"AAPL\", \"MSFT\"]), max 20."
},
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
}
},
"additionalProperties": false
}{
"type": "object",
"anyOf": [
{
"required": [
"tickers"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string"
},
"tickers": {
"type": "array",
"items": {
"type": "string"
}
},
"attribution": {
"type": "object",
"description": "Source citation, dataset DOI, and a ready-made cite_as string."
},
"comparisons": {
"type": "array",
"items": {
"type": "object"
},
"description": "Ranked pay/performance/governance table."
}
}
}{
"title": "Compare companies on pay, performance, governance",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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)
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
},
"ticker": {
"type": "string",
"description": "The company's ticker symbol (e.g. \"AAPL\")."
},
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
}
},
"additionalProperties": false
}{
"type": "object",
"anyOf": [
{
"required": [
"ticker"
]
},
{
"required": [
"error"
]
},
{
"required": [
"status"
]
}
],
"properties": {
"error": {
"type": "string"
},
"status": {
"type": "string",
"description": "e.g. deliverable, free_tier_cap_reached."
},
"ticker": {
"type": "string"
},
"risk_band": {
"type": "string"
},
"attribution": {
"type": "object",
"description": "Source citation, dataset DOI, and a ready-made cite_as string."
},
"governance_scorecard": {
"type": "object"
}
}
}{
"title": "Generate a governance alpha card",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"properties": {
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
},
"include_non_sellable": {
"type": "boolean",
"default": false,
"description": "Also return products that are not currently on sale."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"error": {
"type": "string"
},
"counts": {
"type": "object"
},
"sellable": {
"type": "array",
"items": {
"type": "object"
},
"description": "Products this token can order with place_order."
},
"buy_on_web": {
"type": "array",
"items": {
"type": "object"
},
"description": "Products on sale but not orderable over MCP, each with the buy_url a human buys it at."
},
"attribution": {
"type": "object",
"description": "Source citation, dataset DOI, and a ready-made cite_as string."
},
"non_sellable": {
"type": "array",
"items": {
"type": "object"
}
}
}
}{
"title": "List the product catalog",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"description": "The company's ticker symbol (e.g. \"AAPL\")."
},
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"attribution"
],
"properties": {
"hold": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"error": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"peers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"citation": {
"type": "object",
"additionalProperties": true
},
"industry": {
"type": "string"
},
"directors": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"truncated": {
"type": "boolean"
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"executives": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"attribution": {
"type": "object",
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"properties": {
"source": {
"type": "string"
},
"cite_as": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"dataset_doi": {
"type": "string"
},
"reuse_terms": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"fee_schedule": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unpaid_directors": {
"type": "array",
"items": {
"type": "string"
}
},
"say_on_pay_exempt": {
"type": "boolean"
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"type": "array",
"items": {
"type": "integer"
}
}
}
}{
"title": "Executive compensation (free)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"description": "The company's ticker symbol (e.g. \"AAPL\")."
},
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional fiscal year to read (e.g. 2025). Defaults to the latest on file."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"attribution"
],
"properties": {
"hold": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"error": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"peers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"citation": {
"type": "object",
"additionalProperties": true
},
"industry": {
"type": "string"
},
"directors": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"truncated": {
"type": "boolean"
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"executives": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"attribution": {
"type": "object",
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"properties": {
"source": {
"type": "string"
},
"cite_as": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"dataset_doi": {
"type": "string"
},
"reuse_terms": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"fee_schedule": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unpaid_directors": {
"type": "array",
"items": {
"type": "string"
}
},
"say_on_pay_exempt": {
"type": "boolean"
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"type": "array",
"items": {
"type": "integer"
}
}
}
}{
"title": "Director compensation (free)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_disclosed_peer_group — Disclosed peer group (free)
Free plan: the company's own disclosed compensation peer group, most recent fiscal year on file.
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"description": "The company's ticker symbol (e.g. \"AAPL\")."
},
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"attribution"
],
"properties": {
"hold": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"error": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"peers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"citation": {
"type": "object",
"additionalProperties": true
},
"industry": {
"type": "string"
},
"directors": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"truncated": {
"type": "boolean"
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"executives": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"attribution": {
"type": "object",
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"properties": {
"source": {
"type": "string"
},
"cite_as": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"dataset_doi": {
"type": "string"
},
"reuse_terms": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"fee_schedule": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unpaid_directors": {
"type": "array",
"items": {
"type": "string"
}
},
"say_on_pay_exempt": {
"type": "boolean"
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"type": "array",
"items": {
"type": "integer"
}
}
}
}{
"title": "Disclosed peer group (free)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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).
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"description": "The company's ticker symbol (e.g. \"AAPL\")."
},
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"attribution"
],
"properties": {
"hold": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"error": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"peers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"citation": {
"type": "object",
"additionalProperties": true
},
"industry": {
"type": "string"
},
"directors": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"truncated": {
"type": "boolean"
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"executives": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"attribution": {
"type": "object",
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"properties": {
"source": {
"type": "string"
},
"cite_as": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"dataset_doi": {
"type": "string"
},
"reuse_terms": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"fee_schedule": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unpaid_directors": {
"type": "array",
"items": {
"type": "string"
}
},
"say_on_pay_exempt": {
"type": "boolean"
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"type": "array",
"items": {
"type": "integer"
}
}
}
}{
"title": "Say-on-pay vote history (free)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_ceo_pay_ratio — CEO pay ratio (free)
Free plan: the most recent disclosed CEO pay ratio.
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"description": "The company's ticker symbol (e.g. \"AAPL\")."
},
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"attribution"
],
"properties": {
"hold": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"error": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"peers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"citation": {
"type": "object",
"additionalProperties": true
},
"industry": {
"type": "string"
},
"directors": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"truncated": {
"type": "boolean"
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"executives": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"attribution": {
"type": "object",
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"properties": {
"source": {
"type": "string"
},
"cite_as": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"dataset_doi": {
"type": "string"
},
"reuse_terms": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"fee_schedule": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unpaid_directors": {
"type": "array",
"items": {
"type": "string"
}
},
"say_on_pay_exempt": {
"type": "boolean"
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"type": "array",
"items": {
"type": "integer"
}
}
}
}{
"title": "CEO pay ratio (free)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Company name or ticker fragment, at least 2 characters (e.g. \"apple\")."
},
"agent_token": {
"type": "string",
"default": "",
"description": "Optional Velarion agent token; falls back to the X-Velarion-Agent-Token header."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"attribution"
],
"properties": {
"hold": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"error": {
"type": "string"
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"peers": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"query": {
"type": "string"
},
"ratio": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reason": {
"type": "string"
},
"status": {
"type": "string"
},
"ticker": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"citation": {
"type": "object",
"additionalProperties": true
},
"industry": {
"type": "string"
},
"directors": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"truncated": {
"type": "boolean"
},
"data_as_of": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"executives": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"attribution": {
"type": "object",
"required": [
"source",
"company_page",
"dataset_doi",
"doi_url",
"cite_as",
"filings",
"reuse_terms"
],
"properties": {
"source": {
"type": "string"
},
"cite_as": {
"type": "string"
},
"doi_url": {
"type": "string"
},
"filings": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"dataset_doi": {
"type": "string"
},
"reuse_terms": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
}
},
"fiscal_year": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"company_name": {
"type": "string"
},
"company_page": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"fee_schedule": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
]
},
"ceo_total_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"unpaid_directors": {
"type": "array",
"items": {
"type": "string"
}
},
"say_on_pay_exempt": {
"type": "boolean"
},
"median_employee_comp": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"fiscal_years_available": {
"type": "array",
"items": {
"type": "integer"
}
}
}
}{
"title": "Search companies (free)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
0 advertised
Resources
0 advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-06: 1 of 1 checks answered
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 807 ms
- 95th percentile latency
- 807 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 807 ms · metadata changed · 12 tool(s), 0 resource(s), 0 resource template(s), 0 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http velarion-company-intelligence-mcp https://api.velarion.ai/mcpCodex
codex mcp add velarion-company-intelligence-mcp --url https://api.velarion.ai/mcpCursor
{
"mcpServers": {
"velarion-company-intelligence-mcp": {
"url": "https://api.velarion.ai/mcp"
}
}
}Cline
{
"mcpServers": {
"velarion-company-intelligence-mcp": {
"type": "streamableHttp",
"url": "https://api.velarion.ai/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"velarion-company-intelligence-mcp": {
"type": "http",
"url": "https://api.velarion.ai/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http velarion-company-intelligence-mcp https://api.velarion.ai/mcpClaude Desktop
https://api.velarion.ai/mcpWindsurf
{
"mcpServers": {
"velarion-company-intelligence-mcp": {
"serverUrl": "https://api.velarion.ai/mcp"
}
}
}Let your agent find its tools
Find servers like Velarion Company Intelligence MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other data and analytics servers
Do you run Velarion Company Intelligence MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.