Skip to main content

Tepilora MCP Server

PyPI Python License: MIT

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)

Source distribution for tepilora-mcp 0.5.5
File Size Uploaded
tepilora_mcp-0.5.5.tar.gz 26.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for tepilora-mcp 0.5.5
File Interpreter ABI Platform
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 log

Release 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

Release history Release notifications | RSS feed

This release

0.5.5 This release

2 release files

0.5.4

2 release files

0.5.0

2 release files

0.4.1

2 release files

0.4.0

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page