README.md
A specialized MCP server and Agent Skill for high-fidelity market research.
📈 Market Expert MCP & Skill
A specialized Model Context Protocol (MCP) server and Agent Skill for high-fidelity market research. This project combines institutional-grade financial data via Finnhub with a specialized Equity Researcher persona for automated report generation.
🚀 Installation
1. Clone & Install
git clone https://github.com/YOUR_USERNAME/market-expert-mcp.git
cd market-expert-mcp
npm install
2. Configure Secrets
cp .env.example .env
# Open .env and add your FINNHUB_API_KEY
3. Register MCP Server
Add this to your claude_desktop_config.json:
"mcpServers": {
"market-expert": {
"command": "node",
"args": ["/Users/jacksu/market-expert-mcp/src/index.js"]
}
}
4. Install Skill
Copy .claude/skills/market-expert to your project's .claude/skills/ directory.
📊 Usage
Type /market-expert [TICKER] in your AI chat to generate a professional report in the ./reports folder.
📄 License
MIT
Tools (1)
market-expertGenerates a professional market research report for a specific stock ticker.Environment Variables
FINNHUB_API_KEYrequiredAPI key for accessing financial data from FinnhubConfiguration
claude_desktop_config.json
{"mcpServers": {"market-expert": {"command": "node", "args": ["/path/to/market-expert-mcp/src/index.js"]}}}Try it
→Generate a professional market research report for AAPL.
→Can you run a market analysis for TSLA using the market-expert tool?
→Create a stock report for NVDA and save it to the reports folder.