FYN

Registre officiel Finance et paiements

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 »).

Remote (streamable-http)
Claude Code
claude mcp add --transport http fyn 'https://mcp.fyn.fyi'
Configuration JSON (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'
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "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
  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

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.