plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "baku",
  "version": "1.0.0",
  "description": "Manage the statement credits and perks on the credit cards you hold: see what is left on each credit and the last day to use it, record a credit as used, and undo an entry.",
  "author": {
    "name": "Chester Leung",
    "email": "hello@usebaku.com",
    "url": "https://usebaku.com"
  },
  "homepage": "https://usebaku.com",
  "keywords": [
    "credit cards",
    "card credits",
    "statement credits",
    "card benefits",
    "personal finance"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "baku",
        "shortDescription": "Your card credits, managed",
        "longDescription": "Premium credit cards pay you back through credits that reset on different schedules: monthly, quarterly, twice a year, by calendar year, by card anniversary. baku keeps the whole portfolio in one place and knows when each credit resets, so nothing lapses on the last day of the month.\n\nWith baku connected, you can:\n\n- Ask what is left to use and by when, across every card or for one card or one person in your household.\n- Ask what expires before a given date, or what was left at the end of a past month.\n- Say you used a credit and have it recorded, in full or for a partial amount.\n- Undo an entry that was recorded by mistake.\n\nWhat it can reach is deliberately narrow. baku never connects to your bank or card accounts and holds no card numbers, credentials, or transactions; it knows which cards you hold and what you have recorded. A connected assistant can read your credits and record or undo their use. It cannot add, edit, or remove cards.\n\nYou need a baku account with your cards added at usebaku.com. You approve the connection with your baku sign-in.\n\nTry:\n- \"What card credits do I need to use before the month ends?\"\n- \"I used my $15 Uber Cash on dinner tonight.\"\n- \"Which credits on my Sapphire Reserve are still unused this year?\"\n\nCredit amounts and rules come from baku's catalog and can differ from your account. Confirm details with your card issuer.",
        "developerName": "Chester Leung",
        "category": "Finance",
        "capabilities": [
          "Read",
          "Write"
        ],
        "websiteURL": "https://usebaku.com",
        "supportURL": "https://usebaku.com/support",
        "privacyPolicyURL": "https://usebaku.com/privacy",
        "termsOfServiceURL": "https://usebaku.com/terms",
        "defaultPrompt": [
          "What card credits do I need to use before the month ends?",
          "I used my Uber Cash tonight. Record it in baku.",
          "Which of my card credits expire in the next two weeks?"
        ],
        "brandColor": "#721DAF",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "What's left this month",
              "prompt": "What card credits do I need to use before the month ends?",
              "tools_triggered": "list_credits",
              "expected_behavior": "Calls list_credits with expiring_by set to the last day of the month and lists the unused credits with the remaining amount and last usable day for each, soonest first, plus a total."
            },
            {
              "description": "Credits on one card",
              "prompt": "Which credits on my Sapphire Reserve are still unused?",
              "tools_triggered": "list_credits",
              "expected_behavior": "Calls list_credits with card set to Sapphire Reserve and lists only that card's credits that still have something left."
            },
            {
              "description": "Record a partial use",
              "prompt": "I used $6 of my Lyft credit on the Sapphire Reserve today.",
              "tools_triggered": "list_credits, mark_credit_used",
              "expected_behavior": "Finds the Lyft credit with list_credits, then calls mark_credit_used with amount_cents 600 and today's date. Confirms the $6 recorded and what remains; the credit shows the same in baku."
            },
            {
              "description": "Record a full use",
              "prompt": "I used my Peloton credit on the Sapphire Reserve.",
              "tools_triggered": "list_credits, mark_credit_used",
              "expected_behavior": "Finds the Peloton credit with list_credits, then calls mark_credit_used without amount_cents. The full remaining amount is recorded and the credit shows as used for the period."
            },
            {
              "description": "Undo an entry",
              "prompt": "That was a mistake, undo the Peloton one.",
              "tools_triggered": "undo_credit_use",
              "expected_behavior": "Calls undo_credit_use with the use_id from the previous step. The entry is removed and the Peloton credit shows as unused again."
            }
          ],
          "negative": [
            {
              "description": "Outside what the plugin can do. There is no tool for adding a card, and baku's database refuses any other write from an assistant's token, so nothing is written. The assistant should say cards are added in baku itself.",
              "prompt": "Add a Capital One Venture X to my baku."
            },
            {
              "description": "Already fully used. The demo account has used the Platinum's Uber Cash for the month, so mark_credit_used returns an error saying so and nothing is recorded twice.",
              "prompt": "Mark my Uber Cash on the Platinum as used."
            },
            {
              "description": "Data baku doesn't hold. baku has no card numbers, balances, or transactions; list_credits returns only credits, so the assistant should say this isn't available.",
              "prompt": "What's the card number and current balance on my Platinum?"
            }
          ]
        },
        "demo_recording_url": "https://www.loom.com/share/a342379207944506af261f25a663a914",
        "commerce": false,
        "commerce_description": "The plugin reads and records card credit usage. It sells nothing and processes no payments."
      },
      "publication": {
        "release_notes": "Initial release: see what is left on each card credit and its last usable day, record a credit as used, and undo an entry."
      },
      "apps": "./.app.json"
    }
  }
}