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.

File Upload Inputs

MCP tools are JSON-only. For operations whose schema parameter type is file, pass exactly one JSON transport input:

  • file_path: local readable file path, checked before upload.
  • content_base64: base64-encoded file bytes.

For future operations with multiple file fields, use <param>_path or <param>_base64. The MCP server enforces the operation max size before sending bytes through the SDK multipart transport.

Binary Download Outputs

Operations marked with response_transport: binary still return JSON through MCP. By default the tool response includes content_base64, content_type, size_bytes, headers, and metadata. To save bytes locally instead of returning them inline, pass output_file_path; the parent directory must already exist and existing files are not overwritten.

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)
TEPILORA_MCP_POLICY No public Runtime policy. Use dashboard_ai for dashboard AI contexts; it enforces a server-side read allowlist and blocks unsafe/write operations such as documents.parse, attachment upload/rename/delete, portfolio writes, cache clear, and credit reset.

Requirements

License

MIT

Metadata

Release files for tepilora-mcp 0.5.7

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.7
File Size Uploaded Provenance Actions
tepilora_mcp-0.5.7.tar.gz 42.6 kB With provenance Details for tepilora_mcp-0.5.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tepilora-mcp 0.5.7
File Interpreter ABI Platform Actions
tepilora_mcp-0.5.7-py3-none-any.whl Python 3 none any Details for tepilora_mcp-0.5.7-py3-none-any.whl

Total release size: 67.5 kB

Release files / tepilora_mcp-0.5.7.tar.gz

Download URL tepilora_mcp-0.5.7.tar.gz
Size 42.6 kB
Tags Source
SHA-256 checksum
How to use checksums
c3ec24c99dcbdc29023e833089ce835b382331b5864ce7529d345a2b15c17b8b
BLAKE2b-256 checksum
How to use checksums
a8e2261fbf24562345086e80d66d2a85f9fec4cc6f01b9de3a957fb16e90a4e1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 12, 2026.

Transparency log

Release files / tepilora_mcp-0.5.7-py3-none-any.whl

Download URL tepilora_mcp-0.5.7-py3-none-any.whl
Size 24.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
44a5a010865b7cfdbc0e14c99ad0d7f1fe52042a1f169aa5af6f3e7551676df3
BLAKE2b-256 checksum
How to use checksums
425ca968004ae55778762a61442a8ffedde65dac8468d2de5021f348bffcb11d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 12, 2026.

Transparency log

Security for tepilora-mcp 0.5.7

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for tepilora_mcp-0.5.7.tar.gz

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 Nov 12, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.5.7 This release

2 release files Full provenance

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