{"id":29067566,"url":"https://github.com/extrawest/financial-ai-agent-mcp-servers","last_synced_at":"2026-04-11T18:06:08.454Z","repository":{"id":300972530,"uuid":"1005498676","full_name":"extrawest/financial-ai-agent-mcp-servers","owner":"extrawest","description":"A TypeScript-based Ai agent with MCP integration. This project provides a unified interface to access financial market information and relevant news articles through MCP servers with tool calling.","archived":false,"fork":false,"pushed_at":"2025-06-24T13:47:35.000Z","size":20,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-24T14:42:05.797Z","etag":null,"topics":["langchain","mcp","mcp-agent","mcp-client","mcp-server","nodejs"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/extrawest.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-20T10:17:42.000Z","updated_at":"2025-06-24T13:47:38.000Z","dependencies_parsed_at":"2025-06-24T14:52:25.905Z","dependency_job_id":null,"html_url":"https://github.com/extrawest/financial-ai-agent-mcp-servers","commit_stats":null,"previous_names":["extrawest/financial-ai-agent-mcp-servers"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/extrawest/financial-ai-agent-mcp-servers","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawest%2Ffinancial-ai-agent-mcp-servers","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawest%2Ffinancial-ai-agent-mcp-servers/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawest%2Ffinancial-ai-agent-mcp-servers/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawest%2Ffinancial-ai-agent-mcp-servers/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/extrawest","download_url":"https://codeload.github.com/extrawest/financial-ai-agent-mcp-servers/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extrawest%2Ffinancial-ai-agent-mcp-servers/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266231762,"owners_count":23896473,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["langchain","mcp","mcp-agent","mcp-client","mcp-server","nodejs"],"created_at":"2025-06-27T11:01:04.130Z","updated_at":"2026-04-11T18:06:08.415Z","avatar_url":"https://github.com/extrawest.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📈 Model Context Protocol(MCP) Agent App\n\n[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)]()\n[![Maintainer](https://img.shields.io/static/v1?label=Alex\u0026message=Maintainer\u0026color=red)]()\n[![Ask Me Anything !](https://img.shields.io/badge/Ask%20me-anything-1abc9c.svg)]()\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n![Version](https://img.shields.io/badge/version-1.0.0-blue)\n\nA TypeScript-based Ai agent with MCP integration. This project provides a unified interface to access financial market information and relevant news articles through MCP servers with tool calling.\n## DEMO\n\n### Terminal\n\nhttps://github.com/user-attachments/assets/47150b98-0663-43f6-927e-f09abb796fe6\n\n\n### Cursor\n\nhttps://github.com/user-attachments/assets/72210b49-dc23-4bef-b7ee-6d289ede59e1\n\n\n\n## ✨ Features\n\n-   **📊 Stock Market Data**:\n    -   Company Information\n    -   Quarterly Financials\n    -   Annual Financial Reports\n-   **📰 News Integration**:\n    -   Real-time News Articles\n    -   Query-based News Search\n-   **🛠️ Architecture Components**:\n    -   Client-Server Architecture\n    -   TypeScript Implementation\n    -   Modular Design Pattern\n    -   LangChain agent\n\n## 🔧 Prerequisites\n\n-   Node.js 16.x or higher\n-   TypeScript 4.x or higher\n-   API keys for stock services and OpenAi\n\n## 🚀 Quick Start\n\n### 1. Installation\n\nClone and set up the project:\n\n```bash\ngit clone https://github.com/extrawest/financial-ai-agent-mcp-servers\ncd  financial-ai-agent-mcp-servers\n\n# Install dependencies\nnpm install\n```\n\n### 2. Environment Configuration\n\nCreate a `.env` file in the project root:\n\n```env\n# API Configuration\nSTOCK_API_KEY=your_stock_api_key\nOPENAI_API_KEY=your_open_ai_key\n```\n\n### 3. Build and Run\n\n```bash\n# Build the project\nnpm run build\n\n# Start the server\nnpm start\n```\n\n## 🏗️ Project Structure\n\n```\nsrc/\n├── agent/\n│   └── agent.ts         # Agent implementation\n├── client/\n│   └── client.ts        # API client implementation\n├── config/\n│   └── configs.ts       # Configuration management\n├── logger/\n│   └── logger.ts        # Logging functionality\n├── server/\n│   ├── news-server.ts   # News API server\n│   └── stocks-server.ts # Stock market API server\n├── types/\n│   └── newsapi.d.ts     # Type definitions\n└── index.ts             # Application entry point\n```\n\n## 📦 Core Components\n\n### Stock Server\n\nHandles all stock market related operations:\n\n-   Company information retrieval\n-   Financial reports access\n-   Market data processing\n\n### News Server\n\nManages news-related functionality:\n\n-   Article search and retrieval\n-   Query processing\n-   News data formatting\n\n### Client\n\nProvides a unified interface to interact with both servers:\n\n-   API request handling\n-   Response processing\n-   Error management\n\n## Start an app\n\nIn separate terminal tabs run\n\n```bash\n# Start Stocks server\n npm run stocks:built\n\n # Start News server\n npm npm run news:built\n\n  # Run agent\n npm run agent:built\n```\n\n## Add mcp to Cursor IDE\n\n-   Open Cursor IDE, go to Settings -\u003e Cursor Settings\n-   Go to Tools \u0026 Integrations section\n-   Find MCP tools, click New MCP Server\n-   Add this to mcp.json file\n\n```json\n{\n    \"mcpServers\": {\n        \"stocks-mcp-server\": {\n            \"url\": \"http://127.0.0.1:3000/sse\"\n        },\n        \"news-mcp-server\": {\n            \"url\": \"http://127.0.0.1:3001/sse\"\n        }\n    }\n}\n```\n\n-   Run commands in separte terminal tabs\n\n```bash\n# Start Stocks server\n npm run stocks:built\n\n # Start News server\n npm npm run news:built\n\n```\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n---\n\nCreated by Oleksandr Samoilenko  \n[Extrawest.com](https://extrawest.com), 2025\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fextrawest%2Ffinancial-ai-agent-mcp-servers","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fextrawest%2Ffinancial-ai-agent-mcp-servers","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fextrawest%2Ffinancial-ai-agent-mcp-servers/lists"}