How to Use Fiscal.ai company directory in Claude Code
Returns company records with primary listings and available datasets. Use it to build a research universe or find the right company before requesting detailed data.
Prompts to try with Fiscal.ai company directory in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Fiscal.ai company directory to find Microsoft, Apple, and Alphabet, then add their company identities and primary listings to this project’s company selector.
Use Fiscal.ai company directory to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Fiscal.ai company directory and tell me what changed since last week.
Check Fiscal.ai company directory and summarize what you find in three bullet points.
Pull the newest data from Fiscal.ai company directory and give me the result as a table.
How to set up Fiscal.ai company directory in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code 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 company directory
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/list", "input": { "compact": false } }'
Then paste one of the prompts above: Claude Code finds Fiscal.ai company directory on Spiral, shows the price and runs it.
Fiscal.ai company directory providers and prices
Spiral runs Fiscal.ai company directory through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Compact | on or off | Return a slimmer row: fewer descriptors per company, for when the list is only being used to resolve identifiers. | |
| Page number | a number | 1 | Page number, 1-indexed. |
Every API field of Fiscal.ai · Company directory is on its tool page: open its card above.
What can you do with Fiscal.ai company directory in Claude Code?
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.
Resolve company and listing identities
Find the company record behind a familiar business name, then inspect the primary and secondary listings before combining research from different trading venues.
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 company directory and Claude Code
Overview
Fiscal.ai company directory in other agents
Questions about Fiscal.ai company directory in Claude Code
Can Claude Code use Fiscal.ai company directory?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Fiscal.ai company directory like any built-in tool.
How much does Fiscal.ai company directory cost in Claude Code?
$0.013 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need an Alexandria account to use Fiscal.ai company directory in Claude Code?
No. Spiral runs Fiscal.ai company directory 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 company directory in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Fiscal.ai company directory runs?
Fiscal.ai company directory runs in the background. Claude Code 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 company directory in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


