English Français العربية

FYN

السجل الرسمي المالية والمدفوعات

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http fyn 'https://mcp.fyn.fyi'
إعداد 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'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "fyn": {
            "type": "http",
            "url": "https://api.fyn.fyi/v1/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو FYN؟

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

كيف أثبّت FYN؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http fyn 'https://mcp.fyn.fyi'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج FYN إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل FYN مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون FYN؟

ينشره fynfyi. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.