Financier

sh.financier由 financier.sh 发布官方发布者v1.0.0更新于 Oct 24, 2026

Personal finance plan from a person's own bank data: stage, budget, categories, decisions.

已验证Streamable HTTP可网页运行金融数据与分析

概览

AI 生成的概览

Financier 的远程 MCP 服务器让助手基于个人银行数据生成的个人财务计划工作:阶段、预算、分类和决策

可以做什么
查看基于已关联银行数据生成的个人财务计划:当前阶段、月度数字与结余,以及建议的操作。同步并分类交易,然后构建计划并跟踪进度。按日期范围和商户查看支出。管理计划与银行事件的 webhook 订阅。README 称用户在应用里能做的事,代理都能通过 MCP、REST API、SDK 或 CLI 完成。
适用场景
当助手需要帮助用户理解或处理其本人的 Financier 计划时使用,例如查看预算阶段、按商户查看支出或计划操作。若只想查询文档,另有无需凭据的文档 MCP 端点。
运行要求
远程 Streamable HTTP 端点 financier.sh/mcp。认证方式为 OAuth 2.1 或 x-api-key 凭据。账户目前仅限邀请;demo 沙盒银行可为任意账户提供合成家庭数据用于试用。代理可先以仅限沙盒的匿名身份开始,之后由用户认领。
安装前请注意
它处理真实的个人银行数据,访问权限敏感。需要 OAuth 或 x-api-key 凭据,应妥善保密。服务器可同步和分类交易并构建计划,会改动数据。webhook 订阅会把计划和银行事件发送到外部网址。应用本身是私有的,此仓库只包含公开的 SDK、CLI 和代理接口。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Financier,将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/sh.financier%2Ffinancier/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

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

README

Financier

Official agent and developer tooling for Financier: a personal finance plan built from a person's own bank data. Financier is API-first. Everything a person can do in the app, an agent can do over MCP, the REST API, this SDK or this CLI.

MCP serverhttps://financier.sh/mcp (Streamable HTTP; OAuth 2.1 or x-api-key)
Docs MCP serverhttps://financier.sh/mcp/docs (no credentials)
REST APIhttps://financier.sh/api/v1, OpenAPI, reference
TypeScript SDK@financier-sh/sdk
CLI@financier-sh/cli (financier)
Agent skillskills/financier/SKILL.md
Agent pluginplugin.json + mcp.json
MCP registrysh.financier/financier, sh.financier/financier-docs
A2A 1.0agent card, JSON-RPC at https://financier.sh/a2a
Ask the docs (NLWeb)POST https://financier.sh/ask
Agent identity, no accountPOST https://financier.sh/agent/identity (sandbox-only until a person claims it)
WebhooksStandard Webhooks + Web Bot Auth (keys)
Agent indexllms.txt, auth.md

Accounts are invite-only for now. The sandbox bank (provider demo) gives any account a synthetic household to try everything on.

MCP

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

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

SDK

sh
npm install @financier-sh/sdk
ts
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);

Webhooks

ts
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 });

Events: plan.built, recurring.detected, bank.reconnect_required, webhook.test. Every delivery is also signed with Web Bot Auth, verifiable against financier.sh's key directory without a shared secret.

Agents without an account

An agent can start before any person is involved: POST /agent/identity {"type":"anonymous"} returns a sandbox-only identity and a claim token. When a person wants the agent to work on their real account, the agent starts a claim with their email, shows them the code, and the person approves it at financier.sh/claim. The full flow, with requests, is in auth.md.

CLI

sh
npm install -g @financier-sh/clifinancier login          # paste an API key from Settings, Developerfinancier sandbox        # link the synthetic householdfinancier build          # sync, categorise, build the planfinancier plan           # stage, monthly figures, actionsfinancier plan --json    # the same, for scripts and agentsfinancier spending --from 2026-08-01 --by merchantfinancier webhooks add https://example.com/hooks/financier --events plan.built

This repository

The Financier app itself is private. This repository holds the public surface: the SDK, the CLI, the agent skill, the plugin manifest and the MCP registry entries. The SDK's types are generated from the live OpenAPI document (bun run generate).

License

MIT

来源:README.md,提交 ca72fd0

工具

0
该服务器需要登录,因此 SourceWeft 无法在没有账号的情况下读取其工具,也未收录。已连接账号所能看到的内容可能因账号及其权限而异。

版本历史

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

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Financier 集成