plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "myssagent",
  "version": "1.0.3",
  "description": "Social Security claiming-age math from MySSAgent: a free estimator, plus sign-in tools for financial advisors.",
  "author": {
    "name": "MySSAgent",
    "email": "support@myssagent.com",
    "url": "https://myssagent.com"
  },
  "homepage": "https://myssagent.com/mcp",
  "keywords": [
    "social security",
    "retirement",
    "claiming age",
    "financial advisors"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "MySSAgent",
        "shortDescription": "Social Security claiming math",
        "longDescription": "Claiming Social Security is one of the largest retirement decisions most people make, and one of the hardest to undo. In a United Income (2019) study, only 4% of retirees claimed at the financially optimal time, and households left an estimated $111,000 each on the table. The rules behind the decision are exact: full retirement age depends on birth year and can land on ages like 66 and 10 months, early-claiming reductions accrue by the month, and delayed retirement credits add 8% a year until 70.\n\nMySSAgent computes that math exactly. Share your birth month and year and the full-retirement-age benefit on your SSA statement (ssa.gov/myaccount), and the estimator returns your full retirement age, your benefit at every claiming age still open to you through 70, and your cumulative breakeven ages. No account is needed and nothing is stored.\n\nFinancial advisors with a MySSAgent advisor account can sign in to use three more tools: list their client roster, retrieve a client's stored claiming analysis (optimal age, lifetime values, survivor analysis, risk flags), and re-run the engine on records already on file. These tools reach only the advisor's own clients and never ingest a new earnings record. Clients are set up in the MySSAgent advisor dashboard.\n\nMySSAgent never connects to the SSA and never asks for a Social Security number. Every result is an estimate computed from the numbers you provide or the records you already hold, and none of it is financial advice. MySSAgent is not affiliated with the Social Security Administration.",
        "developerName": "MySSAgent",
        "category": "Finance",
        "websiteURL": "https://myssagent.com",
        "privacyPolicyURL": "https://myssagent.com/privacy",
        "termsOfServiceURL": "https://myssagent.com/terms",
        "defaultPrompt": [
          "I was born in May 1970 and my SSA statement says $2,000 a month at full retirement age. When should I claim?",
          "What's my breakeven age if I wait from 62 to 70?",
          "List my clients and show which ones have a claiming analysis on file."
        ],
        "logo": "./assets/logo.png",
        "supportURL": "https://myssagent.com/mcp#support"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "A person checks their Social Security benefit at each claiming age, with no account and no sign-in.",
              "prompt": "I was born in May 1970 and my SSA statement says $2,000 a month at full retirement age. When should I claim?",
              "tools_triggered": "estimate_claiming_strategy",
              "expected_behavior": "Full retirement age 67. Monthly benefit by claiming age: 62 = $1,400 (70%), 67 = $2,000, 70 = $2,480 (124%). Breakeven for waiting from 62 to 70 is 80 years and 5 months. A MySSAgent card shows the key ages with a \"Show all ages\" button, the breakevens, a \"not financial advice\" disclaimer and links to ssa.gov/myaccount and myssagent.com."
            },
            {
              "description": "A married person compares claiming at 62 against 70.",
              "prompt": "I'm married, born March 1965, and my FRA benefit is $2,400. What's the difference between claiming at 62 and 70?",
              "tools_triggered": "estimate_claiming_strategy",
              "expected_behavior": "62 = $1,680 a month, 70 = $2,976 a month, $161,280 forgone while waiting to 70, breakeven at 80 years and 5 months, plus a note that spousal and survivor benefits are not modeled by this estimate."
            },
            {
              "description": "A financial advisor, signed in with the demo advisor account, asks for their client list.",
              "prompt": "List my clients.",
              "tools_triggered": "list_clients",
              "expected_behavior": "Five clients, each with status \"analyzed\": Richard Hartwell, Jim Caldwell, Barbara Novak, Diana Chen, Sandra Reyes. All are sample records in a demo firm. If not yet signed in, ChatGPT first shows the MySSAgent sign-in prompt."
            },
            {
              "description": "The signed-in advisor opens one client's stored claiming analysis.",
              "prompt": "Show me Richard Hartwell's claiming analysis.",
              "tools_triggered": "list_clients, get_client_report",
              "expected_behavior": "Household strategy: Richard claims at 70 ($4,992 a month) and Carol at 62; combined $6,710 a month; expected household value $2,307,817. Richard's own-record table: 62 = $2,818, 67 = $4,026, 70 = $4,992. Survivor floor $4,992. Review items from 97 scenarios and a link to the advisor dashboard. Household figures can shift slightly after each re-run (test case 5), because the analysis is recomputed and saved."
            },
            {
              "description": "The signed-in advisor re-runs a client's analysis on the earnings record already on file (a write action).",
              "prompt": "Re-run Richard Hartwell's analysis.",
              "tools_triggered": "run_client_analysis",
              "expected_behavior": "The analysis re-runs and is saved: optimal claiming age 70, lifetime value $2,384,782 (planning age 95, 97 scenarios), unchanged from before. No new data is ingested."
            }
          ],
          "negative": [
            {
              "description": "A general retirement-account question unrelated to Social Security claiming.",
              "prompt": "How do I open a Roth IRA?"
            },
            {
              "description": "A user pastes a Social Security number and asks for a lookup. MySSAgent never takes SSNs or connects to the SSA, so it should not be called; if it were, it refuses the input and stores nothing.",
              "prompt": "My SSN is 123-45-6789. Look up my benefit."
            },
            {
              "description": "A question about applying for Social Security disability benefits, which MySSAgent does not handle.",
              "prompt": "How do I apply for Social Security disability benefits?"
            }
          ]
        }
      },
      "apps": "./.app.json"
    }
  }
}