# Google Finance

import ToolInfo from "@/app/_components/tool-info";
import Badges from "@/app/_components/badges";
import TabbedCodeBlock from "@/app/_components/tabbed-code-block";
import TableOfContents from "@/app/_components/table-of-contents";
import ToolFooter from "@/app/_components/tool-footer";
import { Callout } from "nextra/components";

<ToolInfo
  description="Empower your agents to retrieve stock data using Arcade."
  author="Arcade"
  authType="API Key"
  versions={["0.1.0"]}
/>

<Badges repo="arcadeai/arcade-google-finance" />

The Arcade Google Finance MCP Sever lets you fetch real-time and historical stock data with ease. Use these tools to build intelligent agents and applications that fetch:

- Stock summary data.
- Historical stock data.

## Available Tools

<TableOfContents
  headers={["Tool Name", "Description"]}
  data={[
    [
      "GoogleFinance.GetStockSummary",
      "Retrieve current price and recent price movement of a stock.",
    ],
    [
      "GoogleFinance.GetStockHistoricalData",
      "Fetch historical stock price and volume data for a specified time window.",
    ],
  ]}
/>

<Callout>
  If you need an action that's not listed here, please [contact
  us](mailto:contact@arcade.dev) to request a new tool, or [create your own
  tools](/guides/create-tools/tool-basics/build-mcp-server).
</Callout>

## GoogleFinance.GetStockSummary

Retrieve summary information for a given stock using the Google Finance API via SerpAPI. This tool returns the current price and price change from the most recent trading day.

**Parameters**

- **`ticker_symbol`** _(string, required)_: The stock ticker, e.g., 'GOOG'.
- **`exchange_identifier`** _(string, required)_: The market identifier, e.g., 'NASDAQ'.

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/search/google_finance/get_stock_summary_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/search/google_finance/get_stock_summary_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## GoogleFinance.GetStockHistoricalData

Fetch historical data for a given stock over a defined time window. This tool returns the stock's price and volume data along with key events when available.

**Parameters**

- **`ticker_symbol`** _(string, required)_: The stock ticker, e.g., 'GOOG'.
- **`exchange_identifier`** _(string, required)_: The market identifier, e.g., 'NASDAQ' or 'NYSE'.
- **`window`** _(enum ([GoogleFinanceWindow](#googlefinancewindow)), optional, defaults to ONE_MONTH)_: Time window for the graph data.

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/search/google_finance/get_stock_historical_data_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/search/google_finance/get_stock_historical_data_example_call_tool.js",
        ],
      },
    },
  ]}
/>

## Auth

The Arcade Google Finance MCP Sever uses the [SerpAPI](https://serpapi.com/) to get stock data from Google Finance.

- **Secret:**
  - `SERP_API_KEY`: Your SerpAPI API key.
    <Callout type="info">
      Setting the `SERP_API_KEY` secret is only required if you are
      [self-hosting](/guides/deployment-hosting/configure-engine) Arcade. If you're
      using Arcade Cloud, the secret is already set for you. To manage your
      secrets, go to the [Secrets
      page](https://api.arcade.dev/dashboard/auth/secrets) in the Arcade
      Dashboard.
    </Callout>

---

## Reference

## GoogleFinanceWindow

Defines the time window for fetching stock data from Google Finance.

- **`ONE_DAY`**: Represents a 1-day time window.
- **`FIVE_DAYS`**: Represents a 5-day time window.
- **`ONE_MONTH`**: Represents a 1-month time window.
- **`SIX_MONTHS`**: Represents a 6-month time window.
- **`YEAR_TO_DATE`**: Represents the time from the start of the year to the current date.
- **`ONE_YEAR`**: Represents a 1-year time window.
- **`FIVE_YEARS`**: Represents a 5-year time window.
- **`MAX`**: Represents the maximum available time window.

<ToolFooter pipPackageName="arcade_google_finance" />