algogene-mcp-server 0.1.3

Algogene MCP Server - A Python package for MCP server functionality

ALGOGENE MCP Server

Introduction

The algogene_mcp_server provides a Python-based interface for accessing the ALGOGENE API, enabling users to conduct strategy backtest, real-time data analytics, and manage trading activities.

Installation

1. Set Up Your Environment:

Ensure you have Python 3.11 or later installed.

2. Install Dependencies:

pip install requests mcp-server

3. Install Package:

pip install algogene-mcp-server

4. Update Configuration: Modify the configuration file located at /config/__init__.py.

BASE_URL = "https://algogene.com/rest"

ALGOGENE_USER = "YOUR_ALGOGENE_USER_ID"
ALGOGENE_API_KEY = "YOUR_ALGOGENE_API_KEY"

Running the Server

1. Start the Server:

python main.py

You can customize options using command-line arguments:

python main.py --transport streamable-http --port 8080 --host 0.0.0.0

2. Connect and Execute Commands:

• The server runs in STDIO mode by default. You can connect to it via your MCP client and run commands based on available tools.

Tools Overview

1. Contract Specification:

• get_instruments: Get all available instruments available on ALGOGENE
• get_instrument_meta: Get contract specification of a financial instrument
• search_instrument: Search related financial instruments based on matched keywords of symbol or description
• list_econs_series: List out all available economic time series
• search_econs_series: Search related economic time series based on matched keywords of titles, geo and freq
• get_econs_series_meta: Get meta data or specification of an economic time series

2. Real-time Data:

• get_realtime_prices: Get current price for trading symbol(s)
• get_realtime_price_24hrchange: Get the recent 24 hours market price change
• get_realtime_exchange_rate: Get current exchange rate between 2 currencies
• get_realtime_news: Get latest news for a specified language/source/categroy
• get_realtime_weather: Get latest weather info for a specified region
• get_realtime_econs_calendar: Get the upcoming economic calendar info such as holiday, statistics release, president speech, etc
• get_realtime_econs_stat: Get the most recent released economic statistics

3. Historical Data:

• get_history_price: Get historical market price
• get_history_news: Get historical news
• get_history_weather: Get historical weather
• get_history_corp_announcement: Get company's corporate announcement history
• get_history_econs_calendar: Get economic calendar history, such as holiday, statistics release, president speech, etc
• get_history_econs_stat: Get historical released economic statistics
• strategy_market_perf: Get performance statistics for a market index

4. Trading Account Current Status:

• get_session: Get session token that will be used to access account and order related resources
• list_accounts: List out all your trading accounts with latest balance on ALGOGENE.
• get_positions: Get outstanding positions of a trading account
• get_balance: Get current balance of a trading account
• get_opened_trades: Get opened trades of a trading account
• get_pending_trades: Get pending trades (or limit orders) of a trading account
• set_account_config: Trading connection setup with your personal broker/exchange account on ALGOGENE.

5. Trading Account History:

• strategy_trade: Get transaction history of a trading account
• strategy_bal: Get daily history of account balance of a trading account
• strategy_pos: Get daily history of position of a trading account
• strategy_pl: Get daily history of cumulative profit/loss of a trading account
• strategy_cashflow: Get history of cash flow (eg. deposit, withdrawal, dividend payment, etc) of a trading account
• strategy_stats: Get performance statistics history and trading setting of a trading account

6. Order Placecment and Management:

• open_order: Place an order on a trading account
• query_order: Query an order's details of a trading account
• update_pending_order: Update trading parameters of a pending order
• update_opened_order: Update trading parameters of an outstanding/opened order
• cancel_orders: cancel a list of unfilled limit/stop orders
• close_orders: close a list of outstanding orders

7. Other Trading Apps available on (https://algogene.com/marketplace#app):

• app_predict_sentiment: Give a sentiment score for a given text (eg. news, blog posts, financial reports)
• app_asset_allocation: Calculate an optimal portfolio based on given risk tolerance level.
• app_portfolio_optimizer: Calculate an optimal portfolio based on dynamic objectives and conditions, such as target return, risk tolerance, group constraints, etc
• app_portfolio_optimizer_custom: Similar to 'app_portfolio_optimizer' to calculate an optimal portfolio based on given time series data
• app_fourier_prediction: Estimate the future range (i.e. upper and lower bound) of a financial instrument based on Fourier analysis and transformation.
• app_market_classifer: Calculate the bull-bear line and classify the market condition of a given financial instrument
• app_us_company_filing_hitory: Get the filing history's report URL from US SEC for a given ticker
• app_us_company_financials: Get company financial data for a given US stock
• app_stock_tagger: Identify related stocks for a given news
• app_index_composite: Get the index constituent data including the composited stocks, current weighting and sensitivity
• app_pattern_recoginer: Identify key technical pattern for a given financial instrument and time frame
• app_risk_analysis: Analyze potential market risk for a given portfolio holding
• app_trading_pair_aligner: Identify the most suitable instrument within the same asset class that can form a trading pair based on a given instrument
• app_price_simulator: Generate a financial time series based on correlation of another given time series
• app_capitalflow_hkex_szse: Get capital flow historical data between Hong Kong Stock Exchange (HKEx) and Shenzhen Stock Exchange (SZSE)
• app_capitalflow_hkex_sse: Get capital flow historical data between Hong Kong Stock Exchange (HKEx) and Shanghai Stock Exchange (SSE)

License and Terms of Use

It is an official python package developed by ALGOGENE. Read our terms of use before deploying this MCP services: https://algogene.com/terms

Support

For new features request or bugs reporting, please contact us at [e-mail]