mcp server
company-intelligence
Exec comp benchmarking, say-on-pay risk, and governance cards for US public companies.
Description as published by the maintainer. Source
- version 0.1.0
- active
- evaluation
active — Registry entry last updated 2026-07-14. Dashed tags are derived by ZBS Index from the published description, not stated by the maintainer.
What this server can do
9 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.
benchmark_executive_pay(role, ticker, agent_token, fiscal_year)- Benchmark executive pay vs. disclosed peers using Velarion's canonical percentile data. Returns pay percentile, performance (TSR) percentile, P4P gap, and an alignment label based on canonical_metrics columns (ceo_percentile, tsr_percentile, p4p_gap). No LLM. role is currently CEO-only (only CEO percentile is pre-computed in canonical_metrics). Required: ticker.
compare_companies(tickers, agent_token, fiscal_year)- Compare multiple companies on pay, performance, and governance metrics. Returns a ranked table from Velarion's canonical_metrics — no LLM narrative invention. The data-based summary describes observed patterns in the returned data only. Out-of-coverage tickers are excluded (listed separately). Max 20 tickers. Required: tickers.
fulfill_paid_order(quote_id, agent_token)- Fulfill a paid custom quote by compiling and delivering its artifact. Ownership gate: you may only fulfill a quote your own agent account owns. (The REST buyer rail has always enforced this — routes.py:656 — and this tool did not, which meant any valid token could fulfill, and therefore download, an artifact somebody else had paid for. Latent while every token was owner-issued; a live artifact leak the moment self-serve issuance opened. Closed here.) Settlement gate (fail-closed): if the quote is priced and settlement is not verified on any rail, returns settlement_unverified — compile_and_deliver is NOT called. On verified settlement: calls compile_and_deliver (fulfillment.py:121) — the same path used by Danny and the agent bridge. No forked fulfillment logic. Required: quote_id.
generate_governance_alpha_card(year, ticker, agent_token)- Generate a Governance Alpha Card for a company. Composite deterministic card: pay alignment (Velarion's own P4P-style estimate, modeled on public proxy-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. Calls generate_alpha_card (lib/agent_merchant/compilers/governance_alpha_card.py:441) after confirming deliverability via evaluate_deliverability (deliverability.py:219), which includes the period-currency gate (_governance_alpha_card_period_gate at :312). FREE-TIER CAP: this is the free sample of a $100 marketplace product (GOVERNANCE-ALPHA-CARD, pricer.py:59). Each agent gets ALPHA_CARD_FREE_DAILY_CAP cards per UTC day; beyond that the tool returns free_tier_cap_reached with the purchase path. Unlimited free issuance of the paid anchor product is the contradiction the catalog's PRICE_INTEGRITY blocker named — the cap is what resolves it. Structured errors returned (not raised) for: - not_in_coverage: ticker unknown - not_deliverable: coverage too thin / stale period - free_tier_cap_reached: daily free allowance spent (buy it, or wait for 00:00 UTC) Required: ticker.
list_skus(agent_token, include_non_sellable)- List the Velarion catalog — every product an agent can see and (where APPROVED_SELLABLE) buy. Returns all APPROVED_SELLABLE SKUs with full detail by default (sku_id, name, price, currency, fulfillment type, latency, caveats, classification). Set include_non_sellable=true to also return NEEDS_OWNER_APPROVAL / UNSELLABLE / KILLED rows, each clearly tagged with its classification and blockers so inventory is never hidden — only de-prioritized. No price is fabricated: unverified prices are surfaced as-is with their classification, never quoted as billable.
lookup_company_compensation(ticker, agent_token, fiscal_year)- 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). All data sourced from Supabase production tables — no LLM, no invented values. Out-of-coverage tickers return a structured error (not_in_coverage). Required: ticker.
place_order(tickers, agent_token, product_type, scope_params, subject_ticker)- Place an order for a priced product — creates a quote you can pay and then fulfill. This is the missing middle of the buy path: price_product tells you what it costs, place_order creates the actual quote (owned by YOUR agent account), and fulfill_paid_order delivers it once settlement clears. Requires a token with the mcp:buy scope AND a Velarion commerce account — a self-serve token issued at POST /agent/v1/token/self-serve has both. CUSTOM-* cohort products (CUSTOM-PEER-COHORT / CUSTOM-SOP-WINDOW / CUSTOM-GOV-EXTENDED): the ticker list is the comparison cohort, capped at 15 distinct tickers (a 16th is a clean too_many_tickers rejection, never a silent truncation). The subject is the first in-coverage ticker unless subject_ticker names another cohort member. Returns quote_id, the price, and how to pay. Nothing is charged here. Required: product_type, tickers.
predict_say_on_pay_risk(ticker, agent_token, fiscal_year)- 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. No LLM — fully deterministic from canonical_metrics + say_on_pay data. Compilers: compile_sop_trend_phrase, compile_sop_peer_cohort_distribution, compile_governance_friction_summary (lib/agent_merchant/compilers/say_on_pay_risk.py). Required: ticker.
price_product(ticker, buyer_type, agent_token, product_type, scope_params)- Price a Velarion product. Handles EVERY catalog SKU in its real state. product_type may be a sku_id (e.g. "SKU-002") OR a custom_artifact_family (e.g. "peer_disclosure_custom_cohort"). Returns the row's classification and, when APPROVED_SELLABLE, the price a buyer is actually charged: - APPROVED_SELLABLE → proposed_price_cents + currency + fulfillment_type + latency + caveats. No price floor touches it (deleted 2026-07-14); the catalog/pricer anchor IS the billed price. - NEEDS_OWNER_APPROVAL → {status: "needs_owner_approval"} structurally — price is known but the row is pending Andy's approval flip. - UNSELLABLE / KILLED → structured error with the reason. custom_band families price via the profit-aware pricer (respecting MERCHANT_MIN_MARGIN); one_off_fixed SKUs price at the canonical catalog price_cents. No fabricated price is ever returned (price_verified gate enforced upstream in classify_sku). Required: product_type, ticker.
Last successful function declaration observed on . Source: https://velarion-scraper-production.up.railway.app/mcp. We list what the server declared; we do not call any of these functions.
Endpoint status observed on . Source: https://velarion-scraper-production.up.railway.app/mcp.
Signals
These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.
| Signal | Value | What it measures | Window | Observed | Source |
|---|---|---|---|---|---|
| Latest published version | 0.1.0 | Latest version string the maintainer published to the registry. | as of fetch | Model Context Protocol | |
| Registry record last updated | 2026-07-14 | When the registry record was last updated by its maintainer. | point in time | Model Context Protocol | |
| First listed in the MCP Registry | 2026-07-14 | Date this server was first published to the official MCP Registry. Not a usage or quality measure. | point in time | Model Context Protocol | |
| mcp tools declared | 9 tools | Number of functions the server itself declared when asked to list them. This is what the server offers an agent, not a measure of how well any of them work. | as of probe | velarion-scraper-production.up.railway.app | |
| mcp endpoint status | ok | The server listed 9 functions when asked. | as of probe | velarion-scraper-production.up.railway.app |
Where to get it
This record as data
Every field on this page, with its source and observation date, is in the catalog JSON. Fetch the whole kind at once instead of parsing this HTML.
GET /api/v1/entries/mcp_server.json