plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "pimlico",
  "version": "1.0.0",
  "description": "Check balance, usage and failed user operations, and manage API keys and gas sponsorship policies in your Pimlico account.",
  "author": {
    "name": "Pimlico",
    "email": "support@pimlico.io",
    "url": "https://www.pimlico.io"
  },
  "homepage": "https://www.pimlico.io/ai",
  "keywords": [
    "account abstraction",
    "erc-4337",
    "paymaster",
    "gas sponsorship",
    "developer tools"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Pimlico",
        "shortDescription": "Your Pimlico account in chat",
        "longDescription": "Pimlico sponsors gas for smart accounts on EVM chains and Solana. This plugin connects ChatGPT to your Pimlico account, so you can ask about it and manage it in plain language instead of opening the dashboard.\n\nWhat you can do:\n- Check your balance, unbilled usage and invoices.\n- See requests, API credits and sponsored gas over the last 24 hours, 7 days or 30 days, by chain, API key or day.\n- Find out why user operations failed: look up one operation by hash, or list recent operations and RPC requests with their revert reasons and error codes.\n- List, create, rename and disable API keys. Existing secret keys are never shown; a new key's secret appears only once, when it is created.\n- List, create and update gas sponsorship policies, including chains, USD caps and validity windows, and switch them on or off.\n- Look up supported chains and the tokens accepted by the ERC-20 paymaster.\n\nYou sign in with your Pimlico account and choose which organization to connect. Disabling keys or policies and reading billing require the organization admin role, as in the dashboard.\n\nThe plugin only reads and changes your Pimlico account settings. It does not sign transactions, move funds or send tokens on your behalf.",
        "developerName": "Pimlico",
        "category": "Developer Tools",
        "capabilities": [
          "Check balance, usage and invoices",
          "Diagnose failed user operations",
          "Manage API keys",
          "Manage gas sponsorship policies"
        ],
        "websiteURL": "https://www.pimlico.io/ai",
        "supportURL": "https://docs.pimlico.io",
        "privacyPolicyURL": "https://www.pimlico.io/privacy",
        "termsOfServiceURL": "https://www.pimlico.io/tos",
        "defaultPrompt": [
          "Why did my user operations fail in the last 24 hours?",
          "Create a sponsorship policy on Base Sepolia with a $20 budget",
          "What is my balance, and do I have unpaid invoices?"
        ],
        "brandColor": "#7115AA",
        "brandColorDark": "#C89BF0",
        "composerIcon": "./assets/logo.png",
        "composerIconDark": "./assets/logo-dark.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Diagnose failed user operations",
              "prompt": "Which of my user operations failed on Base Sepolia in the last 30 days, and why?",
              "tools_triggered": "pimlico_ops, pimlico_op",
              "expected_behavior": "Lists the failed operations on Base Sepolia (chain 84532) with their hashes, status and revert reason. The test account has operations that reverted on-chain."
            },
            {
              "description": "Create an API key",
              "prompt": "Create a new Pimlico API key named demo-app.",
              "tools_triggered": "pimlico_keys_create",
              "expected_behavior": "Creates the key and shows its secret once, stating that it cannot be retrieved again."
            },
            {
              "description": "Create a sponsorship policy",
              "prompt": "Create a gas sponsorship policy on Base Sepolia with a $20 total budget.",
              "tools_triggered": "pimlico_chains, pimlico_policies_create",
              "expected_behavior": "Creates an active policy limited to chain 84532 with a $20 global cap and returns its sp_ ID."
            },
            {
              "description": "Review sponsorship spend",
              "prompt": "How much gas did I sponsor in the last 30 days, broken down by chain?",
              "tools_triggered": "pimlico_usage",
              "expected_behavior": "Returns sponsored gas in USD per chain for the last 30 days. Figures can lag by one to two hours."
            },
            {
              "description": "Check balance and invoices",
              "prompt": "What is my Pimlico balance, and do I have any unpaid invoices?",
              "tools_triggered": "pimlico_balance, pimlico_invoices",
              "expected_behavior": "Reports the remaining balance and pending usage in USD and lists invoices, or says there are none."
            }
          ],
          "negative": [
            {
              "description": "Moving funds is not supported",
              "prompt": "Send 0.1 ETH from my wallet to 0x000000000000000000000000000000000000dEaD."
            },
            {
              "description": "Access outside the connected account",
              "prompt": "Show me the API keys of another Pimlico customer."
            },
            {
              "description": "Unrelated request",
              "prompt": "What's the weather in Paris today?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. It does not move funds or send tokens."
      },
      "publication": {
        "countries": [],
        "release_notes": "First release: balance, usage and invoices, user operation diagnostics, API keys and gas sponsorship policies for your Pimlico account."
      },
      "apps": "./.app.json"
    }
  }
}