Skip to content

nvasilevv/pensiata-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 

Repository files navigation

Pensiata MCP Server

A Model Context Protocol server providing analytics for Bulgarian pension funds — covering all three pillar II schemes (UPF, PPF, DPF).

Hosted at: https://mcp.pensiata.me/mcp (streamable HTTP transport)

Connect

Add to your MCP client configuration:

{
  "mcpServers": {
    "pensiata": {
      "type": "streamable-http",
      "url": "https://mcp.pensiata.me/mcp"
    }
  }
}

No API key required.

Tools

list_managers

List pension fund management companies with AUM and supported schemes.

Parameter Type Description
scheme_code upf | ppf | dpf (optional) Filter by scheme

list_funds

List individual funds with metadata.

Parameter Type Description
scheme_code upf | ppf | dpf (optional) Filter by scheme
active_only bool (default: true) Only active funds

get_nav_series

Retrieve NAV (Net Asset Value) time series for one or more funds.

Parameter Type Description
fund_id string (optional) e.g. allianz:upf
manager_slug string (optional) All funds for a manager
scheme_code upf | ppf | dpf (optional) All funds in a scheme
frequency daily | weekly | monthly Default: daily
date_from string (optional) Start date (YYYY-MM-DD)
date_to string (optional) End date (YYYY-MM-DD)

compute_metric

Compute a performance metric for one or more funds over a given period.

Parameter Type Description
metric string Metric name (see below)
period string or object e.g. "5y", "10y", "ytd", or {"date_from": "...", "date_to": "..."}
fund_id string (optional) Specific fund
manager_slug string (optional) All funds for a manager
scheme_code upf | ppf | dpf (optional) All funds in a scheme
benchmark_slug string (optional) Benchmark or fund ID for relative metrics
frequency daily | weekly | monthly Default: daily
risk_free_rate number (optional) Override risk-free rate
risk_free_slug string (optional) Benchmark to use as risk-free rate

rank

Rank funds within a scheme by any metric.

Parameter Type Description
scheme_code upf | ppf | dpf Required
metric string Metric to rank by
period string or object Time period
order desc | asc Default: desc
include_metrics string[] (optional) Additional metrics in output
benchmark_slug string (optional) For relative metrics
limit int Default: 50
offset int Default: 0

list_benchmarks

List available benchmark indices (S&P 500, Euro Stoxx 600, Gold, BG Inflation, etc.).

get_benchmark_series

Retrieve benchmark time series.

Parameter Type Description
benchmark_slug string e.g. sp500, bg_inflation, gold
frequency daily | weekly | monthly Default: daily
date_from string (optional) Start date
date_to string (optional) End date

list_metrics

List all available metric names.

Available Metrics

Metric Description
return_total Cumulative total return
cagr Compound annual growth rate
real_cagr Inflation-adjusted CAGR
ytd_return Year-to-date return
volatility_ann Annualized volatility
downside_volatility_ann Annualized downside volatility
max_drawdown Maximum drawdown
sharpe Sharpe ratio
sortino Sortino ratio
calmar Calmar ratio
information_ratio Information ratio (vs benchmark)
tracking_error_ann Annualized tracking error
excess_return Excess return vs benchmark
correlation Correlation with benchmark or another fund
ulcer_index Ulcer index
consistency_score Return consistency score

Available Benchmarks

Slug Description
sp500 S&P 500 (USD)
eurostoxx600 STOXX Europe 600 (USD)
gold Gold (USD)
bg_inflation Bulgarian CPI Inflation
us10y_gov_bond US 10Y Government Bond (USD)
de10y_gov_bond German 10Y Government Bond (EUR)

Coverage

  • Schemes: UPF (Universal Pension Fund), PPF (Professional Pension Fund), DPF (Voluntary Pension Fund)
  • Managers: 10 active + 2 historical pension management companies
  • Data: Daily NAV data, some funds dating back to 2005
  • Currency: BGN

Website

pensiata.me

License

MIT

Releases

No releases published

Packages

 
 
 

Contributors