Server definition

Hash: sha256:781474bd874b75cccd93b4a53bd72e48ed8aadccdfb482aeb9ff7ef4a23a9f5d
What it is: What a remote MCP server returned when asked what it offers: 10 tools

The blob, as servednamed by its sha256

{
  "instructions": "MyOTP.App MCP server — send and verify OTPs over SMS, WhatsApp, and Telegram. Typical flow: call `generate_otp` with a phone number to send a code, save the returned `message_id`, then call `verify_otp` with the code the end user typed. Use `check_otp_status` to debug delivery, `extend_otp` to give users more time, and `get_usage_report` for transaction history. Every tool except `create_account` needs a MyOTP API key. No key yet? Call `create_account` with an email address: no phone step, the key is returned once, and the balance starts at zero. Then `get_topup_quote` and `top_up_credits` buy credits with USDC or card before the first send. Phone numbers must be in international format with no leading + or 0 (e.g. '14155551234' for a US number).",
  "tools": [
    {
      "description": "Check whether a previously sent OTP is still active and (with DLR_ACCESS entitlement on Enterprise plan) get its delivery status. Returns `is_active` (bool) and `expires_at` (ISO timestamp) on every plan. On Enterprise plans, also returns `DLR`: 'delivered', 'sent', 'read', 'pending', or a failure as `failed.<reason>` (on WhatsApp, `failed.Undeliverable` means the number cannot receive WhatsApp and `failed.Provider` means a retry is worth it). Useful when an end user reports they didn't receive the code — you can confirm whether MyOTP delivered it before deciding to resend. Does NOT verify a code; use `verify_otp` for that.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "message_id": {
            "description": "The UUID returned by `generate_otp` — this identifies which OTP you want a status report on.",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "message_id"
        ],
        "type": "object"
      },
      "name": "check_otp_status",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": true,
        "properties": {
          "DLR": {
            "description": "Delivery state: carrier status (ATES, DELIVRD, UNDELIV, EXPIRED, REJECTD) or sent/delivered/read/pending/failed.<reason>, a 'Pending: ...' hint, or a 'Not available ...' explanation. Absent when the message_id is unknown.",
            "type": "string"
          },
          "DLR:": {
            "description": "Deprecated alias of DLR.",
            "type": "string"
          },
          "Message:": {
            "description": "Deprecated alias of message.",
            "type": "string"
          },
          "expires_at": {
            "description": "ISO 8601 date-time the OTP expires. Absent when the message_id is unknown.",
            "type": "string"
          },
          "is_active": {
            "description": "Whether the OTP can still be verified (it has not expired).",
            "type": "boolean"
          },
          "message": {
            "description": "Present instead of DLR when the message_id is not found.",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Create a MyOTP.App agent account and return its one-time API key. No API key is required for this tool. The new account starts with zero balance; USDC top-ups work immediately, while card top-ups unlock after a human confirms the email address.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "email": {
            "description": "Email address for the new MyOTP.App account.",
            "format": "email",
            "type": "string"
          },
          "name": {
            "description": "Optional account, company, or product name (maximum 64 characters).",
            "maxLength": 64,
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object"
      },
      "name": "create_account",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": true,
        "properties": {
          "account_id": {
            "description": "Account identifier, 'a' followed by 12 hex characters.",
            "type": "string"
          },
          "api_key": {
            "description": "The API key. Shown once, in this response only. Send it as the X-API-Key header.",
            "type": "string"
          },
          "api_key_note": {
            "type": "string"
          },
          "balance": {
            "description": "Credits on the balance. Zero at registration.",
            "type": "number"
          },
          "docs": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "email_verified": {
            "description": "True once the human has confirmed the emailed link. Unlocks card top-ups.",
            "type": "boolean"
          },
          "plan_id": {
            "type": "integer"
          },
          "status": {
            "description": "Account status, 'active' when the key can be used.",
            "type": "string"
          },
          "topup": {
            "additionalProperties": true,
            "description": "Where to buy credits.",
            "properties": {
              "endpoint": {
                "type": "string"
              },
              "note": {
                "type": "string"
              },
              "quote": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "verification_email_sent": {
            "description": "Whether the confirmation email was queued.",
            "type": "boolean"
          }
        },
        "required": [
          "account_id",
          "api_key",
          "email",
          "email_verified",
          "balance",
          "plan_id",
          "status"
        ],
        "type": "object"
      }
    },
    {
      "description": "Extend the expiry time of an active OTP without sending a new one. Useful when the end user is taking longer than expected to enter the code (e.g., switched apps, dealing with carrier delivery delay). Adds `duration` seconds (60-14400) to the current `expires_at`. Requires the EXTEND_OTP entitlement (Business or Enterprise plan). Some destination countries don't allow extensions — the API will return 403 in that case. Cheaper and less spammy than calling `generate_otp` again.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "duration": {
            "description": "Additional seconds to add to the OTP's expiry. Range 60-14400 (1 minute to 4 hours). The new expiry will be the current expiry + this duration.",
            "maximum": 14400,
            "minimum": 60,
            "type": "integer"
          },
          "message_id": {
            "description": "The UUID returned by `generate_otp` — identifies the OTP you want to extend.",
            "format": "uuid",
            "type": "string"
          }
        },
        "required": [
          "message_id",
          "duration"
        ],
        "type": "object"
      },
      "name": "extend_otp",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": true,
        "properties": {
          "expires_at": {
            "description": "The new ISO 8601 expiry date-time.",
            "type": "string"
          },
          "message": {
            "description": "Message describing the result.",
            "type": "string"
          },
          "status": {
            "description": "Status of the request.",
            "type": "string"
          }
        },
        "required": [
          "status",
          "message",
          "expires_at"
        ],
        "type": "object"
      }
    },
    {
      "description": "Send a one-time password (OTP) to a phone number via SMS, WhatsApp, or Telegram. MyOTP.App generates the code, formats the message, picks the best carrier route, and delivers it. Returns a `message_id` (UUID) — keep it; you'll pass it to `verify_otp`, `check_otp_status`, or `extend_otp` later. Each call deducts credits from the account balance; the per-message cost varies by destination country and channel and is returned in the `cost` field. Use this whenever an app needs to verify someone's phone — signup, login 2FA, password reset, transaction confirmation, etc.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "brand": {
            "description": "Sender brand name shown to the recipient (3-16 alphanumeric characters plus dots). Defaults to the brand registered against the API key, or 'MyOTP.App' if none.",
            "maxLength": 16,
            "minLength": 3,
            "pattern": "^[a-zA-Z0-9.]+$",
            "type": "string"
          },
          "channel": {
            "description": "Delivery channel. 'sms' (default) works in 190+ countries. 'whatsapp' is best for India/Brazil/Indonesia/Mexico/Nigeria/Turkey. 'telegram' is best for privacy-focused users. Same API for all three.",
            "enum": [
              "sms",
              "whatsapp",
              "telegram"
            ],
            "type": "string"
          },
          "force_send": {
            "description": "If true, send a new OTP even if one is already active for this phone number. By default the API returns 409 in that case. Use sparingly — repeated sends to the same number can hit carrier-level spam filters.",
            "type": "boolean"
          },
          "otp_code": {
            "description": "Provide your own pre-generated numeric OTP code (3-8 digits, 4-8 for telegram) instead of letting MyOTP generate one. Useful when you already have a code from another system.",
            "pattern": "^\\d{3,8}$",
            "type": "string"
          },
          "otp_length": {
            "description": "Number of digits in the auto-generated OTP. Range 3-8 (4-8 for telegram). Default 6. Requires CUSTOM_OTP_LENGTH entitlement (Business plan or above).",
            "maximum": 8,
            "minimum": 3,
            "type": "integer"
          },
          "otp_validity": {
            "description": "How long the OTP stays valid, in seconds. Range 30-14400 (30-3600 for telegram). Default 300 (5 minutes). Requires CUSTOM_OTP_EXPIRY entitlement (Business plan or above).",
            "maximum": 14400,
            "minimum": 30,
            "type": "integer"
          },
          "phone_number": {
            "description": "Destination phone number in international format with NO leading + or 0. Must be 7-15 digits and start with a non-zero digit. Example: '14155551234' for a US number, '447911123456' for a UK number.",
            "maxLength": 15,
            "minLength": 7,
            "pattern": "^[1-9]\\d{6,14}$",
            "type": "string"
          },
          "return_otp": {
            "description": "If true, the API response will include the generated OTP code in plain text. Useful for testing or when you want to deliver the OTP via your own channel. Defaults to false. SECURITY: never enable this in production user flows.",
            "type": "boolean"
          },
          "template_order": {
            "description": "Pick a specific message template by its order number (1-99). WhatsApp has four: 12 (English, 5-minute code), 13 (English, 10 minutes), 14 (Spanish es_MX, 5 minutes), 15 (Spanish es_MX, 10 minutes). On WhatsApp the template's own expiry overrides otp_validity. Requires the ACCESS_TO_TEMPLATES entitlement (Business plan and up). Not supported on telegram (Telegram generates its own message text).",
            "maximum": 99,
            "minimum": 1,
            "type": "integer"
          }
        },
        "required": [
          "phone_number"
        ],
        "type": "object"
      },
      "name": "generate_otp",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": true,
        "properties": {
          "cost": {
            "description": "Credits charged for this send.",
            "type": "number"
          },
          "date_sent": {
            "description": "ISO 8601 date-time the OTP was sent.",
            "type": "string"
          },
          "expires_at": {
            "description": "ISO 8601 date-time the OTP expires.",
            "type": "string"
          },
          "message": {
            "description": "Message describing the status of the request.",
            "type": "string"
          },
          "message_id": {
            "description": "ID of the message sent. Pass it to verify_otp, check_otp_status and extend_otp.",
            "type": "string"
          },
          "otp": {
            "description": "The OTP value, present only when return_otp was true.",
            "type": "string"
          },
          "status": {
            "description": "Always 'accepted' on success; delivery state comes from check_otp_status.",
            "type": "string"
          }
        },
        "required": [
          "message_id",
          "status",
          "message",
          "date_sent",
          "expires_at",
          "cost"
        ],
        "type": "object"
      }
    },
    {
      "description": "Return account details for the API key in use. Always returns at least the account `email`; depending on plan and platform version may also return balance/credit/plan info. Use this as a sanity check when wiring up MyOTP for the first time — if this call succeeds, your API key and IP whitelist are configured correctly.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {},
        "type": "object"
      },
      "name": "get_account_info",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": true,
        "properties": {
          "email": {
            "description": "Email address of the account the API key belongs to.",
            "type": "string"
          }
        },
        "required": [
          "email"
        ],
        "type": "object"
      }
    },
    {
      "description": "Return email verification, balance, plan, and status for the configured MyOTP agent account. Set resend_verification to request another confirmation email first. Unverified accounts can top up with USDC, but cards stay locked.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "resend_verification": {
            "description": "Send another confirmation email before returning account status.",
            "type": "boolean"
          }
        },
        "type": "object"
      },
      "name": "get_account_status",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": true,
        "properties": {
          "balance": {
            "description": "Credits on the balance.",
            "type": "number"
          },
          "email_verified": {
            "description": "True once the human has confirmed the emailed link. Unlocks card top-ups.",
            "type": "boolean"
          },
          "hint": {
            "description": "What to do next: verify the email, top up, or start sending.",
            "type": "string"
          },
          "plan_id": {
            "type": "integer"
          },
          "status": {
            "description": "Account status, 'active' when the key can be used.",
            "type": "string"
          }
        },
        "required": [
          "email_verified",
          "balance",
          "plan_id",
          "status",
          "hint"
        ],
        "type": "object"
      }
    },
    {
      "description": "Get the live price and payment options for buying MyOTP credits, without making a purchase. Use this when generate_otp or another send fails with HTTP 403 insufficient balance / NoBalance, or before calling `top_up_credits` to show the cost. Returns USDC and card client commands and never exposes the configured API key.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "credits": {
            "default": 100,
            "description": "Number of credits to quote. Integer from 25 to 50,000; defaults to 100.",
            "maximum": 50000,
            "minimum": 25,
            "type": "integer"
          }
        },
        "type": "object"
      },
      "name": "get_topup_quote",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": true,
        "properties": {
          "amount_usd": {
            "description": "Total price in US dollars, as a decimal string.",
            "type": "string"
          },
          "credits": {
            "description": "The number of credits priced.",
            "type": "integer"
          },
          "currency": {
            "description": "Always 'usd'.",
            "type": "string"
          },
          "how_to_pay": {
            "additionalProperties": true,
            "description": "Ready-to-run client commands for this amount.",
            "properties": {
              "card": {
                "description": "Stripe Link CLI command that pays the challenge by card.",
                "type": "string"
              },
              "usdc": {
                "description": "mppx command that pays the challenge in USDC on Tempo.",
                "type": "string"
              }
            },
            "required": [
              "usdc",
              "card"
            ],
            "type": "object"
          },
          "max_credits": {
            "type": "integer"
          },
          "methods": {
            "description": "Human-readable list of the accepted payment methods.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "min_credits": {
            "type": "integer"
          },
          "price_per_credit_usd": {
            "description": "Unit price. Currently 0.02.",
            "type": "number"
          },
          "rules": {
            "description": "Top-up limits: unit price, minimum, maximum and the card cap.",
            "type": "string"
          }
        },
        "required": [
          "credits",
          "amount_usd",
          "price_per_credit_usd",
          "min_credits",
          "max_credits",
          "currency",
          "methods",
          "rules",
          "how_to_pay"
        ],
        "type": "object"
      }
    },
    {
      "description": "Fetch a paginated list of OTP transactions for a date range. Each transaction includes message_id, timestamp, phone_number, channel, country, cost, status, and the originating client IP. Date range cannot exceed 31 days. Defaults: last 7 days, page 1, 10 per page. Requires the API_REPORTING entitlement (Business or Enterprise plan). Use this to: audit recent activity, build internal dashboards, reconcile billing, or debug delivery issues across many recipients.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "end_date": {
            "description": "End date in YYYY-MM-DD format (UTC). If omitted, defaults to today. The range start_date..end_date cannot exceed 31 days.",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string"
          },
          "page": {
            "description": "Page number for paginated results, starting at 1. Default 1.",
            "minimum": 1,
            "type": "integer"
          },
          "per_page": {
            "description": "Results per page, 1-100. Default 10.",
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "start_date": {
            "description": "Start date in YYYY-MM-DD format (UTC). If omitted, defaults to 7 days before today. The range start_date..end_date cannot exceed 31 days.",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_usage_report",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": true,
        "properties": {
          "current_page": {
            "description": "The page returned.",
            "type": "integer"
          },
          "message": {
            "description": "Present when the endpoint has no data for the range.",
            "type": "string"
          },
          "per_page": {
            "description": "Rows per page.",
            "type": "integer"
          },
          "total_count": {
            "description": "Total transactions matching the date range.",
            "type": "integer"
          },
          "total_pages": {
            "description": "Number of pages at the requested per_page.",
            "type": "integer"
          },
          "transactions": {
            "description": "Transaction rows for the page. May be empty or absent when there is no data.",
            "items": {
              "additionalProperties": true,
              "properties": {
                "application": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "channel": {
                  "description": "sms, whatsapp or telegram.",
                  "type": "string"
                },
                "client_ip": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "cost": {
                  "description": "Credits charged.",
                  "type": "number"
                },
                "country": {
                  "type": "string"
                },
                "description": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "force_send": {
                  "type": "boolean"
                },
                "message_id": {
                  "type": "string"
                },
                "message_timestamp": {
                  "description": "ISO 8601 date-time of the transaction.",
                  "type": "string"
                },
                "message_type": {
                  "description": "Whether this was an OTP send or a verification.",
                  "type": "integer"
                },
                "phone_number": {
                  "type": "string"
                },
                "status": {
                  "description": "Transaction status, e.g. delivered, read, failed.NoBalance.",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Prepare or complete an autonomous MyOTP credit purchase with USDC or card through Machine Payments Protocol (MPP). Use this when generate_otp or another send fails with HTTP 403 insufficient balance / NoBalance. The tool quotes first, then returns a structured 402 challenge and exact retry details for the agent's own MPP client; if fetch is already wrapped by a credential-carrying MPP runtime, it returns the credited response directly.",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "credits": {
            "description": "Number of credits to buy. Integer from 25 to 50,000.",
            "maximum": 50000,
            "minimum": 25,
            "type": "integer"
          },
          "dry_run": {
            "description": "If true, return only the quote and explanation without requesting a payment challenge.",
            "type": "boolean"
          }
        },
        "required": [
          "credits"
        ],
        "type": "object"
      },
      "name": "top_up_credits",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": true,
        "properties": {
          "amount_usd": {
            "description": "Amount paid in US dollars (settled result).",
            "type": "string"
          },
          "balance": {
            "description": "Account balance in credits after the top-up (settled result).",
            "type": "number"
          },
          "challengeId": {
            "description": "The MPP challenge id from the 402 response.",
            "type": "string"
          },
          "credits": {
            "description": "Credits bought in this call (settled result).",
            "type": "integer"
          },
          "currency": {
            "type": "string"
          },
          "explanation": {
            "description": "What happened and what the caller must do next (dry run and 402 results).",
            "type": "string"
          },
          "how_to_pay": {
            "additionalProperties": true,
            "description": "Ready-to-run client commands (402 result).",
            "properties": {
              "card": {
                "description": "Stripe Link CLI command that pays the challenge by card.",
                "type": "string"
              },
              "usdc": {
                "description": "mppx command that pays the challenge in USDC on Tempo.",
                "type": "string"
              }
            },
            "required": [
              "usdc",
              "card"
            ],
            "type": "object"
          },
          "offers": {
            "description": "Decoded Payment offers from the WWW-Authenticate challenge (402 result).",
            "items": {
              "additionalProperties": true,
              "properties": {
                "amount": {
                  "type": [
                    "string",
                    "number"
                  ]
                },
                "amount_unit": {
                  "description": "What amount is denominated in: USDC atomic units for tempo, cents for stripe.",
                  "type": "string"
                },
                "amount_usd": {
                  "description": "amount converted to USD with two decimals when the unit is known.",
                  "type": "string"
                },
                "currency": {
                  "type": "string"
                },
                "expires": {
                  "description": "ISO 8601 expiry of the offer.",
                  "type": "string"
                },
                "id": {
                  "type": "string"
                },
                "intent": {
                  "type": "string"
                },
                "method": {
                  "description": "tempo (USDC) or stripe (card).",
                  "type": "string"
                }
              },
              "required": [
                "method",
                "intent",
                "id",
                "expires",
                "amount",
                "amount_unit",
                "currency"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "payment": {
            "additionalProperties": true,
            "description": "Payment method and reference (settled result).",
            "properties": {
              "method": {
                "type": "string"
              },
              "reference": {
                "type": "string"
              }
            },
            "type": "object"
          },
          "plan_id": {
            "type": "integer"
          },
          "quote": {
            "additionalProperties": true,
            "description": "The quote for the requested credits (dry run and 402 results).",
            "properties": {
              "amount_usd": {
                "description": "Total price in US dollars, as a decimal string.",
                "type": "string"
              },
              "credits": {
                "description": "The number of credits priced.",
                "type": "integer"
              },
              "currency": {
                "description": "Always 'usd'.",
                "type": "string"
              },
              "max_credits": {
                "type": "integer"
              },
              "methods": {
                "description": "Human-readable list of the accepted payment methods.",
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              "min_credits": {
                "type": "integer"
              },
              "price_per_credit_usd": {
                "description": "Unit price. Currently 0.02.",
                "type": "number"
              }
            },
            "required": [
              "credits",
              "amount_usd",
              "price_per_credit_usd",
              "min_credits",
              "max_credits",
              "currency",
              "methods"
            ],
            "type": "object"
          },
          "retry": {
            "additionalProperties": true,
            "description": "The request to replay with a payment credential (402 result).",
            "properties": {
              "body": {
                "additionalProperties": {},
                "type": "object"
              },
              "headers": {
                "additionalProperties": {
                  "type": "string"
                },
                "description": "Headers to send; placeholders mark the API key and payment credential.",
                "type": "object"
              },
              "method": {
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "url",
              "method",
              "headers",
              "body"
            ],
            "type": "object"
          },
          "status": {
            "description": "'credited' or 'already_credited' (settled result).",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    {
      "description": "Verify a code submitted by an end user against the OTP MyOTP delivered. Returns `{status: 'success'}` if the code matches and the OTP hasn't expired — at that point the OTP is consumed and cannot be reused. Returns `{status: 'failed', reason: 'invalid' | 'expired' | 'not found'}` otherwise. You MUST pass either `phone_number` or `message_id` to identify which OTP you're verifying against. Call this after collecting the code from the user (login form, signup screen, etc.).",
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": false,
        "properties": {
          "message_id": {
            "description": "The UUID returned by `generate_otp`. Provide either this OR `phone_number`. Prefer this when you have it — it disambiguates if the same number got multiple OTPs.",
            "format": "uuid",
            "type": "string"
          },
          "otp": {
            "description": "The OTP code the end user typed in (3-8 numeric digits). This is the code you're trying to verify against what was sent.",
            "pattern": "^\\d{3,8}$",
            "type": "string"
          },
          "phone_number": {
            "description": "Phone number the OTP was originally sent to, in international format without + or leading 0. Provide either this OR `message_id` — `message_id` is more precise.",
            "pattern": "^[1-9]\\d{6,14}$",
            "type": "string"
          }
        },
        "required": [
          "otp"
        ],
        "type": "object"
      },
      "name": "verify_otp",
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "additionalProperties": true,
        "properties": {
          "message": {
            "description": "Message describing the verification result.",
            "type": "string"
          },
          "reason": {
            "description": "Why verification failed: 'invalid', 'expired' or 'not found'. Absent on success.",
            "type": "string"
          },
          "status": {
            "description": "'success' when the code matched and the OTP was consumed, otherwise 'failed' (or 'expired').",
            "type": "string"
          }
        },
        "required": [
          "status",
          "message"
        ],
        "type": "object"
      }
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:781474bd874b75cccd93b4a53bd72e48ed8aadccdfb482aeb9ff7ef4a23a9f5d | sha256sum