1. Conduid
  2. Developer Tools
  3. Marketdatamcpserver
MCP server · Developer Tools

Marketdatamcpserver

by · github.com/OrestisStefanou/MarketDataMcpServer

An MCP server that provides tools to get the latest market data from the most trusted data sources.

Unclaimed devtools
InstallView source
54Fair

Scored 6 days ago · breakdown

About Marketdatamcpserver

Marketdatamcpserver is an MCP server published by OrestisStefanou in the Developer Tools category: an MCP server that provides tools to get the latest market data from the most trusted data sources.

The repository has 1 stars and 1 forks, with the last commit a month ago. Recent commit activity is the strongest signal that reported issues will get attention.

Install

From source
git clone https://github.com/OrestisStefanou/MarketDataMcpServer

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (20)

calculateInvestmentFutureValueCalculate the future value of an investment based on initial amount, annual return, and years.

Parameters not published.

etfSearchSearch for ETFs based on keywords.

Parameters not published.

getCommodityTimeSeriesGet historical data for commodities (Crude Oil, Natural Gas, Copper, Aluminum, Wheat, Corn, Sugar, Coffee) from FRED. Oil and gas are daily; the rest are monthly IMF global prices published with a one to two month lag.

Parameters not published.

getCompanyKpiMetricsGet the KPI metrics(revenue breakdown, revenue by geography etc) of the stock with the given symbol.

Parameters not published.

getCryptocurrencyDataByIdGet detailed real-time data for a specific cryptocurrency.

Parameters not published.

getCryptocurrencyNewsGet the latest news related to a cryptocurrency. Returns `matched_symbol`, which is false when no recent article mentioned the symbol and the response is general crypto news instead.

Parameters not published.

getCurrencyExchangeRateGet the exchange rate between two currencies (USD, EUR, GBP, JPY, CHF, CAD, AUD).

Parameters not published.

getETFGet detailed information and holdings for a specific ETF.

Parameters not published.

getEconomicIndicatorTimeSeriesGet historical data for economic indicators (GDP, Inflation, Interest Rate, Unemployment, Treasury Yield) from FRED. Treasury yields are daily; the rest are monthly or quarterly. Inflation is reported as a year-over-year rate, not a CPI index level.

Parameters not published.

getInsiderTransactionsGet the insider transactions of the stock with the given symbol and year, parsed from SEC EDGAR Form 4 filings. Limited to the years EDGAR keeps in its recent submissions index.

Parameters not published.

Show all 20 tools
getMarketNewsGet the latest global market news.

Parameters not published.

getPolymarketEventOddsSearch Polymarket for prediction-market events matching a free-text query and return matching events with their markets and implied outcome probabilities.

Parameters not published.

getSectorStocksGet the top stocks for a specific sector.

Parameters not published.

getSectorsGet a list of market sectors and their performance.

Parameters not published.

getStockFinancialsGet financial statements (Income Statement, Balance Sheet, Cash Flow).

Parameters not published.

getStockOverviewGet a comprehensive overview of a company (valuation, growth, etc.).

Parameters not published.

getSuperInvestorPortfolioGet the portfolio holdings of a specific super investor.

Parameters not published.

getSuperInvestorsList tracked institutional super investors.

Parameters not published.

searchCryptocurrenciesSearch for cryptocurrencies on CoinGecko.

Parameters not published.

stockSearchSearch for stock tickers based on keywords.

Parameters not published.

Ask AI

✦

Ask AI about Marketdatamcpserver

Powered by Claude · Grounded in docs

I know everything about Marketdatamcpserver. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 6 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • !License declaredNo license file. Legally you have no right to use it in a product.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

README

MarketDataMcpServer

MarketDataMcpServer is a Model Context Protocol (MCP) server that provides comprehensive market data for stocks, ETFs, cryptocurrencies, and economic indicators. It runs without any API keys, drawing on public sources such as FRED, the European Central Bank, SEC EDGAR, CoinGecko, and Polymarket.

Features

  • Stock Market Data: Search for stocks, get detailed company overviews, and access financial statements.
  • ETF Analysis: Search for ETFs and view their holdings and detailed information.
  • Crypto Tracking: Search for cryptocurrencies, get real-time data, and stay updated with crypto news.
  • Super Investor Insights: Track institutional "Super Investors" and their portfolios.
  • Economic Indicators: Access time series data for key economic indicators (GDP, Inflation, etc.) and commodities (Oil, Gas, etc.), sourced from FRED.
  • Insider Activity: Read Form 4 insider transactions straight from SEC EDGAR.
  • Market Intelligence: Get the latest market news and sector performances.
  • Prediction Markets: Search Polymarket for events by free-text query and get current implied odds for their markets.

