Financier docs

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

此仓库

Financier 应用本身为私有项目。此仓库包含公开部分：SDK、CLI、Agent 技能、插件清单和 MCP 注册表条目。SDK 的类型由实时 OpenAPI 文档生成（bun run generate）。

许可证

MIT