How to Use Fiscal.ai segments and KPIs in Codex
Returns historical segment revenue, profit splits, and company-specific operating metrics where covered. Use it to examine business drivers that company descriptions and share counts cannot explain.
Prompts to try with Fiscal.ai segments and KPIs in Codex
Copy an example into Codex, or ask in your own words.
Use Fiscal.ai segments and KPIs for Boeing on the NYSE and add a table of available segment revenue, backlog, and deliveries to the research view.
Use Fiscal.ai segments and KPIs for Apple on Nasdaq and build an annual segment revenue chart from the returned history, keeping discontinued segments separate.
Use Fiscal.ai segments and KPIs to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Fiscal.ai segments and KPIs and tell me what changed since last week.
Check Fiscal.ai segments and KPIs and summarize what you find in three bullet points.
How to set up Fiscal.ai segments and KPIs in Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Fiscal.ai segments and KPIs
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "fiscal-ai/company/segments-and-kpis", "input": { "fscl": "<fscl>" } }'
Then paste one of the prompts above: Codex finds Fiscal.ai segments and KPIs on Spiral, shows the price and runs it.
Fiscal.ai segments and KPIs providers and prices
Spiral runs Fiscal.ai segments and KPIs through Alexandria. Open a card for today's price, with every fee included.
What can you do with Fiscal.ai segments and KPIs in Codex?
Build a company research view with business descriptions, operating histories, or filing-based share counts. A coding agent can turn the Fiscal.ai responses into tables and calculations in your project.
Prepare a company research brief
Find Microsoft in the directory, explain its business and peers, summarize available segment results, and add the latest reported share-class breakdown.
Build a peer comparison
Resolve a set of public companies, review their business descriptions, compare overlapping operating metrics, and show the share counts used in any per-share calculations.
Collect inputs for a valuation model
Match companies to listings, document their businesses, bring available segment histories into the model, and use the latest filing share counts for the per-share output.
Refresh an internal watchlist
Recheck company records, business descriptions, available operating results, and latest reported share counts for a defined list of public companies.
Study revenue concentration
Select public companies from the directory, read their business descriptions, and compare available segment revenue histories to identify reliance on particular operations.
Plan an operating-metric comparison
Check which companies advertise segment and KPI coverage, inspect the returned measures, and choose comparisons based on metrics the businesses actually report.
More on Fiscal.ai segments and KPIs and Codex
Overview
Fiscal.ai segments and KPIs in other agents
Questions about Fiscal.ai segments and KPIs in Codex
Can Codex use Fiscal.ai segments and KPIs?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Fiscal.ai segments and KPIs like any built-in tool.
How much does Fiscal.ai segments and KPIs cost in Codex?
$0.052377 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need an Alexandria account to use Fiscal.ai segments and KPIs in Codex?
No. Spiral runs Fiscal.ai segments and KPIs on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up Fiscal.ai segments and KPIs in Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while Fiscal.ai segments and KPIs runs?
Fiscal.ai segments and KPIs runs in the background. Codex starts the run, checks on it and gives you the json when it's ready.
Does Fiscal.ai provide operating KPIs for every company?
No. Its API documentation describes segment and KPI coverage as the largest 2,300 companies globally by market capitalization and explicitly notes incomplete coverage within regions.
How much segment and KPI history is documented?
Fiscal.ai documents 12 or more annual periods and 24 or more quarterly periods for segments and KPIs. Discontinued segments can remain in the historical data.
How many companies can a directory request return?
A directory page contains up to 1,000 company records. The final page contains the remainder, and the pagination response tells you whether another page exists.
Does a company’s presence guarantee every dataset is available?
No. The directory and profile list available datasets for each company, and a request for an unlisted dataset returns 404.
Are shares outstanding a live count or a historical series?
The endpoint returns a snapshot from the latest available company filing, including total shares and a share-class breakdown. It does not provide a historical share-count series.
Start using Fiscal.ai segments and KPIs in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


