Sample Financial Tool

A Model Context Protocol (MCP) server implementation providing financial data and calculations through various APIs.

Features

• Stock Price Data: Fetch real-time stock prices using Alpha Vantage API
• Cryptocurrency Data: Get cryptocurrency prices and stats via CoinGecko API
• Forex Rates: Access currency exchange rates through Exchange Rate API
• Compound Interest Calculator: Calculate compound interest with customizable parameters
• Financial News: Retrieve latest financial news from GNews API

Available Tools

1. getStockPrice

{
	ticker: string;
}

2. getCryptoPrice

{
	symbol: string;
}

3. getForexRate

{
	pair: string;
}

4. calculateCompoundInterest

{
    principal: number,
    rate: number,
    time: number,
    compoundFrequency: number
}

5. getFinancialNews

{
	category: string;
}

Setup

1. Install dependencies:

npm install
pnpm install

2. Run the server:

npm run dev

Note

• The server uses demo API keys for demonstration purposes
• For production use, replace demo API keys with your own
• Some APIs may have rate limits in their free tiers