Prerequisites

  • Go 1.21 or higher.

No API keys are required. The server runs with zero configuration. A CoinGecko key is optional and only raises rate limits.

Data sources

Source Used for Key required
FRED Economic indicators, commodities No
Frankfurter (ECB reference rates) Currency exchange rates No
SEC EDGAR Insider transactions (Form 4) No, but a contact address is required in the User-Agent
stockanalysis.com Stocks, ETFs, sectors, financials, news No
dataroma.com Super investor portfolios No
CoinGecko Cryptocurrency search and data Optional
CoinDesk, CoinTelegraph RSS Cryptocurrency news No
Polymarket Gamma Prediction market odds No

Configuration

Every setting has a working default. To override any of them, create a .env file in the root directory:

PORT=8080

# Optional. Raises CoinGecko's rate limits; the server works without it.
COIN_GECKO_API_KEY=

# The SEC asks automated clients to identify themselves with a contact address.
# Replace the default with your own email. Note that EDGAR rejects a User-Agent
# containing a URL.
SEC_EDGAR_USER_AGENT=MarketDataMcpServer/1.0 (you@example.com)

# Cache TTL (in seconds)
CACHE_TTL=3600
COIN_GECKO_CACHE_TTL=3600
POLYMARKET_CACHE_TTL=300
FRED_CACHE_TTL=86400
FRANKFURTER_CACHE_TTL=3600
SEC_EDGAR_CACHE_TTL=86400
CRYPTO_NEWS_CACHE_TTL=900

Getting Started

Installation

  1. Clone the repository.
  2. Install dependencies: 
    make install

Running the Server

Start the MCP server on port 8080:

make run_mcp_server

Building

Build the binary:

make build_mcp_server

Testing

Unit tests cover the response parsers:

go test ./...

mcp_client/validation.py is an end-to-end check that calls every registered tool against a running server. It expects the server on port 8082:

PORT=8082 make run_mcp_server
uv run --with fastmcp python mcp_client/validation.py

Available Tools

Tool Description
stockSearch Search for stock tickers based on keywords.
etfSearch Search for ETFs based on keywords.
getETF Get detailed information and holdings for a specific ETF.
getSuperInvestors List tracked institutional super investors.
getSuperInvestorPortfolio Get the portfolio holdings of a specific super investor.
getMarketNews Get the latest global market news.
getSectors Get a list of market sectors and their performance.
getSectorStocks Get the top stocks for a specific sector.
getStockOverview Get a comprehensive overview of a company (valuation, growth, etc.).
getStockFinancials Get financial statements (Income Statement, Balance Sheet, Cash Flow).
getEconomicIndicatorTimeSeries Get historical data for economic indicators (GDP, Inflation, Interest Rate, Unemployment, Treasury Yield) from FRED. Treasury yields are daily; the rest are monthly or quarterly. Inflation is reported as a year-over-year rate, not a CPI index level.
getCommodityTimeSeries Get historical data for commodities (Crude Oil, Natural Gas, Copper, Aluminum, Wheat, Corn, Sugar, Coffee) from FRED. Oil and gas are daily; the rest are monthly IMF global prices published with a one to two month lag.
searchCryptocurrencies Search for cryptocurrencies on CoinGecko.
getCryptocurrencyDataById Get detailed real-time data for a specific cryptocurrency.
getCryptocurrencyNews Get the latest news related to a cryptocurrency. Returns matched_symbol, which is false when no recent article mentioned the symbol and the response is general crypto news instead.
calculateInvestmentFutureValue Calculate the future value of an investment based on initial amount, annual return, and years.
getInsiderTransactions Get the insider transactions of the stock with the given symbol and year, parsed from SEC EDGAR Form 4 filings. Limited to the years EDGAR keeps in its recent submissions index.
getCompanyKpiMetrics Get the KPI metrics(revenue breakdown, revenue by geography etc) of the stock with the given symbol.
getCurrencyExchangeRate Get the exchange rate between two currencies (USD, EUR, GBP, JPY, CHF, CAD, AUD).
getPolymarketEventOdds Search Polymarket for prediction-market events matching a free-text query and return matching events with their markets and implied outcome probabilities.

README fetched from the repository 6 days ago. The original is authoritative.

Questions

About Marketdatamcpserver

How do I install Marketdatamcpserver?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Marketdatamcpserver safe to use with an AI agent?

Its trust score is 54 out of 100 (fair). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Marketdatamcpserver still maintained?

Yes — the last commit was a month ago. The repository has 1 stars and 1 forks.