Koskamo

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.

Velarion Company Intelligence MCP logo, by VelarionVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-06Operated by Velarion
MCP endpoint (Streamable HTTP)
https://api.velarion.ai/mcp
Vendor documentation

What its tools do

12 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

12 of 12 have a description · 12 of 12 declare behavior hints · 12 of 12 with parameters document them all

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

Vendor evidenceRegistry 0.2.2

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
Server-advertised capabilities
{
  "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.

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

12 advertised

lookup_company_compensation — Look up executive compensation
Advertised by the server during the last successful anonymous check.
Advertised read-only

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).

lookup_company_compensation input schema
{
  "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
}
lookup_company_compensation output schema
{
  "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"
    }
  }
}
lookup_company_compensation annotations
{
  "title": "Look up executive compensation",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
predict_say_on_pay_risk — Predict say-on-pay risk
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

predict_say_on_pay_risk input schema
{
  "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
}
predict_say_on_pay_risk output schema
{
  "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"
    }
  }
}
predict_say_on_pay_risk annotations
{
  "title": "Predict say-on-pay risk",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
benchmark_executive_pay — Benchmark executive pay vs peers
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

benchmark_executive_pay input schema
{
  "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
}
benchmark_executive_pay output schema
{
  "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"
    }
  }
}
benchmark_executive_pay annotations
{
  "title": "Benchmark executive pay vs peers",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
compare_companies — Compare companies on pay, performance, governance
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

compare_companies input schema
{
  "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
}
compare_companies output schema
{
  "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."
    }
  }
}
compare_companies annotations
{
  "title": "Compare companies on pay, performance, governance",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
generate_governance_alpha_card — Generate a governance alpha card
Advertised by the server during the last successful anonymous check.
Advertised read-only

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)

generate_governance_alpha_card input schema
{
  "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
}
generate_governance_alpha_card output schema
{
  "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"
    }
  }
}
generate_governance_alpha_card annotations
{
  "title": "Generate a governance alpha card",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
list_skus — List the product catalog
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

list_skus input schema
{
  "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
}
list_skus output schema
{
  "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"
      }
    }
  }
}
list_skus annotations
{
  "title": "List the product catalog",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_company_compensation — Executive compensation (free)
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_company_compensation input schema
{
  "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
}
get_company_compensation output schema
{
  "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"
      }
    }
  }
}
get_company_compensation annotations
{
  "title": "Executive compensation (free)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_director_compensation — Director compensation (free)
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_director_compensation input schema
{
  "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
}
get_director_compensation output schema
{
  "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"
      }
    }
  }
}
get_director_compensation annotations
{
  "title": "Director compensation (free)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_disclosed_peer_group — Disclosed peer group (free)
Advertised by the server during the last successful anonymous check.
Advertised read-only

Free plan: the company's own disclosed compensation peer group, most recent fiscal year on file.

get_disclosed_peer_group input schema
{
  "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
}
get_disclosed_peer_group output schema
{
  "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"
      }
    }
  }
}
get_disclosed_peer_group annotations
{
  "title": "Disclosed peer group (free)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_say_on_pay_history — Say-on-pay vote history (free)
Advertised by the server during the last successful anonymous check.
Advertised read-only

Free plan: say-on-pay vote history. Support percentages are calculated by Velarion from disclosed vote counts (marked as such in the citation).

get_say_on_pay_history input schema
{
  "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
}
get_say_on_pay_history output schema
{
  "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"
      }
    }
  }
}
get_say_on_pay_history annotations
{
  "title": "Say-on-pay vote history (free)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_ceo_pay_ratio — CEO pay ratio (free)
Advertised by the server during the last successful anonymous check.
Advertised read-only

Free plan: the most recent disclosed CEO pay ratio.

get_ceo_pay_ratio input schema
{
  "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
}
get_ceo_pay_ratio output schema
{
  "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"
      }
    }
  }
}
get_ceo_pay_ratio annotations
{
  "title": "CEO pay ratio (free)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_companies — Search companies (free)
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

search_companies input schema
{
  "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
}
search_companies output schema
{
  "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"
      }
    }
  }
}
search_companies annotations
{
  "title": "Search companies (free)",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

0 advertised

No prompt definitions available.

Resources

0 advertised

No resource definitions available.

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.

Too few checks for a percentage yet (2 of 2 answered).

  1. 2026-11-06: 1 of 1 checks answered
  2. 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.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http velarion-company-intelligence-mcp https://api.velarion.ai/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add velarion-company-intelligence-mcp --url https://api.velarion.ai/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable velarion-company-intelligence-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "velarion-company-intelligence-mcp": {
      "url": "https://api.velarion.ai/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "velarion-company-intelligence-mcp": {
      "type": "streamableHttp",
      "url": "https://api.velarion.ai/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start velarion-company-intelligence-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "velarion-company-intelligence-mcp": {
      "type": "http",
      "url": "https://api.velarion.ai/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http velarion-company-intelligence-mcp https://api.velarion.ai/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://api.velarion.ai/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "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.

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.

Claim this listing