Metadata-Version: 2.4
Name: finstack-mcp
Version: 0.3.1
Summary: Open-source MCP server for Indian (NSE/BSE) + Global financial data with built-in AI analytics
Project-URL: Homepage, https://github.com/SpawnAgent/finstack-mcp
Project-URL: Repository, https://github.com/SpawnAgent/finstack-mcp
Project-URL: Issues, https://github.com/SpawnAgent/finstack-mcp/issues
Author-email: SpawnAgent <spawnagent@proton.me>
License: MIT
License-File: LICENSE
Keywords: ai-agents,bse,claude,cursor,finance,mcp,nse,stocks,trading
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.0.0
Requires-Dist: numpy>=1.26.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=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'
Requires-Dist: ruff>=0.5.0; extra == 'dev'
Provides-Extra: hosted
Requires-Dist: stripe>=8.0.0; extra == 'hosted'
Requires-Dist: uvicorn>=0.30.0; extra == 'hosted'
Description-Content-Type: text/markdown

# FinStack MCP

[![PyPI version](https://badge.fury.io/py/finstack-mcp.svg)](https://pypi.org/project/finstack-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![MCP](https://img.shields.io/badge/MCP-Compatible-green.svg)](https://modelcontextprotocol.io)

India-first MCP server for market data, fundamentals, and research workflows.

39 tools. Zero API keys. Works with Claude, Cursor, ChatGPT, and MCP clients.

## Install

```bash
pip install finstack-mcp
```

Add to Claude Desktop config:

```json
{
  "mcpServers": {
    "finstack": {
      "command": "python",
      "args": ["-m", "finstack.server"]
    }
  }
}
```

Restart Claude and ask:

- "What's Reliance's stock price?"
- "Compare TCS, Infosys, and Wipro."
- "Show me technical indicators for HDFCBANK."

## Coverage

- Indian markets: NSE/BSE quotes, indices, historical data, corporate actions, quarterly results, FII/DII, bulk deals, IPOs
- Global markets: stocks, crypto, forex, market news, SEC filings
- Fundamentals: income statement, balance sheet, cash flow, key ratios, company profile, dividend history
- Analytics: indicators, stock comparison, sector performance, screeners, options chain, backtesting

## Product Role

This repo is the open-source engine and public distribution layer for FinStack.

The paid wedge we are building on top of this is the hosted **Indian market daily brief** product.

- Strategy: [docs/PARTNER_PLAN.md](docs/PARTNER_PLAN.md)
- Running updates: [docs/WORKLOG.md](docs/WORKLOG.md)

## Data Sources

| Source | Covers | API Key |
|---|---|---|
| yfinance | NSE, BSE, US, Crypto, Forex | Not needed |
| SEC EDGAR | US company filings | Not needed |
| NSE Direct | FII/DII, bulk deals, IPOs | Not needed |

## Contributing

PRs are welcome. Keep changes focused, test what you touch, and document any new tool clearly.

## License

MIT
