Pensiata - Bulgarian Pension Fund Analytics

io.github.nvasilevv由 GitHub 帳號 nvasilevv 發布v1.0.0更新於 Oct 25, 2026

Bulgarian pension fund analytics — NAV data, metrics, rankings, and benchmarks.

已驗證Streamable HTTP可網頁執行金融知識與記憶資料與分析

概覽

AI 產生的概覽

針對保加利亞退休基金的遠端 MCP 伺服器,提供淨值序列、績效指標、排名、基準、持股報告與退休金法規檢索。

可以做什麼
探索退休基金管理公司、基金與基準,並列出可用指標目錄、持股報告索引或快取統計以供診斷。依可設定的日期與頻率取得 UPF、PPF、DPF 基金的淨值與基準時間序列。計算 CAGR、實質 CAGR、波動率、回撤、Sharpe、Sortino、Calmar、追蹤誤差與相關性等指標,可對照基準。依選定指標與區間對基金或基準排名,並可附加額外指標欄位。模擬定期提撥的儲蓄者結果,包括投入金額、終值與類 IRR 診斷。讀取 Markdown 持股報告,並檢索或讀取保加利亞退休金法律框架。
適用情境
適合比較保加利亞第二支柱退休基金或管理公司、查看歷史淨值表現、與通膨或市場指數對比、估算儲蓄者結果,以及查詢基金持股與退休金法規時使用。
執行需求
遠端 streamable HTTP 端點;無需 API 金鑰,未宣告本機執行環境或環境變數。需要能連線至該託管端點的網路。
安裝前請注意
此伺服器為唯讀分析:回傳資料與計算結果,不執行交易或資金移轉。模擬結果是依歷史淨值資料的估算,不構成投資建議或保證。資料反映最新擷取的官方 FSC 資料,可能落後於來源。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Pensiata - Bulgarian Pension Fund Analytics,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.nvasilevv%2Fpensiata/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "pensiata-bulgarian-pension-fund-analytic": {
      "type": "http",
      "url": "https://mcp.pensiata.me/mcp"
    }
  }
}

README

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:

