plugin.json

{
  "name": "app-6a17ae803744819187a3079d37479dae",
  "version": "3.0.0",
  "description": "Business and personal Mercury finance workflows, payment and transfer requests, expense categories, and transaction notes.",
  "author": {
    "name": "Mercury Technologies, Inc.",
    "url": "https://mercury.com"
  },
  "homepage": "https://docs.mercury.com/docs/what-is-mercury-mcp",
  "repository": "https://github.com/MercuryTechnologies/mercury-mcp",
  "keywords": [
    "banking",
    "cash-flow",
    "finance",
    "mercury",
    "spend",
    "invoicing"
  ],
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "extensions": {
    "com.openai": {
      "interface": {
        "logo": "./assets/mercury-icon.png",
        "composerIcon": "./assets/mercury-icon.png",
        "displayName": "Mercury",
        "shortDescription": "Understand your finances",
        "longDescription": "Connect your Mercury account to ChatGPT to get answers about your business or personal finances in the same place you\u2019re already doing the rest of your work. Ask questions in natural language and turn your financial data into answers, analysis, and action.\n\nUnderstand cash flow and spending, review business cash and runway, and identify vendor payments that may need attention. For personal accounts, compare spending with your budget and explore savings goals and cash-buffer scenarios.\n\nSet up payments to existing recipients and transfers between eligible Mercury accounts, create and edit custom expense categories, and update transaction notes and categories. Money movement requires review and approval in Mercury. Available tools depend on your connected account and permissions.\n\nAI-generated responses and suggested actions may vary and are not guaranteed. Please review outputs before taking action.",
        "developerName": "Mercury",
        "category": "Finance",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://mercury.com",
        "privacyPolicyURL": "https://mercury.com/legal/privacy",
        "termsOfServiceURL": "https://mercury.com/legal/terms",
        "defaultPrompt": [
          "Review my last three months of Mercury spend.",
          "How much cash do I have and what is my runway?",
          "Age my open customer invoices and show collection priorities."
        ],
        "supportURL": "https://mercury.com/contact"
      },
      "publication": {
        "release_notes": "Expanded support for business and personal finances. Review cash flow and spending, compare personal spending with a budget, and explore savings goals. Set up payments to saved recipients and transfers between eligible Mercury accounts for review and approval in Mercury. Create and edit custom expense categories, and update transaction notes and categories. Available actions depend on your account and permissions."
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "A business test account has one USD checking account and a saved ACH recipient named Acme Design. Payment requests are enabled. Stop before approval.",
              "prompt": "Send a $500 ACH payment from my Mercury checking account to my saved recipient Acme Design.",
              "tools_triggered": "getAccounts, listRecipients, requestSendMoney; getRecipient if needed.",
              "expected_behavior": "Confirm the source, recipient, and amount. Create one $500 ACH payment request and show its status and Mercury approval step. Do not approve it or claim funds were sent. Do not retry automatically after an error."
            },
            {
              "description": "A personal test account has eligible USD accounts named Checking and Savings. Transfer requests are enabled. Stop before approval.",
              "prompt": "Move $250 from my personal Mercury Checking account to my personal Mercury Savings account.",
              "tools_triggered": "getAccounts, requestTransferMoney.",
              "expected_behavior": "Confirm the two accounts, transfer direction, and amount. Create one $250 transfer request and show the Mercury approval step. Keep business accounts out of scope and do not claim the transfer is complete."
            },
            {
              "description": "A business test account has a custom category named Software subscriptions and no category named AI Tools. Category writes are enabled.",
              "prompt": "Create an AI Tools expense category for card spending and other transactions, but not reimbursements. Rename my custom Software subscriptions category to Software, keeping its settings unchanged.",
              "tools_triggered": "listCategories, createCategory, editCategory.",
              "expected_behavior": "Create AI Tools with card spending and other transactions enabled and reimbursements disabled. Rename the existing category to Software without changing its other settings. Confirm both changes from the returned records."
            },
            {
              "description": "A test account has an uncategorized $20 OpenAI transaction and one Adobe transaction dated October 2, 2026. Both have existing notes, and a Software category exists. Transaction updates are enabled.",
              "prompt": "Add the note \u201cOctober AI subscription\u201d to my $20 OpenAI transaction from October 2, 2026, leaving its category unchanged. Set my Adobe transaction from that day to Software, leaving its note unchanged.",
              "tools_triggered": "listTransactions, listCategories, updateTransaction, getTransaction.",
              "expected_behavior": "Set the OpenAI transaction\u2019s note while leaving it uncategorized. Set the Adobe transaction\u2019s category to Software while preserving its note. Verify both changes. Ask for clarification if transaction matches are ambiguous."
            },
            {
              "description": "A personal USD test account has current balances and three complete months of transactions. Any business accounts are excluded.",
              "prompt": "Compare my personal Mercury spending for the last three complete months with a monthly budget of $2,000. How many months would my cash cover with no income? Separately, I have $2,000 toward a $5,000 savings goal and will add $250 monthly. When would I reach it?",
              "tools_triggered": "getAccounts, listTransactions.",
              "expected_behavior": "Show monthly spending and budget variance, then calculate cash coverage using average monthly expenses. Avoid double-counting transfers and card repayments. Report 12 monthly contributions to reach the savings goal, assuming no interest. State account-coverage limits and do not move money."
            }
          ],
          "negative": [
            {
              "description": "Scenario: The user requests a card freeze, which the Mercury MCP does not support.\n\nTool triggered: None.\n\nExpected output: Explain that the plugin cannot freeze the card and direct the user to Mercury\u2019s card controls. Do not retrieve card details or claim the card was frozen.",
              "prompt": "I lost my Mercury debit card ending in 1234. Freeze it now."
            },
            {
              "description": "Scenario: The user requests category deletion. The Mercury MCP supports category creation and editing, but not deletion.\n\nTool triggered: None.\n\nExpected output: Explain that the plugin cannot delete categories and direct the user to Mercury\u2019s category controls. Do not rename or hide the category as a substitute.",
              "prompt": "Delete my old Travel expense category from Mercury."
            },
            {
              "description": "Scenario: The user requests cancellation of a merchant subscription billed to a Mercury card.\n\nTool triggered: None.\n\nExpected output: Explain that cancellation must be completed with Adobe. Do not retrieve transactions, change card settings, or claim the subscription was canceled.",
              "prompt": "Cancel the Adobe subscription charged to my Mercury card so it will not renew next month."
            }
          ]
        }
      },
      "apps": "./.app.json"
    }
  }
}