naftiko: 1.0.0-alpha2
info:
  label: Telstra Mobile Number Verification API — Verification
  description: 'Silent, in-network verification of a Telstra mobile customer''s MSISDN against the device''s
    mobile data session. Self-contained Naftiko capability.'
  tags:
  - Telstra
  - Verification
  - Identity
  - Authentication
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    TELSTRA_ACCESS_TOKEN: TELSTRA_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: mobile-number-verification
    baseUri: https://tapi.telstra.com/v1
    description: Telstra Mobile Number Verification. Bearer token from /oauth/token (MNV scope).
    resources:
    - name: mnv-verify
      path: /mobile-number-verification/verify
      operations:
      - name: verifymobilenumber
        method: POST
        description: Telstra Verify Mobile Number
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    authentication:
      type: bearer
      value: '{{env.TELSTRA_ACCESS_TOKEN}}'
      placement: header
  exposes:
  - type: mcp
    namespace: mobile-number-verification-mcp
    port: 9094
    transport: http
    description: MCP adapter for Telstra Mobile Number Verification.
    tools:
    - name: telstra-verify-mobile-number
      description: Telstra Verify Mobile Number
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: mobile-number-verification.verifymobilenumber
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.