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 分