ta-lib-mcp
ta-lib-mcp
Read-only Python MCP server for TA-Lib indicator discovery and computation.
What It Exposes
talib_list_indicators: list available indicators with group, category, and search filters.talib_get_indicator_info: inspect one indicator's inputs, outputs, parameters, and category.talib_compute_indicator: compute an indicator from numeric OHLCV-like arrays.talib_list_categories: list indicator categories (Trend, Momentum, Volume, etc.) with descriptions.talib_get_version_info: report MCP, Python, and TA-Lib versions.
Related MCP server: ibkr-mcp
Requirements
Python 3.13+
mcp[cli]Optional:
TA-Lib(pip install "ta-lib-mcp-server[talib]")
If TA-Lib is missing, the server still starts and returns actionable errors for TA-Lib tools.
Install
pip install -e ".[dev,talib]"Run
ta-lib-mcpMCP Client Configuration
Claude Desktop
{
"mcpServers": {
"ta-lib": {
"command": "ta-lib-mcp",
"env": {
"TALIB_MCP_LOG_LEVEL": "INFO"
}
}
}
}Codex
[mcp_servers.talib]
command = "ta-lib-mcp"
args = []
[mcp_servers.talib.env]
TALIB_MCP_LOG_LEVEL = "INFO"Gemini CLI
{
"mcpServers": {
"ta-lib": {
"command": "ta-lib-mcp",
"env": {
"TALIB_MCP_LOG_LEVEL": "INFO"
}
}
}
}Development
pip install -e ".[dev,talib]"
pytest
ruff check src tests
ruff format src tests
mypy srcEngineering Rules
Read-only server behavior only; no stateful or exchange-connected operations.
External MCP tool inputs are validated in
src/ta_lib_mcp/validators.py.Do not use
evalorexec.
Available Tools
5 toolstalib_compute_indicatorARead-onlyIdempotent
Compute a TA-Lib indicator from aligned numeric inputs.
Computes the requested indicator over the provided numeric arrays and returns the result. All input arrays must have the same length.
Args: indicator: TA-Lib indicator name (e.g., "SMA", "RSI", "MACD"). inputs: Aligned numeric input arrays (e.g., {"close": [1.0, 2.0, 3.0]}). parameters: Optional indicator parameters (e.g., {"timeperiod": 14}).
Returns: Computation result with indicator name, length, parameters, and output values.
Inputs: indicator (required), inputs (required), parameters. Returns: object
talib_get_indicator_infoARead-onlyIdempotent
Get metadata for a specific TA-Lib indicator.
Returns the indicator's group, category, display name, required inputs, outputs, default parameters, and lookback period.
Args: indicator: TA-Lib indicator name (e.g., "SMA", "RSI", "MACD").
Returns: Indicator metadata with inputs, outputs, parameters, and lookback.
Inputs: indicator (required). Returns: object
talib_get_version_infoARead-onlyIdempotent
Return server, Python, and TA-Lib version information.
Returns version information including the ta-lib-mcp server version, TA-Lib availability, and Python version.
Returns: Version information dictionary.
Inputs: no named parameters. Returns: object
talib_list_categoriesARead-onlyIdempotent
List available indicator categories with descriptions.
Returns all indicator categories (Trend, Momentum, Volume, etc.) with descriptions and example indicators for each category.
Returns: List of category summaries with name, description, and examples.
Inputs: no named parameters. Returns: result
talib_list_indicatorsARead-onlyIdempotent
List TA-Lib indicators with optional group, category, and search filters.
Returns indicator names with group and category metadata. Use the optional filters to narrow results by TA-Lib group, category, or keyword search.
Args: group: Optional TA-Lib group filter (e.g., "Overlap Studies"). category: Optional category filter (e.g., "Trend", "Momentum"). search: Optional keyword search for indicator names. limit: Maximum number of indicators to return (1-1000).
Returns: List of indicator summaries with name, group, and category.
Inputs: group, category, search, limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose: computing an indicator, getting metadata, listing categories, listing indicators, and version info. There is no overlap or ambiguity.
All tool names follow a consistent 'talib_verb_noun' pattern in snake_case, making them predictable and easy to understand.
With 5 tools covering discovery, metadata, computation, and version info, the set is well-scoped and efficiently supports the TA-Lib domain.
The set provides complete coverage: you can discover indicators, get detailed info, and compute them. No obvious gaps for typical usage.
Related MCP Connectors
MCP server exposing the Backtest360 engine API as tools for AI agents.
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Hosted MCP server for MT4 and MT5: read accounts, prices and candles, and place or close orders.
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
Related MCP Servers
- AlicenseAqualityDmaintenanceRead-only MCP server for Interactive Brokers that exposes market data, positions, and account info as MCP tools.8MIT
- AlicenseBqualityDmaintenanceA read-only-by-default MCP server for Interactive Brokers that exposes account, positions, PnL, market data, and trade history from a local TWS/IB Gateway session, with optional trading capabilities.15MIT
- AlicenseBqualityDmaintenanceSelf-hostable, read-only Taiwan stock-analysis MCP server that retrieves market data and computes reproducible indicators.1524MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that calculates technical analysis indicators for stock tickers using yfinance and pandas-ta, providing real-time financial data and quantitative analysis tools for LLMs.-