Tepilora MCP Server
MCP (Model Context Protocol) server for the Tepilora financial analytics ecosystem.
Give any AI assistant (Claude, Codex, Cursor, Copilot) direct access to 279 financial analytics operations across 28 categories — securities search, portfolio optimization, risk analytics, realtime quotes, bonds, macro indicators, ESG, reporting, and more.
Why Tepilora MCP? One API key, one MCP server, and your AI assistant can search 600K+ securities, build portfolios, run 75+ analytics functions, generate fund sheets, and stream realtime market data — no custom code needed.
Features
- 22 default tools (discovery + generic + admin + curated), full mode for all operations
- Async client — non-blocking, optimized for MCP
- Smart caching — TTL + LRU, skips mutating operations
- Credit tracking — per-session usage limits
- Analytics summary-first — large time series truncated to preview + MCP resource for full data
- Arrow IPC streaming — binary format for large result sets
Install
pip install tepilora-mcp
Quick Start
Claude Desktop
{
"mcpServers": {
"tepilora": {
"command": "tepilora-mcp",
"env": { "TEPILORA_MCP_API_KEY": "your-api-key" }
}
}
}
Claude Code
claude mcp add tepilora tepilora-mcp -e TEPILORA_MCP_API_KEY=your-api-key
Run Directly
export TEPILORA_MCP_API_KEY=your-api-key
tepilora-mcp
Available Tools
Discovery & Generic
| Tool | Description |
|---|---|
list_namespaces |
List all API namespaces with operation counts |
list_operations |
List operations for a namespace |
describe_operation |
Get parameter details for any operation |
call_operation |
Execute any operation by action string |
call_operation_arrow_stream |
Execute any operation in Arrow IPC format |
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 |
save_query |
Save a reusable query |
get_portfolio_returns |
Portfolio return analysis |
run_analytics |
75+ analytics functions (summary-first with MCP resource for full data) |
search_news |
Search financial news |
screen_bonds |
Screen bonds by criteria |
get_yield_curve |
Yield curve data |
get_realtime_quotes |
Realtime quotes for a market category |
get_realtime_quote |
Single realtime quote by symbol |
get_realtime_chart |
Intraday chart data (1D, 5D, 1M, 1Y) |
get_realtime_calendar |
Economic calendar with actual vs forecast |
get_realtime_health |
Data source health status |
Utility
| Tool | Description |
|---|---|
clear_cache |
Clear the in-memory result cache |
get_credit_usage |
View session credit usage and limits |
reset_credits |
Reset the session credit counter |
Full Mode
Set TEPILORA_MCP_FULL_TOOLS=true to expose all operations as individual tools.
Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
TEPILORA_MCP_API_KEY |
Yes | - | Your Tepilora API key for MCP (TEPILORA_API_KEY is a deprecated alias until 0.6.0) |
TEPILORA_BASE_URL |
No | https://tepiloradata.com |
API base URL |
TEPILORA_FALLBACK_URL |
No | - |
Fallback URL |
TEPILORA_MCP_FULL_TOOLS |
No | false |
Register all operations as tools |
TEPILORA_MCP_TIMEOUT |
No | 30 |
Request timeout (seconds) |
TEPILORA_MCP_CACHE_TTL |
No | 300 |
Cache TTL in seconds (0 disables) |
TEPILORA_MCP_CACHE_MAX_SIZE |
No | 1000 |
Max cached entries (LRU) |
TEPILORA_MCP_CREDIT_LIMIT |
No | 0 |
Session credit cap (0 = unlimited) |
Requirements
License
MIT
Release files for tepilora-mcp 0.5.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tepilora_mcp-0.5.5.tar.gz | 26.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tepilora_mcp-0.5.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 46.1 kB
Release files / tepilora_mcp-0.5.5.tar.gz
| Download URL | tepilora_mcp-0.5.5.tar.gz |
|---|---|
| Size | 26.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2217289ef8dc4f26ec121e2235a9f159bd5fcbe529295d55b1c7c944026a7051
|
|
BLAKE2b-256 checksum How to use checksums |
d3dc666eda2bc17ec353810620d4239876bdc93713c84d00d2df4ec2d8d55379
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 24, 2026.
Transparency logRelease files / tepilora_mcp-0.5.5-py3-none-any.whl
| Download URL | tepilora_mcp-0.5.5-py3-none-any.whl |
|---|---|
| Size | 19.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
453806a21b482e6b7459faa79dfa831435667d16b03a9737169599911ae092cf
|
|
BLAKE2b-256 checksum How to use checksums |
ae954ac6d34ea49aec53a55986d7707b5da3546c45086d2d7f28b319fd39cd10
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 24, 2026.
Transparency log