tepilora-mcp 0.1.0

MCP server for Tepilora financial API

Tepilora MCP Server

MCP (Model Context Protocol) server for the Tepilora financial API.

Gives AI assistants (Claude, Codex, etc.) native access to 226 financial data operations — securities search, portfolio analytics, news, bonds, and more.

Install

pip install tepilora-mcp

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "tepilora": {
      "command": "tepilora-mcp",
      "env": {
        "TEPILORA_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add tepilora tepilora-mcp -e TEPILORA_API_KEY=your-api-key

Run Directly

export TEPILORA_API_KEY=your-api-key
tepilora-mcp

Available Tools

Discovery

Tool	Description
list_namespaces	List all 23 API namespaces with operation counts
list_operations	List operations for a namespace
describe_operation	Get parameter details for any operation
call_operation	Execute any of the 226 operations

Curated

Tool	Description
search_securities	Search stocks, ETFs, bonds, funds
get_security_details	Get security information
get_price_history	Historical price data
create_portfolio	Create a portfolio
get_portfolio_returns	Portfolio return analysis
run_analytics	Run any of 68 analytics functions
search_news	Search financial news
screen_bonds	Screen bonds by criteria
get_yield_curve	Yield curve data

Full Mode

Set TEPILORA_MCP_FULL_TOOLS=true to expose all 226 operations as individual tools.

Configuration

Environment Variable	Required	Default	Description
TEPILORA_API_KEY	Yes	-	Your Tepilora API key
TEPILORA_BASE_URL	No	https://tepiloradata.com	API base URL
TEPILORA_MCP_FULL_TOOLS	No	false	Register all 226 operations as tools
TEPILORA_MCP_TIMEOUT	No	30	Request timeout in seconds

API Coverage

23 namespaces, 226 operations:

Namespace	Ops	Examples
securities	12	search, filter, history, facets
portfolio	19	create, returns, attribution, optimize
analytics	68	rolling volatility, Sharpe, drawdown, VaR
news	7	search, latest, trending
bonds	7	analyze, screen, curve, spread
stocks	9	technicals, screening, peers
options	6	pricing, Greeks, IV
macro	6	economic indicators, calendar
esg	5	scores, screening
+ 14 more		alerts, billing, clients, documents, ...

License

MIT