plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "budgetsync",
  "version": "1.0.0",
  "description": "Connect BudgetSync to ChatGPT and Codex to analyze budgets, transactions, categories, spending trends, and period-to-period changes using your live BudgetSync data. V1 is read-only.",
  "author": {
    "name": "Alexey Gurtovenko"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "BudgetSync",
        "shortDescription": "Understand household spending",
        "longDescription": "Understand your household finances with BudgetSync. View your budgets and transactions, summarize spending by category, compare periods, and check remaining category limits. Connect any BudgetSync account to analyze your own or shared household budgets. Read-only: this integration cannot change records, make purchases, or transfer money.",
        "developerName": "Alexey Gurtovenko",
        "category": "Finance",
        "defaultPrompt": [
          "How much did we spend this month?",
          "Compare our last two months of spending.",
          "Show my last 10 transactions."
        ],
        "privacyPolicyURL": "https://budgetsync-mcp-398131257100.us-central1.run.app/privacy",
        "termsOfServiceURL": "https://app.budgetsync.net/terms.html",
        "websiteURL": "https://budgetsync.net/welcome",
        "supportURL": "https://budgetsync.net/welcome#faq",
        "logo": "./assets/budgetsync-icon.png",
        "composerIcon": "./assets/budgetsync-icon.png",
        "brandColor": "#526ed3"
      },
      "review": {
        "demo_recording_url": "https://drive.google.com/file/d/1gpPkXJB7gJXAh5rUuYTygl8WLm4wIWQ5/view?usp=drivesdk",
        "test_cases": {
          "positive": [
            {
              "description": "Authenticated dedicated reviewer account with sample budgets. Verify the connected identity and discover available budgets.",
              "prompt": "Which BudgetSync account am I connected to, and which budgets can I view?",
              "tools_triggered": "get_profile, list_budgets",
              "expected_behavior": "Show the returned identity and accessible budget names, dates, and roles. Do not expose inaccessible budgets or infer an archived/default budget flag."
            },
            {
              "description": "Reviewer selects one returned budget by name; use its returned ID. Sample data includes transactions in September 2026.",
              "prompt": "For my selected budget, show the last 10 transactions from September 2026.",
              "tools_triggered": "get_transactions",
              "expected_behavior": "Use selected budgetId, startDate 2026-09-01, endDate 2026-09-30, limit 10. Show only returned transactions with dates, categories and amounts. Explain an empty result truthfully; do not invent records."
            },
            {
              "description": "Reviewer selects an accessible sample budget containing September 2026 category spending.",
              "prompt": "How much did I spend in my selected budget during September 2026, broken down by category?",
              "tools_triggered": "get_spending_summary",
              "expected_behavior": "Use selected budgetId, dates 2026-09-01 through 2026-09-30, groupBy category. Ground totals, percentages, and category names in tool output. Explain that currency comes from the user preference, with no currency conversion."
            },
            {
              "description": "Reviewer selects an accessible sample budget containing August and September 2026 transactions.",
              "prompt": "Compare August and September 2026 spending for my selected budget. Which categories changed most?",
              "tools_triggered": "compare_periods",
              "expected_behavior": "Use selected budgetId, periodA 2026-08-01 through 2026-08-31 and periodB 2026-09-01 through 2026-09-30. Report returned totals, differences and category changes. Treat null percentage changes as unavailable, not zero."
            },
            {
              "description": "Reviewer selects a sample budget active on 2026-09-30 with category limits.",
              "prompt": "How much was left in my selected budget as of September 30, 2026? Show category limits and remaining amounts.",
              "tools_triggered": "get_budget_overview",
              "expected_behavior": "Use selected budgetId and date 2026-09-30. Report returned budgeted, spent, remaining and category amounts, including negative remaining balances without hiding overspending."
            }
          ],
          "negative": [
            {
              "description": "V1 cannot create transactions. Explain the read-only limit without calling a tool or claiming a write succeeded.",
              "prompt": "Add a grocery expense of 25 euros to my budget."
            },
            {
              "description": "V1 cannot edit limits. Explain how to make the change in BudgetSync without invoking a mutation or claiming success.",
              "prompt": "Increase my dining budget limit to 300 euros."
            },
            {
              "description": "Bank transfers and payment initiation are unsupported. Do not call BudgetSync tools for this request or claim a transfer occurred.",
              "prompt": "Transfer 100 euros from my bank account to my partner."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Available to all BudgetSync accounts, including Free. No subscription or purchase is required. This read-only integration does not process purchases, payments, or transfers."
      },
      "publication": {
        "release_notes": "Initial read-only BudgetSync integration: view connected profile, budgets, categories and transactions; summarize spending, compare periods and inspect budget balances.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}