MCP ChatGPT App

You can run four MCP servers in a single suite to access stock market data, currency conversion, world time, and unit conversions through the MCP protocol. Each server exposes a dedicated HTTP MCP endpoint you can call from any MCP client or automation, making it easy to integrate live data and conversions into your workflows or ChatGPT actions.

How to use

Connect to each server using its MCP endpoint and invoke the available tools through your MCP client. You can call tools like topMovers to fetch real-time stock movers, convertCurrency to swap amounts between currencies, convertTime to translate times across zones, and convertUnits to translate measurements across categories. Each server exposes a JSON-RPC style /mcp endpoint that accepts tool calls and returns structured results you can display or route into your automation.

How to install

Prerequisites: ensure you have Node.js v16 or higher installed on your system.

Step 1: Install dependencies

npm install

Step 2: Set up environment variables. If you need the Stock Market server, supply your Alpha Vantage API key.

# Copy the example file if applicable
cp .env.example .env

# Edit .env and add your Alpha Vantage API key for the Stock Market server
# Or set it as a system environment variable
export ALPHA_VANTAGE_API_KEY=your_api_key_here

Step 3: Build the TypeScript project

npm run build

Additional notes

All servers run with Express and MCP protocol support, with a responsive UI and CORS enabled for easy integration. You can expose the servers externally using a tunneling tool if needed.

Security and troubleshooting

Ensure your API keys are kept secure and do not expose them in client-side code. If you encounter port conflicts, choose different ports or stop the conflicting process. If a server won't start, rebuild dependencies and verify the environment variables are set correctly.

Available tools

topMovers

Fetches top gainers, losers, and most actively traded stocks from the stock market data source.

convertCurrency

Converts an amount between two currencies using real-time exchange rates.

getExchangeRates

Retrieves all exchange rates for a specified base currency.

getSupportedCurrencies

Lists all currencies supported by the converter.

convertTime

Converts a time value from one timezone to another.

getCurrentTime

Returns the current time in a specified timezone.

getSupportedTimezones

Lists all supported timezones.

getWorldClocks

Fetches current times for multiple timezones.

convertUnits

Converts values between different units across categories.

getSupportedUnits

Lists units by category.

getCategories

Lists all unit categories.