Contract
input_schema.json
{
"type": "object",
"required": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"description": "Stock ticker symbol (e.g. 'AAPL')."
},
"exchange": {
"type": "string",
"description": "Stock exchange (e.g. 'NYSE', 'NASDAQ')."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"Metric": {
"type": "string",
"description": "Row label on the broad 'vs. The Competition' metrics table, e.g. 'Market Cap', 'P/E Ratio'. This row type also carries one value column per entity being compared (the requested company, its industry, its sector, and its exchange), each keyed by that entity's own name (e.g. 'Apple', 'Technology Sector', 'NASDAQ Exchange') rather than a fixed field name -- those per-request columns are not included in this shape because a fixed field map cannot name them for a different ticker; see verification.notes."
},
"Sector": {
"type": "string",
"description": "Sector name, on the fallback listing only; empty string for some ETF/fund rows."
},
"Company": {
"type": "string",
"description": "Company name for this row (e.g. 'Apple', 'Amazon.com'), on head-to-head comparison rows, the named competitors list, and the fallback listing."
},
"Neutral": {
"type": "string",
"description": "Media mention count, e.g. '35Neutral mention(s)'."
},
"Revenue": {
"type": "string",
"description": "Trailing revenue as an abbreviated dollar string."
},
"Negative": {
"type": "string",
"description": "Media mention count, e.g. '26Negative mention(s)'."
},
"Positive": {
"type": "string",
"description": "Media mention count, e.g. '70Positive mention(s)'."
},
"P/E Ratio": {
"type": "string",
"description": "P/E ratio as a plain numeric string, or 'N/A', on the named competitors list and the fallback listing."
},
"Market Cap": {
"type": "string",
"description": "Market capitalization as an abbreviated dollar string."
},
"MarketRank": {
"type": "string",
"description": "MarketBeat's own star-rating summary, e.g. '4.1301 of 5 stars'."
},
"Net Income": {
"type": "string",
"description": "Net income as an abbreviated dollar string."
},
"Buy Ratings": {
"type": "string",
"description": "Count of analyst Buy ratings."
},
"Net Margins": {
"type": "string",
"description": "Net profit margin as a percentage string, e.g. '27.62%'."
},
"Share Price": {
"type": "string",
"description": "Current share price and day change, e.g. '$336.13-0.3%'. A digit-heavy price string, not a phone number; see verification.notes."
},
"Hold Ratings": {
"type": "string",
"description": "Count of analyst Hold ratings."
},
"Indicator(s)": {
"type": "string",
"description": "Concatenated tags MarketBeat attaches to the company, e.g. 'Trending NewsAnalyst Forecast'."
},
"Rating Score": {
"type": "string",
"description": "Aggregate analyst rating score as a numeric string, e.g. '2.62'."
},
"Sell Ratings": {
"type": "string",
"description": "Count of analyst Sell ratings, e.g. '2Sell rating(s)'."
},
"Current Price": {
"type": "string",
"description": "Current share price and day change, on the fallback listing only, same format as Share Price; see verification.notes."
},
"Gross Revenue": {
"type": "string",
"description": "Trailing gross revenue as an abbreviated dollar string, e.g. '$466.82B'."
},
"Very Negative": {
"type": "string",
"description": "Media mention count, e.g. '9Very Negative mention(s)'."
},
"Very Positive": {
"type": "string",
"description": "Media mention count, e.g. '277Very Positive mention(s)'."
},
"Employee Count": {
"type": "string",
"description": "Reported employee count as a comma-grouped numeric string."
},
"Return on Assets": {
"type": "string",
"description": "ROA as a percentage string."
},
"Return on Equity": {
"type": "string",
"description": "ROE as a percentage string."
},
"Overall Sentiment": {
"type": "string",
"description": "Overall media sentiment label, e.g. 'Positive'."
},
"Price/Sales Ratio": {
"type": "string",
"description": "Price-to-sales ratio as a plain numeric string."
},
"Earnings Per Share": {
"type": "string",
"description": "Trailing EPS as a dollar string."
},
"Strong Buy Ratings": {
"type": "string",
"description": "Count of analyst Strong Buy ratings."
},
"1Y Price Performance": {
"type": "string",
"description": "One-year share price performance, e.g. '+41.0%'."
},
"Price/Earnings Ratio": {
"type": "string",
"description": "P/E ratio as a plain numeric string, on head-to-head valuation rows."
},
"Analysts' Price Target": {
"type": "string",
"description": "Consensus analyst price target and implied change, e.g. '$340.14+1.2%'; see verification.notes."
},
"Consensus Price Target": {
"type": "string",
"description": "Consensus price target and upside/downside, on the fallback listing only, e.g. '$340.14(1.2% Upside)', or 'N/A'; see verification.notes."
},
"Consensus Analyst Rating": {
"type": "string",
"description": "Consensus rating label and score, on the fallback listing only, e.g. 'Moderate Buy(Score: 2.62)', or 'N/A(Score: 0.00)'."
}
},
"additionalProperties": false
},
"description": "Rows for this comparison section; which fields are present depends on the section (see each field's own description)."
},
"category": {
"type": "string",
"description": "A natural-language question naming the two tickers being compared (e.g. 'Is AMZN or AAPL more profitable?'), or the label of a broader table (e.g. 'Apple Competitors List'). Empty string on the unrecognized-ticker fallback listing."
}
},
"additionalProperties": false
},
"description": "Comparison sections. On a real successful lookup (AAPL/NASDAQ) this held 18 items: several head-to-head questions against different named peers (profitability, valuation/earnings, media sentiment, analyst ratings), a metrics-vs-averages table, and a named competitors list. On an unrecognized ticker, this endpoint has been observed returning a single item with an empty category and a large general listing of well-known public companies instead of an error or an empty result (see usage.md) -- this is a real, documented alternate shape, not a fallback this tool hides from the customer."
}
},
"additionalProperties": false
},
"status": {
"type": "string",
"description": "'success' on both real calls observed, including the unrecognized-ticker case."
}
},
"description": "The competitor-comparison record, as returned at routing.responseResultPath ($.output).",
"additionalProperties": false
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.01365 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 23, 2026