Metadata-Version: 2.5
Name: finagent-mcp
Version: 0.1.1
Summary: Free financial analysis MCP server — stock quotes, financials, and market news
License: MIT
Requires-Python: >=3.11
Requires-Dist: mcp[cli]<2,>=1.0.0
Requires-Dist: yfinance>=0.2.40
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# FinAgent

Free financial analysis MCP server for any MCP-compatible AI app (Claude, ChatGPT, Cursor, Copilot, and more).

Get live stock data and market news — all from your AI assistant.

## Tools

| Tool | Description |
|------|-------------|
| `financial_data` | Stock quotes, income statements, balance sheets, cash flow, analyst estimates, insider trades, key ratios |
| `market_news` | Financial news, analyst reactions, market sentiment |

## Quick Start

### Install

```bash
pip install finagent-mcp
```

### Add to your MCP config

```json
{
  "mcpServers": {
    "finagent": {
      "command": "finagent"
    }
  }
}
```

### Run as HTTP server

```bash
finagent --http --port 8080
```

This listens on `127.0.0.1` only. To accept connections from other machines, pass `--host` and set `MCP_ALLOWED_HOSTS` to the Host values clients will use. Without `MCP_ALLOWED_HOSTS` a non-loopback `--host` refuses to start:

```bash
MCP_ALLOWED_HOSTS=my-server.example.com finagent --http --host 0.0.0.0 --port 8080
```

A value must match the Host header exactly, port included (`192.168.1.20:8080`); `192.168.1.20:*` allows any port.

## Examples

Ask your AI assistant:

- "What's NVIDIA's current stock price and P/E ratio?"
- "Show me Apple's last 4 quarters of revenue"
- "Who's been buying or selling TSLA stock lately?"
- "What are analysts saying about AMZN?"

## Want More?

**FinAgent Pro** adds SEC filing analysis and stock screening. Get it at [mcp-marketplace.io/server/finagent-pro](https://mcp-marketplace.io/server/finagent-pro).

## Data Sources

- **Market data:** Yahoo Finance (free, real-time)
- **News:** Yahoo Finance news feed (free)
