# agent-fin

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add markchiang/agent-fin

# Browse available tools
npx -y smithery tool list markchiang/agent-fin

# Get full schema for a tool
npx -y smithery tool get markchiang/agent-fin equity_fundamental_cash

# Call a tool
npx -y smithery tool call markchiang/agent-fin equity_fundamental_cash '{}'
```

## Direct MCP Connection

Endpoint: `https://agent-fin--markchiang.run.tools`

## Tools (24)

- `equity_fundamental_cash` — Get the cash flow statement for a given company.
- `equity_fundamental_dividends` — Get historical dividend data for a given company.
- `equity_price_historical` — Get historical price data for a given stock. This includes open, high, low, close, and volume.
- `equity_price_quote` — Get the latest quote data for a given stock symbol.
- `equity_fundamental_income` — Get the income statement for a given company.
- `equity_fundamental_balance` — Get the balance sheet for a given company.
- `equity_fundamental_metrics` — Get key fundamental metrics for a company.
- `equity_calendar_ipo` — Get historical and upcoming initial public offerings (IPOs).
- `equity_compare_groups` — Get company data grouped by sector, industry or country.
- `equity_compare_company_facts` — Compare reported company facts and fundamental data points.
- `equity_estimates_consensus` — Get consensus price target and recommendation.
- `equity_discovery_losers` — Get the top price losers in the stock market.
- `equity_discovery_active` — Get the most actively traded stocks based on volume.
- `equity_discovery_undervalued_large_caps` — Get potentially undervalued large cap stocks.
- `equity_discovery_undervalued_growth` — Get potentially undervalued growth stocks.
- `equity_discovery_aggressive_small_caps` — Get top small cap stocks based on earnings growth.
- `equity_discovery_growth_tech` — Get top tech stocks based on revenue and earnings growth.
- `equity_profile` — Get the company profile, including key information and descriptions.
- `equity_screener` — Screen for equities using a predefined metric such as overview or valuation.
- `equity_search` — Search for equity tickers or names via NASDAQ.
- `equity_ownership_share_statistics` — Get share statistics such as float, shares outstanding, and insider holdings.
- `equity_shorts_fails_to_deliver` — Get fails-to-deliver data reported to the SEC.
- `equity_shorts_short_interest` — Get reported short interest for a given symbol.
- `equity_shorts_short_volume` — Get reported short volume statistics for a given symbol.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get markchiang/agent-fin <tool-name>
```