Spiral gives your agent every tool with one account. Browse the tools →

Codex · Finance

How to Use Fiscal.ai company profile in Codex

Returns a company’s descriptions, classification, listings, and peers. Use it to understand the business and distinguish its primary listing from other trading venues.

Prompts to try with Fiscal.ai company profile in Codex

Copy an example into Codex, or ask in your own words.

Use Fiscal.ai company profile for Microsoft on Nasdaq and build a research panel showing its business descriptions, secondary listings, and peers.

Fiscal.ai company profileCodex
Try asking
  • Use Fiscal.ai company profile 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 profile and tell me what changed since last week.

  • Check Fiscal.ai company profile and summarize what you find in three bullet points.

  • Pull the newest data from Fiscal.ai company profile and give me the result as a table.

How to set up Fiscal.ai company profile in Codex

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the hosted server
    codex mcp add spiral --url https://api.spiral.ai/mcp
  2. 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

  1. Send Codex this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

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

  1. Create an API key

    In the console, under API keys.

  2. Run Fiscal.ai company profile

    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/profile",
        "input": {
          "fscl": "<fscl>"
        }
      }'

Then paste one of the prompts above: Codex finds Fiscal.ai company profile on Spiral, shows the price and runs it.

Fiscal.ai company profile providers and prices

Spiral runs Fiscal.ai company profile through Alexandria. Open a card for today's price, with every fee included.

AlexandriaFinance
Fiscal.ai · Company profile
fiscal-ai/company/profile

What can you do with Fiscal.ai company profile 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.

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.

Review a company’s capital structure

Compare the listings in a company profile with the latest filing’s share-class breakdown before choosing a denominator for an internal analysis.

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.

Questions about Fiscal.ai company profile in Codex

Can Codex use Fiscal.ai company profile?

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Fiscal.ai company profile like any built-in tool.

How much does Fiscal.ai company profile 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 company profile in Codex?

No. Spiral runs Fiscal.ai company profile 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 profile in Codex?

About two minutes: add the hosted server, then sign in.

Does Codex wait while Fiscal.ai company profile runs?

Fiscal.ai company profile 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.

Get started

Start using Fiscal.ai company profile in Codex

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Codex:

Set up Codex

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options