Financier docs

Financier

Financier の公式エージェントおよび開発者向けツールです。Financier は、本人の銀行データに基づいて作成する個人向け財務プランです。Financier は API ファーストです。アプリでできることはすべて、エージェントが 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）
エージェントスキル	skills/financier/SKILL.md
エージェントプラグイン	plugin.json + mcp.json
MCP レジストリ	sh.financier/financier、sh.financier/financier-docs
A2A 1.0	エージェントカード、https://financier.sh/a2a の JSON-RPC
ドキュメントへの質問（NLWeb）	POST https://financier.sh/ask
アカウント不要のエージェント ID	POST https://financier.sh/agent/identity（本人が申し立てるまではサンドボックス専用）
Webhook	Standard Webhooks + Web Bot Auth（鍵）
エージェントインデックス	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 の鍵ディレクトリを使って検証できます。

アカウントを持たないエージェント

エージェントは、本人が関与する前から利用を開始できます。POST /agent/identity {"type":"anonymous"} を呼び出すと、サンドボックス専用の ID と申し立てトークンが返されます。本人がエージェントに実際のアカウントで作業させたい場合、エージェントは本人のメールアドレスを使って申し立てを開始し、コードを本人に提示します。その後、本人が 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、エージェントスキル、プラグインマニフェスト、MCP レジストリエントリといった公開部分が含まれています。SDK の型は、最新の OpenAPI ドキュメントから生成されます（bun run generate）。

ライセンス

MIT