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_re

... View full README on GitHub