json
{  "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.

ParameterTypeDescription
scheme_codeupf | ppf | dpf (optional)Filter by scheme

list_funds

List individual funds with metadata.

ParameterTypeDescription
scheme_codeupf | ppf | dpf (optional)Filter by scheme
active_onlybool (default: true)Only active funds

get_nav_series

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

ParameterTypeDescription
fund_idstring (optional)e.g. allianz:upf
manager_slugstring (optional)All funds for a manager
scheme_codeupf | ppf | dpf (optional)All funds in a scheme
frequencydaily | weekly | monthlyDefault: daily
date_fromstring (optional)Start date (YYYY-MM-DD)
date_tostring (optional)End date (YYYY-MM-DD)

compute_metric

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

ParameterTypeDescription
metricstringMetric name (see below)
periodstring or objecte.g. "5y", "10y", "ytd", or {"date_from": "...", "date_to": "..."}
fund_idstring (optional)Specific fund
manager_slugstring (optional)All funds for a manager
scheme_codeupf | ppf | dpf (optional)All funds in a scheme
benchmark_slugstring (optional)Benchmark or fund ID for relative metrics
frequencydaily | weekly | monthlyDefault: daily
risk_free_ratenumber (optional)Override risk-free rate
risk_free_slugstring (optional)Benchmark to use as risk-free rate

rank

Rank funds within a scheme by any metric.

ParameterTypeDescription
scheme_codeupf | ppf | dpfRequired
metricstringMetric to rank by
periodstring or objectTime period
orderdesc | ascDefault: desc
include_metricsstring[] (optional)Additional metrics in output
benchmark_slugstring (optional)For relative metrics
limitintDefault: 50
offsetintDefault: 0

list_benchmarks

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

get_benchmark_series

Retrieve benchmark time series.

ParameterTypeDescription
benchmark_slugstringe.g. sp500, bg_inflation, gold
frequencydaily | weekly | monthlyDefault: daily
date_fromstring (optional)Start date
date_tostring (optional)End date

list_metrics

List all available metric names.

Available Metrics

MetricDescription
return_totalCumulative total return
cagrCompound annual growth rate
real_cagrInflation-adjusted CAGR
ytd_returnYear-to-date return
volatility_annAnnualized volatility
downside_volatility_annAnnualized downside volatility
max_drawdownMaximum drawdown
sharpeSharpe ratio
sortinoSortino ratio
calmarCalmar ratio
information_ratioInformation ratio (vs benchmark)
tracking_error_annAnnualized tracking error
excess_returnExcess return vs benchmark
correlationCorrelation with benchmark or another fund
ulcer_indexUlcer index
consistency_scoreReturn consistency score

Available Benchmarks

SlugDescription
sp500S&P 500 (USD)
eurostoxx600STOXX Europe 600 (USD)
goldGold (USD)
bg_inflationBulgarian CPI Inflation
us10y_gov_bondUS 10Y Government Bond (USD)
de10y_gov_bondGerman 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

來源:README.md,提交 d73fa5b

工具

26

list_managers

Retrieve Bulgarian pension manager metadata for UPF, PPF, and VPF/DPF schemes. Use this to discover licensed managers and their supported scheme types before running rankings or metric calculations over FSC-tracked pension data. Data freshness: reflects latest ingested official FSC manager/scheme coverage.

輸入參數scheme_code

list_funds

List Bulgarian private pension funds and canonical fund IDs. Returns `fund_id` in `manager_slug:scheme_code` format for UPF, PPF, and VPF/DPF. Use this as discovery before calling NAV, metric, and ranking tools. Data freshness: fund metadata follows latest FSC-tracked manager/scheme dataset.

輸入參數active_onlyscheme_code

get_nav_series

Get official NAV time series for a Bulgarian pension fund (UPF/PPF/VPF). Accepts either `fund_id` or (`manager_slug`, `scheme_code`) and returns normalized NAV points for return/risk calculations and charting. Data freshness: updated as new source NAV observations are ingested.

輸入參數date_tofund_iddate_fromfrequencyscheme_codemanager_slug

list_benchmarks

List benchmark assets for Bulgarian pension comparisons. Includes inflation and market references used to evaluate relative performance of UPF, PPF, and VPF/DPF funds. Data freshness: benchmark metadata is stable; prices are updated as new source data arrives.

無需輸入參數。

list_metrics

List all supported financial metric identifiers for MCP analytics tools.

無需輸入參數。

cache_stats

Return MCP cache telemetry for diagnostics and performance debugging.

無需輸入參數。

get_benchmark_series

Get historical benchmark series for pension-fund comparison workflows. Use with compute/rank tools to compare Bulgarian pension funds against inflation or market proxies over aligned periods. Data freshness: updated as new benchmark source observations become available.

輸入參數date_todate_fromfrequencybenchmark_slug必填

compute_metric

Compute a metric for Bulgarian pension funds or benchmark targets. Supports returns, drawdown, volatility, Sharpe/Sortino/Calmar, correlation, and benchmark-aware metrics over configurable period and frequency. Data freshness: computed from latest ingested FSC NAV and benchmark data.

輸入參數metric必填period必填windowfund_idfrequencyscheme_codemanager_slugbenchmark_slugrisk_free_raterisk_free_slugbenchmark_target_slug

rank

Rank funds within UPF/PPF/VPF schemes by a selected metric and period. Supports optional extra columns via `include_metrics` for agent-friendly table outputs. Data freshness: rankings are computed from the latest ingested FSC-aligned NAV dataset.

輸入參數limitordermetric必填offsetperiod必填windowfrequencyscheme_code必填benchmark_slugrisk_free_rateinclude_metrics

rank_benchmarks

Rank benchmark assets by metric and period for market-context comparison. Data freshness: rankings reflect latest ingested benchmark observations.

輸入參數limitordermetric必填offsetperiod必填windowfrequencybenchmark_slugrisk_free_rateinclude_metrics

simulate_saver_outcome

Simulate saver outcomes with periodic contributions into Bulgarian pension funds. Estimates invested amount, terminal value, and IRR-like performance diagnostics. Data freshness: simulation uses the latest available NAV history in the dataset.

輸入參數fund_idend_datestart_datescheme_code必填manager_slugmonthly_contribution必填

get_bulgarian_pension_fund_managers

Alias for `list_managers` with explicit Bulgarian pension context for agent discovery.

輸入參數scheme_code

get_bulgarian_pension_funds

Alias for `list_funds` to discover UPF/PPF/VPF fund IDs for FSC-based analysis.

輸入參數active_onlyscheme_code

get_bulgarian_pension_fund_nav_series

Alias for `get_nav_series` with explicit pension NAV semantics for tool-RAG routing.

輸入參數date_tofund_iddate_fromfrequencyscheme_codemanager_slug

get_bulgarian_pension_benchmarks

Alias for `list_benchmarks` with Bulgarian pension comparison context.

無需輸入參數。

get_bulgarian_pension_metrics_catalog

Alias for `list_metrics` so agents can semantically find available pension metrics.

無需輸入參數。

get_bulgarian_pension_benchmark_series

Alias for `get_benchmark_series` to retrieve inflation/market comparators for UPF/PPF/VPF.

輸入參數date_todate_fromfrequencybenchmark_slug必填

get_bulgarian_pension_fund_metric

Alias for `compute_metric` with explicit Bulgarian pension metric intent.

輸入參數metric必填period必填windowfund_idfrequencyscheme_codemanager_slugbenchmark_slugrisk_free_raterisk_free_slugbenchmark_target_slug

rank_bulgarian_pension_funds_by_metric

Alias for `rank` to semantically target Bulgarian UPF/PPF/VPF leaderboard queries.

輸入參數limitordermetric必填offsetperiod必填windowfrequencyscheme_code必填benchmark_slugrisk_free_rateinclude_metrics

rank_bulgarian_pension_benchmarks_by_metric

Alias for `rank_benchmarks` for semantically rich benchmark ranking discovery.

輸入參數limitordermetric必填offsetperiod必填windowfrequencyscheme_codebenchmark_slugrisk_free_rateinclude_metrics

simulate_bulgarian_pension_saver_outcome

Alias for `simulate_saver_outcome` with explicit Bulgarian pension savings semantics.

輸入參數end_datedate_fromscheme_codemanager_slugmonthly_amount

list_holdings_reports

List available markdown holdings reports for Bulgarian pension funds. Reports contain detailed portfolio holdings data extracted from official PDF filings and converted to structured markdown with metadata (allocation %, exposure, top holdings). Use this tool to discover what reports are available before loading specific ones with `read_holdings_report`. Filter by manager, fund type, or date range.

輸入參數date_todate_fromfund_typemanager_slug

get_holdings_reports_index

Get a lightweight summary index of pension fund holdings reports. Returns allocation metadata (equity %, domestic %, funds %) and top holdings for each report without loading full content. Use this for quick discovery to decide which reports to load in full with `read_holdings_report`.

輸入參數date_todate_fromfund_typemanager_slug

read_holdings_report

Read a specific markdown holdings report for a Bulgarian pension fund. Returns the full markdown content (or just metadata if summary_only=True) for a specific manager, fund type, and date. The report includes detailed portfolio holdings with instrument types, issuers, values, and portfolio shares.

輸入參數date必填fund_type必填manager_slug必填summary_only

search_pension_law

Search across Bulgarian pension legal framework documents.

輸入參數query必填documentmax_results

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分