Metadata-Version: 2.4
Name: wallstreet-mcp-tools
Version: 0.1.0
Summary: Lightweight Python SDK for Wall Street Hedge Fund Suite via Model Context Protocol (MCP)
Author-email: MCP Collector <mcp_collector@apify.actor>
License: MIT
Project-URL: Homepage, https://github.com/mcp-collector-pick/wallstreet-mcp-examples
Project-URL: Repository, https://github.com/mcp-collector-pick/wallstreet-mcp-examples.git
Project-URL: Apify Actor, https://apify.com/mcp_collector/wallstreet-hedgefund-suite-mcp
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Office/Business :: Financial :: Investment
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.28.0
Provides-Extra: langchain
Requires-Dist: langchain-mcp-adapters>=0.1.0; extra == "langchain"
Requires-Dist: langchain-openai>=0.1.0; extra == "langchain"

# ⚡ wallstreet-mcp-tools (Python SDK)

Lightweight Python SDK for **Wall Street Hedge Fund Suite** on Apify via the Model Context Protocol (MCP).

---

## 📦 Installation

### From Source (Current)
```bash
git clone https://github.com/mcp-collector-pick/wallstreet-mcp-examples.git
cd wallstreet-mcp-examples/sdk/python
pip install -e .
```

### With LangChain Support
```bash
pip install -e ".[langchain]"
```

*(Note: PyPI global distribution `pip install wallstreet-mcp-tools` is scheduled for official release in Week 4)*

---

## 🚀 Quick Usage

### 1. Direct Python SDK Call
```python
from wallstreet_mcp import WallStreetClient

# Automatically reads APIFY_TOKEN from environment if not passed
client = WallStreetClient(token="YOUR_APIFY_TOKEN")

# Run 360° audit on any US ticker
audit = client.audit("NVDA")
print(f"Piotroski F-Score: {audit.get('piotroski_f_score')}/9")
print(f"Altman Z-Score: {audit.get('altman_z_score')}")
```

### 2. LangChain Integration
```python
from wallstreet_mcp import WallStreetClient
from langchain_openai import ChatOpenAI

client = WallStreetClient()
tools = client.load_langchain_tools()

llm = ChatOpenAI(model="gpt-4o", temperature=0)
agent = llm.bind_tools(tools)

res = agent.invoke("Run a 360° quant audit on NVDA")
print(res.content)
```

---

## 📄 License
MIT License.
