Financier

Name: Financier
Author: financier.sh

远程服务

financier.sh金融数据05 周前更新

代码仓库访问官网

关于 Financier

Financier 提供 Agent 和开发者工具，可根据个人银行数据制定财务计划。Agent 可通过 MCP、REST API、SDK 或 CLI 使用与应用相同的功能。

主要功能

01根据银行数据制定财务计划
02分类支出并识别定期项目
03查看计划阶段和月度数据
04使用 REST API、TypeScript SDK 或 CLI
05接收签名 Webhook 事件

适用场景

01使用沙盒家庭账户制定计划
02查看月结余和计划行动
03按商户和日期汇总支出
04在计划生成时通知集成端

MCP 相关

Financier 通过 `https://financier.sh/mcp` 的 MCP 服务提供财务功能，使用 Streamable HTTP，并支持 OAuth 2.1 或 API 密钥。另有无需凭据的文档 MCP 服务。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://financier.sh/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http sh-financier-financier https://financier.sh/mcp

Cursor.cursor/mcp.json{"mcpServers":{"sh-financier-financier":{"type":"http","url":"https://financier.sh/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"sh-financier-financier":{"type":"http","url":"https://financier.sh/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"sh-financier-financier":{"type":"http","url":"https://financier.sh/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"sh-financier-financier":{"serverUrl":"https://financier.sh/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

Financier

Financier 的官方 Agent 和开发者工具：Financier 是一款基于个人银行数据构建的个人财务规划工具。Financier 以 API 为先。用户在应用中能做的一切，Agent 都可以通过 MCP、REST API、此 SDK 或此 CLI 完成。


MCP 服务	`https://financier.sh/mcp`（Streamable HTTP；OAuth 2.1 或 `x-api-key`）
文档 MCP 服务	`https://financier.sh/mcp/docs`（无需凭据）
REST API	`https://financier.sh/api/v1`、OpenAPI、参考文档
TypeScript SDK	`@financier-sh/sdk`
CLI	`@financier-sh/cli`（`financier`）
Agent 技能	`skills/financier/SKILL.md`
Agent 插件	`plugin.json` + `mcp.json`
MCP 注册表	`sh.financier/financier`、`sh.financier/financier-docs`
A2A 1.0	Agent 卡片，JSON-RPC 地址为 `https://financier.sh/a2a`
咨询文档（NLWeb）	`POST https://financier.sh/ask`
Agent 身份，无需账户	`POST https://financier.sh/agent/identity`（仅限沙盒，直到用户认领）
Webhook	Standard Webhooks + Web Bot Auth（密钥）
Agent 索引	llms.txt、auth.md

目前账户仅限受邀用户使用。沙盒银行（提供方 demo）会为每个账户创建一个合成家庭，供用户体验所有功能。

MCP

{
  "mcpServers": {
    "financier": { "type": "http", "url": "https://financier.sh/mcp" }
  }
}

Claude Code：claude mcp add --transport http financier https://financier.sh/mcp

SDK

npm install @financier-sh/sdk

import { createFinancier } from "@financier-sh/sdk";

const financier = createFinancier({ apiKey: process.env.FINANCIER_API_KEY });
await financier.connections.linkSandbox();
for await (const event of financier.plan.buildStream()) console.log(event.stage);
const view = await financier.plan.view();
console.log(view?.stages[view.current]?.name, view?.plan.monthly.surplus);

Webhook

import { verifyWebhook } from "@financier-sh/sdk";

// In your handler: the raw body, the request headers, and the secret from webhooks.create.
if (!(await verifyWebhook(rawBody, request.headers, process.env.FINANCIER_WEBHOOK_SECRET!)))
  return new Response("bad signature", { status: 401 });

事件：plan.built、recurring.detected、bank.reconnect_required、webhook.test。每次投递也都会使用 Web Bot Auth 签名，可通过 financier.sh 的密钥目录验证，无需共享密钥。

无账户的 Agent

即使还没有用户参与，Agent 也可以启动：POST /agent/identity {"type":"anonymous"} 会返回仅限沙盒使用的身份和认领令牌。当用户希望 Agent 操作其真实账户时，Agent 会使用用户的电子邮箱发起认领，向用户展示代码，用户则在 financier.sh/claim 批准认领。完整流程及请求示例见 auth.md。

CLI

npm install -g @financier-sh/cli
financier login          # paste an API key from Settings, Developer
financier sandbox        # link the synthetic household
financier build          # sync, categorise, build the plan
financier plan           # stage, monthly figures, actions
financier plan --json    # the same, for scripts and agents
financier spending --from 2026-08-01 --by merchant
financier webhooks add https://example.com/hooks/financier --events plan.built