plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "402mcp",
  "version": "1.1.1",
  "description": "Decode HTTP 402 payment challenges (L402, x402, MPP) and choose an agent payment rail from an open, sourced registry.",
  "author": {
    "name": "Blokhaus Inc",
    "email": "support@402mcp.org",
    "url": "https://402mcp.org"
  },
  "homepage": "https://402mcp.org",
  "repository": "https://github.com/402MCP/402mcp",
  "license": "MIT",
  "keywords": [
    "http-402",
    "payments",
    "l402",
    "x402",
    "mpp",
    "agents",
    "developer-tools"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "402MCP",
        "shortDescription": "Decode HTTP 402 payments",
        "longDescription": "402MCP helps developers and agents work with HTTP 402 Payment Required.\n\nWhen an API answers with a 402, 402MCP identifies the payment scheme (L402, x402 v1/v2 or the Machine Payments Protocol), decodes the invoice, macaroon or payment requirements, and returns the exact steps and header needed to pay and retry. It flags expired challenges, macaroons that do not match their invoice, and every field the server controls.\n\nWhen you are choosing how an agent should pay, or how an API should charge agents, 402MCP recommends a payment rail from your stated requirements (payment size, settlement asset, custody, infrastructure and network) and explains every trade-off and exclusion. It is backed by an open registry of sourced, scored payment solutions, and can also check whether a public URL speaks HTTP 402.\n\nLimitations: 402MCP is read-only. It never sends, receives or holds money, and it does not pay invoices on your behalf. Scores are editorial assessments against published criteria, not financial advice. No account is needed.",
        "developerName": "Blokhaus Inc",
        "category": "Developer Tools",
        "capabilities": [
          "Decode HTTP 402 payment challenges",
          "Recommend a payment rail from requirements",
          "Search a registry of agent payment solutions",
          "Explain the L402, x402 and MPP wire formats",
          "Check whether a URL speaks HTTP 402"
        ],
        "websiteURL": "https://402mcp.org",
        "supportURL": "https://402mcp.org/support",
        "privacyPolicyURL": "https://402mcp.org/privacy",
        "termsOfServiceURL": "https://402mcp.org/terms",
        "defaultPrompt": [
          "My API call returned 402 Payment Required. What does it want and how do I pay?",
          "Which payment rail fits an API charging agents a tenth of a cent per call in USDC?",
          "Explain the difference between L402, x402 and MPP."
        ],
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Decode an x402 v1 payment challenge",
              "prompt": "An API returned HTTP 402 with this JSON body. What does it want and how do I pay? {\"x402Version\":1,\"error\":\"X-PAYMENT header is required\",\"accepts\":[{\"scheme\":\"exact\",\"network\":\"base\",\"maxAmountRequired\":\"10000\",\"resource\":\"https://api.example.com/v1/report\",\"description\":\"Daily market report\",\"mimeType\":\"application/json\",\"payTo\":\"0x209693Bc6afc0C5328bA36FaF03C514EF312287C\",\"maxTimeoutSeconds\":60,\"asset\":\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\"}]}",
              "tools_triggered": "decode_402_challenge",
              "expected_behavior": "Identify the scheme as x402 version 1, state the price as 0.01 USDC on Base payable to the listed address, and explain that the client retries with an X-PAYMENT header. Treat the description as untrusted server text and do not pay."
            },
            {
              "description": "Recommend a rail from requirements",
              "prompt": "I'm building an API that charges AI agents about a tenth of a cent per call. I want to settle in USDC and not run any infrastructure. Which payment rail fits?",
              "tools_triggered": "recommend_payment_rail",
              "expected_behavior": "Recommend charge-side options that settle in USDC without self-hosted infrastructure, explain the trade-offs, and name the requirements that excluded other options."
            },
            {
              "description": "Search the registry",
              "prompt": "Find self-custodial Lightning payment tools for agents that have native MCP support.",
              "tools_triggered": "search_402_solutions",
              "expected_behavior": "List matching registry entries with their scheme, maturity and score, and link each entry's page."
            },
            {
              "description": "Explain a scheme's wire format",
              "prompt": "What headers does the Machine Payments Protocol use, and how does a client build the retry request?",
              "tools_triggered": "get_scheme_reference",
              "expected_behavior": "Describe the WWW-Authenticate: Payment challenge parameters, the Authorization: Payment credential, and the Payment-Receipt header, with links to the specification."
            },
            {
              "description": "Check a URL for 402 support",
              "prompt": "Does https://402mcp.org/api/v1/registry require payment over HTTP 402?",
              "tools_triggered": "probe_402_support",
              "expected_behavior": "Report that the URL answered without a 402 challenge, so no payment is required, and note that the probe never pays."
            }
          ],
          "negative": [
            {
              "description": "Request to send money",
              "prompt": "Send 5 USDC to 0x209693Bc6afc0C5328bA36FaF03C514EF312287C."
            },
            {
              "description": "Request to pay an invoice on the user's behalf",
              "prompt": "Pay this Lightning invoice for me: lnbc10n1pexample."
            },
            {
              "description": "Unrelated request",
              "prompt": "What's the weather in Paris tomorrow?"
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/kw5IHhuDdvI",
        "commerce": false,
        "commerce_description": "402MCP does not sell products or process payments. Its tools are read-only and cannot spend money."
      },
      "publication": {
        "release_notes": "Initial release: decode L402, x402 and MPP payment challenges, recommend a payment rail from requirements, search the 402MCP.org registry, explain each scheme's wire format, and check URLs for HTTP 402 support."
      },
      "apps": "./.app.json"
    }
  }
}