FYN
Personal finance for AI agents: budgets, receipts, net worth, spend checks. Read-only OAuth.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http fyn 'https://mcp.fyn.fyi'
{
"mcpServers": {
"fyn": {
"type": "http",
"url": "https://mcp.fyn.fyi"
}
}
}
claude mcp add --transport http fyn 'https://api.fyn.fyi/v1/mcp'
{
"mcpServers": {
"fyn": {
"type": "http",
"url": "https://api.fyn.fyi/v1/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
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
- Sign up at fyn.fyi (free)
- Connect your bank accounts via Plaid
- Generate an API key at Settings > Agent Access
- Set
FYN_API_KEYin your agent's environment
export FYN_API_KEY=fyn_ak_your_key_here
- 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
| Endpoint | Method | Description |
|---|---|---|
/transactions/recent | GET | Recent transactions |
/transactions/sum | POST | Total spending for a period |
/spending/breakdown | POST | Spending by category/merchant |
/spending/compare | POST | Compare two time periods |
/spending/discretionary | POST | Discretionary vs. essential |
/accounts/balances | GET | All account balances |
/accounts/balance | GET | Single account balance |
/accounts/net-worth | GET | Net worth |
/budget/status | GET | Budget status |
/budget/over | GET | Over-budget categories |
/subscriptions | GET | Detected subscriptions |
/subscriptions/total | GET | Total subscription cost |
/cashflow | GET | Cash flow summary |
/cashflow/savings-rate | GET | Savings rate |
/portfolio | GET | Portfolio summary |
/holdings | GET | Individual holdings |
/insights/daily | GET | Daily financial briefing |
/insights/alerts | GET | Active anomalies & warnings |
/insights/opportunities | GET | Money-saving suggestions |
/insights/weekly | GET | Weekly financial recap |
/insights/health | GET | Financial health score (0-100) |
/insights/ask | POST | Natural language insight query |
Pro Tier ($9.99/mo)
| Endpoint | Method | Description |
|---|---|---|
/receipts/search | POST | Search receipt line items |
/receipts/rag | POST | Chat with receipts (RAG) |
/affordability | POST | Affordability check |
Rate Limits
| Plan | Daily Calls | Receipt RAG Queries |
|---|---|---|
| Free | 50 | 10 |
| Pro | 2,000 | 500 |
Examples
See the examples/ directory:
- basic-query.md — Transactions, spending breakdown, balances
- receipt-search.md — Receipt AI search and RAG
- budget-check.md — Budgets, affordability, subscriptions
Authentication
All requests require an API key:
Authorization: Bearer fyn_ak_your_key_here
Generate keys at fyn.fyi/settings/agent-access.
Links
- FYN Homepage
- Agent Landing Page
- API Documentation
- SKILL.md — Full skill definition
License
MIT
Questions fréquentes
Qu'est-ce que FYN ?
Personal finance for AI agents: budgets, receipts, net worth, spend checks. Read-only OAuth.
Comment installer FYN ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http fyn 'https://mcp.fyn.fyi'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour FYN ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
FYN est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient FYN ?
Il est publié par fynfyi. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.