{
  "openapi": "3.1.0",
  "info": {
    "title": "Canada Vehicle Recalls MCP",
    "description": "Transport Canada vehicle safety recalls by make, model and year.\n\nThis specification documents the HTTP x402 pay-per-call routes only (not the MCP /mcp transport). Unpaid calls return HTTP 402. Retry with an X-PAYMENT header (x402 v1, scheme exact, USDC on Base). A payout address is included only in the live 402 challenge served by the Worker, not in this file. MCP endpoint: https://ca-vehicle-recalls-mcp.donniertf.workers.dev/mcp. Manifest: https://ca-vehicle-recalls-mcp.donniertf.workers.dev/.well-known/x402. Paper/free discovery routes are not billed.",
    "version": "1.0.0",
    "contact": {
      "name": "Donnie Morrison",
      "email": "dmorrisonwebdesign@gmail.com",
      "url": "https://ca-vehicle-recalls-mcp.donniertf.workers.dev/"
    },
    "license": {
      "name": "See product landing page and source licences"
    },
    "x-guidance": "Use the paid HTTP routes documented in paths (POST JSON, or GET with query args). Unpaid calls return HTTP 402; retry with an X-PAYMENT header (x402, USDC on Base). The MCP transport is at /mcp. Transport Canada vehicle safety recalls by make, model and year."
  },
  "servers": [
    {
      "url": "https://ca-vehicle-recalls-mcp.donniertf.workers.dev",
      "description": "Canada Vehicle Recalls MCP origin"
    }
  ],
  "tags": [
    {
      "name": "x402",
      "description": "USDC on Base pay-per-call routes"
    }
  ],
  "paths": {
    "/x402/vehicle_recalls": {
      "post": {
        "summary": "FREE. Transport Canada safety recalls for a make + model (+ optional year). Newest 5 with recall numbers and dates.",
        "description": "FREE. Transport Canada safety recalls for a make + model (+ optional year). Newest 5 with recall numbers and dates.",
        "operationId": "post_x402_vehicle_recalls",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid request succeeded; JSON result of the tool or pack.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required. Retry with an X-PAYMENT header (x402 v1, exact scheme, USDC on Base). The 402 body/header lists price and terms; payout address is only in the live 402 challenge, not in this spec."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "make": {
                    "type": "string"
                  },
                  "model": {
                    "type": "string"
                  },
                  "year": {
                    "type": "number"
                  }
                },
                "required": [
                  "make"
                ]
              }
            }
          }
        }
      },
      "get": {
        "summary": "FREE. Transport Canada safety recalls for a make + model (+ optional year). Newest 5 with recall numbers and dates. (query or 402 probe)",
        "description": "FREE. Transport Canada safety recalls for a make + model (+ optional year). Newest 5 with recall numbers and dates. Accepts query args; unpaid calls return 402.",
        "operationId": "get_x402_vehicle_recalls",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid request succeeded; JSON result of the tool or pack.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required. Retry with an X-PAYMENT header (x402 v1, exact scheme, USDC on Base). The 402 body/header lists price and terms; payout address is only in the live 402 challenge, not in this spec."
          }
        },
        "parameters": [
          {
            "name": "make",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "model",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            }
          }
        ]
      }
    },
    "/x402/recall_detail": {
      "post": {
        "summary": "PRO. Full Transport Canada recall details for a recall number: system, units affected, defect, consequence and remedy.",
        "description": "PRO. Full Transport Canada recall details for a recall number: system, units affected, defect, consequence and remedy.",
        "operationId": "post_x402_recall_detail",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid request succeeded; JSON result of the tool or pack.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required. Retry with an X-PAYMENT header (x402 v1, exact scheme, USDC on Base). The 402 body/header lists price and terms; payout address is only in the live 402 challenge, not in this spec."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "recall_number": {
                    "type": "string"
                  }
                },
                "required": [
                  "recall_number"
                ]
              }
            }
          }
        }
      },
      "get": {
        "summary": "PRO. Full Transport Canada recall details for a recall number: system, units affected, defect, consequence and remedy. (query or 402 probe)",
        "description": "PRO. Full Transport Canada recall details for a recall number: system, units affected, defect, consequence and remedy. Accepts query args; unpaid calls return 402.",
        "operationId": "get_x402_recall_detail",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid request succeeded; JSON result of the tool or pack.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required. Retry with an X-PAYMENT header (x402 v1, exact scheme, USDC on Base). The 402 body/header lists price and terms; payout address is only in the live 402 challenge, not in this spec."
          }
        },
        "parameters": [
          {
            "name": "recall_number",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/x402/fleet_check": {
      "post": {
        "summary": "PRO. Check up to 50 vehicles ({make, model, year}) for recalls at once.",
        "description": "PRO. Check up to 50 vehicles ({make, model, year}) for recalls at once.",
        "operationId": "post_x402_fleet_check",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid request succeeded; JSON result of the tool or pack.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required. Retry with an X-PAYMENT header (x402 v1, exact scheme, USDC on Base). The 402 body/header lists price and terms; payout address is only in the live 402 challenge, not in this spec."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "vehicles": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    }
                  }
                },
                "required": [
                  "vehicles"
                ]
              }
            }
          }
        }
      },
      "get": {
        "summary": "PRO. Check up to 50 vehicles ({make, model, year}) for recalls at once. (query or 402 probe)",
        "description": "PRO. Check up to 50 vehicles ({make, model, year}) for recalls at once. Accepts query args; unpaid calls return 402.",
        "operationId": "get_x402_fleet_check",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid request succeeded; JSON result of the tool or pack.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required. Retry with an X-PAYMENT header (x402 v1, exact scheme, USDC on Base). The 402 body/header lists price and terms; payout address is only in the live 402 challenge, not in this spec."
          }
        },
        "parameters": [
          {
            "name": "vehicles",
            "in": "query",
            "required": true,
            "schema": {
              "type": "array",
              "items": {
                "type": "object"
              }
            }
          }
        ]
      }
    },
    "/x402/new_vehicle_recalls": {
      "post": {
        "summary": "PRO. Vehicle, tire and child-seat recalls posted since a date (YYYY-MM-DD), optional keyword.",
        "description": "PRO. Vehicle, tire and child-seat recalls posted since a date (YYYY-MM-DD), optional keyword.",
        "operationId": "post_x402_new_vehicle_recalls",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid request succeeded; JSON result of the tool or pack.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required. Retry with an X-PAYMENT header (x402 v1, exact scheme, USDC on Base). The 402 body/header lists price and terms; payout address is only in the live 402 challenge, not in this spec."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "since": {
                    "type": "string"
                  },
                  "keyword": {
                    "type": "string"
                  }
                },
                "required": [
                  "since"
                ]
              }
            }
          }
        }
      },
      "get": {
        "summary": "PRO. Vehicle, tire and child-seat recalls posted since a date (YYYY-MM-DD), optional keyword. (query or 402 probe)",
        "description": "PRO. Vehicle, tire and child-seat recalls posted since a date (YYYY-MM-DD), optional keyword. Accepts query args; unpaid calls return 402.",
        "operationId": "get_x402_new_vehicle_recalls",
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.020000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "responses": {
          "200": {
            "description": "Paid request succeeded; JSON result of the tool or pack.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required. Retry with an X-PAYMENT header (x402 v1, exact scheme, USDC on Base). The 402 body/header lists price and terms; payout address is only in the live 402 challenge, not in this spec."
          }
        },
        "parameters": [
          {
            "name": "since",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "keyword",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    }
  }
}