项目介绍
Fi MCP 文档
概述
Fi MCP（模型上下文协议）为Fi Money平台用户提供全面的财务数据访问。此MCP使开发者能够构建应用程序，分析用户的财务健康状况，提供见解，并基于实际账户数据创建个性化的财务建议。
可用工具
1. fetch_net_worth
目的：使用连接账户的实际数据计算综合净资产
用例：
- 投资组合分析和资产配置见解
- 净资产跟踪和可视化
- 财务健康评估
- 投资表现分析
- 债务与资产比率计算
数据来源：
- 银行账户余额
- 共同基金持有量及当前价值
- 印度股票投资组合持有量
- 美国股票投资（如果通过Fi Money应用进行投资）
- EPF账户余额
- 信用卡债务和贷款余额
- 其他连接的资产/负债
{
"netWorthResponse": {
"totalNetWorthValue": {
"currencyCode": "string" // 例如：INR
"units": "string" // 例如：总净资产金额
},
"assetValues": [
{
"netWorthAttribute": "string" // 例如：ASSET_TYPE_EPF
"value": {
"currencyCode": "string" // 例如：INR
"units": "string" // 例如：单个资产的价值
}
}
// 只显示了一个样本资产
]
},
"mfSchemeAnalytics": {
"schemeAnalytics": [
{
"schemeDetail": {
"amc": "string" // 例如：QUANT_MONEY_MANAGERS
"nameData": {
"longName": "string" // 例如：基金名称
},
"planType": "string" // 例如：DIRECT
"investmentType": "string" // 例如：OPEN
"optionType": "string" // 例如：GROWTH
"nav": {
"currencyCode": "string" // 例如：INR
"units": "string" // 例如：NAV整数部分
"nanos": "number" // 例如：NAV小数部分
},
"assetClass": "string" // 例如：EQUITY
"isinNumber": "string" // 例如：INF123L01234
"categoryName": "string" // 例如：ELSS_TAX_SAVING
"fundhouseDefinedRiskLevel": "string" // 例如：VERY_HIGH_RISK
},
"enrichedAnalytics": {
"analytics": {
"schemeDetails": {
"currentValue": {
"currencyCode": "string"
"units": "string"
"nanos": "number"
},
"investedValue": {
"currencyCode": "string"
"units": "string"
"nanos": "number"
},
"XIRR": "number" // 例如：%回报率
"absoluteReturns": {
"currencyCode": "string"
"units": "string"
"nanos": "number"
},
"unrealisedReturns": {
"currencyCode": "string"
"units": "string"
"nanos": "number"
},
"navValue": {
"currencyCode": "string"
"units": "string"
"nanos": "number"
},
"units": "number" // 例如：123.01
}
}
}
}
]
},
"accountDetailsBulkResponse": {
"accountDetailsMap": {
"accountId": {
"accountDetails": {
"fipId": "string" // 例如：KotakMahindraBank-FIP
"maskedAccountNumber": "string" // 例如：XXXXXX1234
"accInstrumentType": "string" // 例如：ACC_INSTRUMENT_TYPE_DEPOSIT
"ifscCode": "string" // 例如：ABCD0000123
"accountType": {
"depositAccountType": "string" // 例如：DEPOSIT_ACCOUNT_TYPE_SAVINGS
},
"fipMeta": {
"name": "string" // 例如：Kotak Mahindra Bank
"displayName": "string" // 例如：Kotak
"bank": "string" // 例如：KOTAK
}
},
"depositSummary": {
"accountId": "string"
"currentBalance": {
"currencyCode": "string"
"units": "string"
"nanos": "number"
},
"balanceDate": "ISODate" // 例如：2025-01-01T11:59:59.149Z
"depositAccountType": "string"
"branch": "string"
"ifscCode": "string"
"openingDate": "ISODate"
"depositAccountStatus": "string"
},
"equitySummary": {
"accountId": "string"
"currentValue": {
"currencyCode": "string"
"units": "string"
"nanos": "number"
},
"holdingsInfo": [
{
"isin": "string" // 例如：INE00H001014
"issuerName": "string" // 例如：EPIFI LIMITED
"type": "string" // 例如：EQUITY_HOLDING_TYPE_DEMAT
"units": "number" // 例如：持有的数量
"lastTradedPrice": {
"currencyCode": "string"
"units": "string"
"nanos": "number"
},
"isinDescription": "string" // 例如：EPIFI LIMITED-EQ
}
]
}
}
}
}
}
错误处理：
- 如果没有连接金融账户，则返回空结果
- 如果未检测到共同基金账户，则提示用户连接
- 仅包括来自连接账户的数据（不包含估算值）
2. fetch_credit_report
目的：检索全面的信用报告信息
用例：
- 信用评分监控
- 根据利率优先考虑贷款
- 信用利用率分析
包含的数据：
- 信用评分
- 活动、关闭贷款详情及其利率
- 信用卡利用率
- 最近的信用查询
- 出生日期信息
{
"creditReports": [
{
"creditReportData": {
"userMessage": {
"userMessageText": "string" // 例如：正常响应
},
"creditProfileHeader": {
"reportDate": "string" // 例如：20250101
"reportTime": "string" // 例如：235959
},
"currentApplication": {
"currentApplicationDetails": {
"enquiryReason": "string" // 例如：6
"amountFinanced": "string" // 例如：0
"durationOfAgreement": "string" // 例如：0
"currentApplicantDetails": {
"dateOfBirthApplicant": "string" // 例如：19690131
}
}
},
"creditAccount": {
"creditAccountSummary": {
"account": {
"creditAccountTotal": "string" // 例如：2
"creditAccountActive": "string" // 例如：2
"creditAccountDefault": "string" // 例如：0
"creditAccountClosed": "string" // 例如：0
"cadSuitFiledCurrentBalance": "string" // 例如：0
},
"totalOutstandingBalance": {
"outstandingBalanceSecured": "string" // 例如：10000
"outstandingBalanceSecuredPercentage": "string" // 例如：20
"outstandingBalanceUnSecured": "string" // 例如：40000
"outstandingBalanceUnSecuredPercentage": "string" // 例如：80
"outstandingBalanceAll": "string" // 例如：50000
}
},
"creditAccountDetails": [
{
"identificationNumber": "string" // 例如：AV12345678
"subscriberName": "string" // 例如：Federal Bank
"portfolioType": "string" // 例如：R
"accountType": "string" // 例如：10
"openDate": "string" // 例如：20250101
"creditLimitAmount": "string" // 例如：500000
"highestCreditOrOriginalLoanAmount": "string" // 例如：80000
"accountStatus": "string" // 例如：11
"paymentRating": "string" // 例如：0
"paymentHistoryProfile": "string" // 例如：000000000000000000000000?00000000000
"currentBalance": "string" // 例如：0
"amountPastDue": "string" // 例如：0
"dateReported": "string" // 例如：20250701
"dateOfLastPayment": "string" // 例如：20250701
"repaymentTenure": "string" // 例如：0
"dateOfAddition": "string" // 例如：20220101
"currencyCode": "string" // 例如：INR
"accountHolderTypeCode": "string" // 例如：1
}
]
},
"matchResult": {
"exactMatch": "string" // 例如：Y
},
"totalCapsSummary": {
"totalCapsLast7Days": "string" // 例如：0
"totalCapsLast30Days": "string" // 例如：0
"totalCapsLast90Days": "string" // 例如：0
"totalCapsLast180Days": "string" // 例如：0
},
"nonCreditCaps": {
"nonCreditCapsSummary": {
"nonCreditCapsLast7Days": "string" // 例如：0
"nonCreditCapsLast30Days": "string" // 例如：0
"nonCreditCapsLast90Days": "string" // 例如：0
"nonCreditCapsLast180Days": "string" // 例如：0
}
},
"score": {
"bureauScore": "string" // 例如：800
},
"caps": {
"capsSummary": {
"capsLast7Days": "string" // 例如：0
"capsLast30Days": "string" // 例如：0
"capsLast90Days": "string" // 例如：0
"capsLast180Days": "string" // 例如：0
},
}
},
"vendor": "EXPERIAN"
}
]
}
错误处理：
- 如果未连接，则返回“无可用信用评分数据”
- 提示用户在Fi Money应用中连接信用档案
3. fetch_epf_details
目的：访问雇员公积金账户信息
用例：
- 退休规划计算
- 公积金贡献追踪
- 利息收益分析
- 雇主贡献验证
包含的数据：
- 当前账户余额
- 雇主和就业详情
- 总员工贡献
- 总雇主贡献
{
"uanAccounts": [
{
"phoneNumber": {}, // 对象（结构未指定）
"rawDetails": {
"est_details": [
{
"est_name": "string", // 例如：公司名称
"member_id": "string", // 例如：RJRAJ12345690000012345
"office": "string", // 例如：(RO)JAIPUR
"doj_epf": "string", // 例如：01-01-2020
"doe_epf": "string", // 例如：01-01-2025
"doe_eps": "string", // 例如：01-01-2025
"pf_balance": {
"is_pf_full_withdrawn": true, // 布尔值
"employee_share": {
"debit": "string", // 例如：12345
"credit": "string" // 例如：12345
},
"employer_share": {
"debit": "string", // 例如：1234
"credit": "string" // 例如：1234
}
}
},
"overall_pf_balance": {
"pension_balance": "string", // 例如：12345
"current_pf_balance": "string", // 例如：54321
"employee_share_total": {
"debit": "string", // 例如：12345
"credit": "string", // 例如：54321
"balance": "string" // 例如：12345
},
"employer_share_total": {
"debit": "string", // 例如：1234
"credit": "string", // 例如：12345
"balance": "string" // 例如：123456
}
}
}
}
]
}
错误处理：
- 如果未连接，引导用户通过Fi Money应用链接EPF账户
4. fetch_mf_transactions
目的：检索共同基金交易历史以进行投资组合分析
用例：
- 扩展内部收益率（XIRR）计算
- 投资表现跟踪
- 交易模式分析
- 投资组合再平衡见解
当前范围：
- 共同基金交易（购买、出售、定期定额等）
- 交易日期和金额
- 按基金划分的交易历史
{
"transactions": [
{
"isinNumber": "string", // 例如：INF123L01234
"folioId": "string", // 例如：1234567890
"externalOrderType": "string", // 例如：BUY
"transactionDate": "string", // 例如：2025-01-01T23:59:59Z（ISO格式）
"purchasePrice": {
"currencyCode": "string", // 例如：INR
"units": "string", // 例如：250
"nanos": "number" // 例如：785200000
},
"transactionAmount": {
"currencyCode": "string", // 例如：INR
"units": "string", // 例如：9999
"nanos": "number" // 例如：500000000
},
"transactionUnits": "number", // 例如：98.765
"transactionMode": "string", // 例如：N
"schemeName": "string", // 例如：Epifi Tax Saver Fund - Direct Plan
"stampDuty": "number" // 例如：0.1
}
]
}
关于响应结构的说明：
purchasePrice：执行交易时的净值transactionAmount：投资或赎回的总金额transactionUnits：购买或出售的单位数量transactionMode：正常模式为"N"，其他模式可能包括定期定额等externalOrderType：购买为"BUY"，赎回为"SELL"- 金额使用
units（主要金额）和nanos（小数部分）结构 - 使用此交易数据需要单独计算XIRR
错误处理：
- 返回可用数据并明确指示限制
- 指明哪些交易类型未包含
- 定期定额绩效评估器
5. fetch_bank_transactions
目的：访问连接到Fi Money应用的银行交易数据
用例：
- 连接到Fi Money应用的所有银行交易数据
包含的数据：
- 交易金额
- 交易说明
- 交易日期
- 交易后当前余额
{
"schemaDescription": "一个银行交易列表。每个'txns'字段是一个数据数组列表，其模式为：[transactionAmount, transactionNarration, transactionDate, transactionType（1表示CREDIT，2表示DEBIT，3表示OPENING，4表示INTEREST，5表示TDS，6表示INSTALLMENT，7表示CLOSING和8表示OTHERS），transactionMode，currentBalance]。\n我们目前只有最近两个月的交易记录，更早的交易记录即将推出...",
"bankTransactions": [
{
"bank": "HDFC Bank",
"txns": [
[
"80085",
"UPI-SHEETAL RAVINDRA DA-SHEETAL