English Français العربية

FYN

Official registry Finance and payments

Personal finance for AI agents: budgets, receipts, net worth, spend checks. Read-only OAuth.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http fyn 'https://mcp.fyn.fyi'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "fyn": {
            "type": "http",
            "url": "https://mcp.fyn.fyi"
        }
    }
}
Remote (streamable-http)
Claude Code 
claude mcp add --transport http fyn 'https://api.fyn.fyi/v1/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "fyn": {
            "type": "http",
            "url": "https://api.fyn.fyi/v1/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. FYN Finance Agent Skill
  2. What is this?
  3. Install
  4. Quick Start
  5. API Endpoints
  6. Rate Limits
  7. Examples
  8. Authentication
  9. Links
  10. License

FYN Finance Agent Skill

The official AI agent skill for FYN — personal finance with bank syncing, receipt AI, and spending intelligence.

What is this?

This is a ClawHub skill package that lets any AI agent (OpenClaw, Clank, or any agent with HTTP tools) access your personal financial data through FYN.

Your agent can:

  • Query bank transactions and spending patterns
  • Check account balances and net worth
  • Monitor budgets and subscriptions
  • Get daily briefings, alerts, and financial health scores
  • Ask natural language questions about your finances
  • Search receipts with AI (Pro)
  • Check affordability of purchases (Pro)

Install

clawhub install fyn-finance

Or manually: copy SKILL.md into your agent's skill directory.

Quick Start

  1. Sign up at fyn.fyi (free)
  2. Connect your bank accounts via Plaid
  3. Generate an API key at Settings > Agent Access
  4. Set FYN_API_KEY in your agent's environment
export FYN_API_KEY=fyn_ak_your_key_here
  1. Ask your agent about your finances:

"How much did I spend on groceries this month?" "What's my net worth?" "Am I over budget on anything?"

API Endpoints

All endpoints use https://api.fyn.fyi/v1/agent as the base URL.

Free Tier
EndpointMethodDescription
/transactions/recentGETRecent transactions
/transactions/sumPOSTTotal spending for a period
/spending/breakdownPOSTSpending by category/merchant
/spending/comparePOSTCompare two time periods
/spending/discretionaryPOSTDiscretionary vs. essential
/accounts/balancesGETAll account balances
/accounts/balanceGETSingle account balance
/accounts/net-worthGETNet worth
/budget/statusGETBudget status
/budget/overGETOver-budget categories
/subscriptionsGETDetected subscriptions
/subscriptions/totalGETTotal subscription cost
/cashflowGETCash flow summary
/cashflow/savings-rateGETSavings rate
/portfolioGETPortfolio summary
/holdingsGETIndividual holdings
/insights/dailyGETDaily financial briefing
/insights/alertsGETActive anomalies & warnings
/insights/opportunitiesGETMoney-saving suggestions
/insights/weeklyGETWeekly financial recap
/insights/healthGETFinancial health score (0-100)
/insights/askPOSTNatural language insight query
Pro Tier ($9.99/mo)
EndpointMethodDescription
/receipts/searchPOSTSearch receipt line items
/receipts/ragPOSTChat with receipts (RAG)
/affordabilityPOSTAffordability check

Rate Limits

PlanDaily CallsReceipt RAG Queries
Free5010
Pro2,000500

Examples

See the examples/ directory:

Authentication

All requests require an API key:

Authorization: Bearer fyn_ak_your_key_here

Generate keys at fyn.fyi/settings/agent-access.

License

MIT

Frequently asked questions

What is FYN?

Personal finance for AI agents: budgets, receipts, net worth, spend checks. Read-only OAuth.

How do I install FYN?

It runs as a remote server. In Claude Code: claude mcp add --transport http fyn 'https://mcp.fyn.fyi'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does FYN need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is FYN open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains FYN?

It is published by fynfyi. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.