plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "capital-gains-tax-calculator",
  "version": "1.0.0",
  "description": "Capital gains tax rules for 218 countries and territories, and the tax owed on sales of shares, funds, crypto and property worked out with each country's calculator.",
  "author": {
    "name": "Native App Lab",
    "url": "https://capitalgainstax.net"
  },
  "homepage": "https://capitalgainstax.net",
  "keywords": [
    "capital gains tax",
    "cgt",
    "tax calculator",
    "shares",
    "crypto",
    "property",
    "tax"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "CapitalGainsTax.net",
        "shortDescription": "Rates, rules and the tax owed",
        "longDescription": "Work out capital gains tax on shares, funds, crypto, property and other assets in 218 countries and territories, from the rules each country's tax authority publishes.\n\nAsk how a country taxes gains and the answer comes from that country's rules tables: the rates for each tax year, allowances and exemptions, holding periods, how losses carry forward and when the return is due.\n\nGive it your sales and it prices them with the country's own calculator. It applies the exemptions, allowances, discounts, indexation and loss offsets that country uses, then returns each sale's gain or loss, the working for the tax year and the tax owed. Calculators cover 164 countries. For the rest you get the rules.\n\nCompare countries side by side, or list the countries with no tax on capital gains, ordered by the top rate on shares.\n\nEvery calculation links to the full calculator on capitalgainstax.net with your sales already filled in. There you can edit them, import broker and exchange files, keep a return for each tax year and download the summary for your tax return.\n\nAmounts are in the country's own currency, and one calculation covers one tax year.",
        "developerName": "Native App Lab",
        "category": "Finance",
        "capabilities": [
          "Look up capital gains tax rules for 218 countries and territories",
          "Calculate the tax on sales of shares, funds, crypto and property",
          "Compare capital gains tax across countries"
        ],
        "websiteURL": "https://capitalgainstax.net",
        "supportURL": "https://capitalgainstax.net/contact",
        "privacyPolicyURL": "https://capitalgainstax.net/privacy",
        "termsOfServiceURL": "https://capitalgainstax.net/terms",
        "defaultPrompt": [
          "I bought 2 BTC in Germany in 2023 for \u20ac40,000 and sold them in 2025 for \u20ac110,000. What tax do I owe?",
          "How much capital gains tax do I pay in the UK on \u00a320,000 of share gains if I earn \u00a360,000?",
          "Which European countries have no capital gains tax?"
        ],
        "brandColor": "#1D5CF5",
        "brandColorDark": "#6B95FF",
        "composerIcon": "./assets/logo.svg",
        "composerIconDark": "./assets/logo-dark.svg",
        "logo": "./assets/logo.svg",
        "logoDark": "./assets/logo-dark.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "A Coinbase export for the UK: trades lot-matched by HMRC's share-matching rules (the 30-day rule and the Section 104 pool), a loss netted, the annual exempt amount and the higher rate",
              "prompt": "I'm in the UK and earn \u00a360,000. Here's my Coinbase export, what capital gains tax do I owe for 2025/26?\n\nPortfolio,Trade ID,Product,Side,Created At,Size,Size Unit,Price,Fee,Total,Price/Fee/Total Currency\nDefault,41022871,BTC-GBP,BUY,2023-01-10T10:12:44.512Z,0.5,BTC,16000,0,8000,GBP\nDefault,52318843,ETH-GBP,BUY,2024-03-05T14:03:09.201Z,2,ETH,2900,0,5800,GBP\nDefault,61907712,BTC-GBP,SELL,2025-05-12T09:41:27.880Z,0.3,BTC,80000,0,24000,GBP\nDefault,62188450,BTC-GBP,BUY,2025-05-30T16:20:02.094Z,0.1,BTC,78000,0,7800,GBP\nDefault,70455128,ETH-GBP,SELL,2025-11-18T11:55:31.337Z,2,ETH,2100,0,4200,GBP",
              "tools_triggered": "calculate_capital_gains_tax",
              "expected_behavior": "Passes the export to the tool, which reads it as Coinbase and matches the trades by the UK rules: of the 0.3 BTC sold on 12 May 2025, 0.1 BTC is matched to the 30 May buy-back under the 30-day rule (a \u00a3200 gain) and 0.2 BTC to the Section 104 pool at the 2023 cost (a \u00a312,800 gain); the 2 ETH sold in November are a \u00a31,600 loss. After the \u00a33,000 annual exempt amount, \u00a38,400 is taxed at 24%: \u00a32,016. The card lists the matched sales with their rules and an income field; Open in the full calculator opens the UK calculator with the five trades imported."
            },
            {
              "description": "Australia: a carried-forward loss and a current-year crypto loss applied before the 50% discount, then the marginal rate and Medicare levy",
              "prompt": "I'm in Australia on a $95,000 salary. In February 2026 I sold BHP shares for $19,500 that I bought in March 2019 for $12,000, with $30 brokerage on each trade. I also sold some ETH in September 2025 for $6,200 that I'd bought in March 2025 for $8,000, and I have $1,500 of capital losses carried forward from last year. What's my CGT?",
              "tools_triggered": "calculate_capital_gains_tax",
              "expected_behavior": "Calculates 2025-26 in AUD: a $7,440 gain on BHP after brokerage, the $1,800 ETH loss and $1,500 carried-forward loss taken off first, the 50% discount on the remaining $4,140 for a $2,070 net capital gain, taxed at 30% ($621) plus the 2% Medicare levy ($41.40): $662.40. The card shows the working and an income field; Open in the full calculator opens the Australia calculator with the sales and the carried-forward loss filled in."
            },
            {
              "description": "United States: short-term and long-term results netted, federal long-term rate by income, California taxing the gain as ordinary income",
              "prompt": "I'm single in California earning $120,000. In 2025 I sold NVDA for $55,000 that I bought in February 2022 for $15,000, sold TSLA in May for $14,000 that I bought in January 2025 for $20,000, and sold ETH in March for $7,500 that I bought in November 2024 for $5,000. What's my federal and California tax on these?",
              "tools_triggered": "calculate_capital_gains_tax",
              "expected_behavior": "Calculates 2025 in USD for a single filer in California: a $40,000 long-term gain on NVDA, a $6,000 short-term loss on TSLA and a $2,500 short-term gain on ETH net to a $36,500 net capital gain, taxed at the 15% federal long-term rate ($5,475) and as ordinary income in California ($3,394.50): $8,869.50 in total. The card shows the working and an income field; Open in the full calculator opens the US calculator with the sales, filing status and state filled in."
            },
            {
              "description": "Canada: a crypto loss netted against a share gain, the 50% inclusion rate, and federal plus Ontario tax at the seller's income",
              "prompt": "I live in Ontario and earn $85,000. In June 2025 I sold Shopify shares for $70,000 that I bought in March 2021 for $30,000 ($10 commission each way), and in February I sold Solana for $4,000 that cost me $10,000 in April 2024. How much tax will I pay on this?",
              "tools_triggered": "calculate_capital_gains_tax",
              "expected_behavior": "Calculates 2025 in CAD for an Ontario resident: a $39,980 gain on the shares after commissions, less the $6,000 Solana loss, half of the $33,980 net gain taxable ($16,990), federal tax of $3,482.94 and Ontario tax of $1,716.59: $5,199.53. The card shows the working and an income field; Open in the full calculator opens the Canada calculator with both sales and Ontario filled in."
            },
            {
              "description": "Choosing where to live before selling: rules and comparison across countries",
              "prompt": "I live in the UK and I'm thinking about moving to Portugal or Dubai before I sell my crypto, which I've held for three years. How would each country tax the gain?",
              "tools_triggered": "compare_capital_gains_tax, get_capital_gains_tax_rules",
              "expected_behavior": "Compares the three: the UK taxes the gain at 18% or 24% after the \u00a33,000 annual exempt amount; Portugal exempts crypto held 365 days or more; the United Arab Emirates has no capital gains tax and no personal income tax. Reads Portugal's rules for the crypto holding period, and links each country's page on capitalgainstax.net. Does not advise on residency rules beyond what the tools return."
            }
          ],
          "negative": [
            {
              "description": "Filing a return. The plugin calculates and never files or submits anything to a tax authority; ChatGPT explains that it can work out the figures for the return and the user files it with HMRC themselves.",
              "prompt": "File my 2025 capital gains tax return with HMRC for me."
            },
            {
              "description": "A tax outside capital gains. The plugin covers capital gains tax only, so no tool is called for a VAT question.",
              "prompt": "What is the VAT rate on restaurant meals in France?"
            },
            {
              "description": "Choosing investments. The plugin works out tax on sales and does not recommend what to buy or sell, so no tool is called to pick shares.",
              "prompt": "Which shares should I buy next year so I pay less capital gains tax?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin does not sell products or process payments.",
        "demo_recording_url": "https://youtu.be/G3lPsiLbFbk"
      },
      "publication": {
        "countries": [],
        "release_notes": "First release: capital gains tax rules for 218 countries and territories, calculations with 164 country calculators, country comparison, exchange and broker exports read and matched by each country's own rules, and a result card with an income field that recalculates the tax and opens the full calculator with the sales filled in."
      },
      "apps": "./.app.json"
    }
  }
}