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

Gemini CLI · Finance

How to Use Finnhub company profile in Gemini CLI

Finnhub returns a company's name, exchange, headquarters country, filing currency, IPO date, market capitalization, shares outstanding, website, logo, and industry. Use it to identify a listed company and add context to a stock watchlist.

Prompts to try with Finnhub company profile in Gemini CLI

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

Use Finnhub company profile for AAPL and populate the company details component in this project with the returned name, exchange, website, and logo.

Finnhub company profileGemini CLI
Try asking
  • Use Finnhub company profile for MSFT, GOOGL, and AMZN, then create a comparison table in this project showing headquarters country, filing currency, and Finnhub industry.

  • Use Finnhub company profile for NVDA and add its returned IPO date, market capitalization, and shares outstanding to the stock details view.

  • Use Finnhub company profile for KO and PEP, then replace the hardcoded company names and website links in the watchlist with the returned values.

  • Use Finnhub company profile for JPM, BAC, and WFC, then group the project's watchlist entries by the returned Finnhub industry labels.

How to set up Finnhub company profile in Gemini CLI

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

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI 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 Finnhub 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": "finnhub-gateway/companies/profile",
        "input": {
          "symbol": "<symbol>"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Finnhub company profile on Spiral, shows the price and runs it.

Finnhub company profile providers and prices

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

AlexandriaFinance
Finnhub · Company profile
finnhub-gateway/companies/profile

What can you do with Finnhub company profile in Gemini CLI?

Populate a stock watchlist with company names, exchanges, logos, and websites from Finnhub. A coding agent can use the returned profiles to replace hardcoded company details in your project.

Add company names to a watchlist

Turn a list of stock tickers into readable entries with company names, exchanges, websites, and logos.

Prepare a company reference brief

Collect a listed company's headquarters country, filing currency, IPO date, industry, market capitalization, and shares outstanding in one reference table.

Organize companies by industry

Group a chosen stock list using the industry labels returned by Finnhub.

Compare headquarters locations

Arrange a selected company list by headquarters country and show each listing exchange alongside it.

Check filing currencies before a comparison

Build a company-by-company table of filing currencies before preparing a financial comparison.

Review company reference changes

Recheck a watchlist's company names, exchanges, websites, and Finnhub industry labels, then flag differences from an earlier permitted snapshot.

Questions about Finnhub company profile in Gemini CLI

Can Gemini CLI use Finnhub company profile?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Finnhub company profile like any built-in tool.

How much does Finnhub company profile cost in Gemini CLI?

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

Do I need an Alexandria account to use Finnhub company profile in Gemini CLI?

No. Spiral runs Finnhub 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 Finnhub company profile in Gemini CLI?

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

Does Gemini CLI wait while Finnhub company profile runs?

Finnhub company profile runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

What company information does Finnhub return?

The profile includes company identity, listing details, IPO date, market capitalization, shares outstanding, website, logo, and Finnhub industry classification. It provides company reference information for a stock research brief.

Does the country describe where the stock trades?

Finnhub defines country as the company's headquarters country. The listing exchange appears separately, so use headquarters country when organizing companies geographically.

What does the profile's currency mean?

Finnhub defines it as the currency used in company filings. Label it as filing currency when comparing company profiles.

Which industry classification does Finnhub use?

The profile returns Finnhub's own industry classification. Keep that label when grouping companies so readers know which classification the comparison uses.

Will every company have a complete, verified profile?

Every property in Finnhub's documented response model is optional, including IPO date, market capitalization, and industry. Finnhub's terms also decline to guarantee data accuracy or completeness.

Get started

Start using Finnhub company profile in Gemini CLI

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

Paste this into Gemini CLI:

Set up Gemini CLI

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