Majesco Insurance Policy Administration API

naftiko: 1.0.0-alpha2
info:
  label: Majesco Insurance Policy Administration API
  description: Majesco cloud-based insurance platform API for policy administration, claims management, billing, and distribution.
    Supports P&C, L&A, and specialty lines with REST interfaces for digital insurance operations.
  tags:
  - Majesco
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: majesco
    baseUri: https://api.majesco.example.com/v1
    description: Majesco Insurance Policy Administration API HTTP API.
    authentication:
      type: bearer
      token: '{{MAJESCO_TOKEN}}'
    resources:
    - name: policies
      path: /policies
      operations:
      - name: listpolicies
        method: GET
        description: List policies
        inputParameters:
        - name: status
          in: query
          type: string
          description: Filter by policy status
        - name: productType
          in: query
          type: string
          description: Filter by insurance product type
        - name: policyholderName
          in: query
          type: string
        - name: effectiveDateFrom
          in: query
          type: string
        - name: effectiveDateTo
          in: query
          type: string
        - name: pageSize
          in: query
          type: integer
        - name: pageToken
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createpolicy
        method: POST
        description: Create a new policy
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: policies-policynumber
      path: /policies/{policyNumber}
      operations:
      - name: getpolicy
        method: GET
        description: Get a policy by policy number
        inputParameters:
        - name: policyNumber
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatepolicy
        method: PATCH
        description: Update (endorse) a policy
        inputParameters:
        - name: policyNumber
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: policies-policynumber-cancel
      path: /policies/{policyNumber}/cancel
      operations:
      - name: cancelpolicy
        method: POST
        description: Cancel a policy
        inputParameters:
        - name: policyNumber
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: policies-policynumber-renew
      path: /policies/{policyNumber}/renew
      operations:
      - name: renewpolicy
        method: POST
        description: Renew a policy
        inputParameters:
        - name: policyNumber
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: claims
      path: /claims
      operations:
      - name: listclaims
        method: GET
        description: List claims
        inputParameters:
        - name: status
          in: query
          type: string
        - name: policyNumber
          in: query
          type: string
        - name: claimDateFrom
          in: query
          type: string
        - name: pageSize
          in: query
          type: integer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createclaim
        method: POST
        description: Create a new claim
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: claims-claimnumber
      path: /claims/{claimNumber}
      operations:
      - name: getclaim
        method: GET
        description: Get claim details
        inputParameters:
        - name: claimNumber
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: billing-accounts
      path: /billing/accounts
      operations:
      - name: listbillingaccounts
        method: GET
        description: List billing accounts
        inputParameters:
        - name: policyNumber
          in: query
          type: string
        - name: pageSize
          in: query
          type: integer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: billing-accounts-accountid-payments
      path: /billing/accounts/{accountId}/payments
      operations:
      - name: recordpayment
        method: POST
        description: Record a payment
        inputParameters:
        - name: accountId
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: quotes
      path: /quotes
      operations:
      - name: createquote
        method: POST
        description: Generate an insurance quote
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: majesco-rest
    description: REST adapter for Majesco Insurance Policy Administration API.
    resources:
    - path: /policies
      name: listpolicies
      operations:
      - method: GET
        name: listpolicies
        description: List policies
        call: majesco.listpolicies
        outputParameters:
        - type: object
          mapping: $.
    - path: /policies
      name: createpolicy
      operations:
      - method: POST
        name: createpolicy
        description: Create a new policy
        call: majesco.createpolicy
        outputParameters:
        - type: object
          mapping: $.
    - path: /policies/{policyNumber}
      name: getpolicy
      operations:
      - method: GET
        name: getpolicy
        description: Get a policy by policy number
        call: majesco.getpolicy
        with:
          policyNumber: rest.policyNumber
        outputParameters:
        - type: object
          mapping: $.
    - path: /policies/{policyNumber}
      name: updatepolicy
      operations:
      - method: PATCH
        name: updatepolicy
        description: Update (endorse) a policy
        call: majesco.updatepolicy
        with:
          policyNumber: rest.policyNumber
        outputParameters:
        - type: object
          mapping: $.
    - path: /policies/{policyNumber}/cancel
      name: cancelpolicy
      operations:
      - method: POST
        name: cancelpolicy
        description: Cancel a policy
        call: majesco.cancelpolicy
        with:
          policyNumber: rest.policyNumber
        outputParameters:
        - type: object
          mapping: $.
    - path: /policies/{policyNumber}/renew
      name: renewpolicy
      operations:
      - method: POST
        name: renewpolicy
        description: Renew a policy
        call: majesco.renewpolicy
        with:
          policyNumber: rest.policyNumber
        outputParameters:
        - type: object
          mapping: $.
    - path: /claims
      name: listclaims
      operations:
      - method: GET
        name: listclaims
        description: List claims
        call: majesco.listclaims
        outputParameters:
        - type: object
          mapping: $.
    - path: /claims
      name: createclaim
      operations:
      - method: POST
        name: createclaim
        description: Create a new claim
        call: majesco.createclaim
        outputParameters:
        - type: object
          mapping: $.
    - path: /claims/{claimNumber}
      name: getclaim
      operations:
      - method: GET
        name: getclaim
        description: Get claim details
        call: majesco.getclaim
        with:
          claimNumber: rest.claimNumber
        outputParameters:
        - type: object
          mapping: $.
    - path: /billing/accounts
      name: listbillingaccounts
      operations:
      - method: GET
        name: listbillingaccounts
        description: List billing accounts
        call: majesco.listbillingaccounts
        outputParameters:
        - type: object
          mapping: $.
    - path: /billing/accounts/{accountId}/payments
      name: recordpayment
      operations:
      - method: POST
        name: recordpayment
        description: Record a payment
        call: majesco.recordpayment
        with:
          accountId: rest.accountId
        outputParameters:
        - type: object
          mapping: $.
    - path: /quotes
      name: createquote
      operations:
      - method: POST
        name: createquote
        description: Generate an insurance quote
        call: majesco.createquote
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: majesco-mcp
    transport: http
    description: MCP adapter for Majesco Insurance Policy Administration API for AI agent use.
    tools:
    - name: listpolicies
      description: List policies
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: majesco.listpolicies
      with:
        status: tools.status
        productType: tools.productType
        policyholderName: tools.policyholderName
        effectiveDateFrom: tools.effectiveDateFrom
        effectiveDateTo: tools.effectiveDateTo
        pageSize: tools.pageSize
        pageToken: tools.pageToken
      inputParameters:
      - name: status
        type: string
        description: Filter by policy status
      - name: productType
        type: string
        description: Filter by insurance product type
      - name: policyholderName
        type: string
        description: policyholderName
      - name: effectiveDateFrom
        type: string
        description: effectiveDateFrom
      - name: effectiveDateTo
        type: string
        description: effectiveDateTo
      - name: pageSize
        type: integer
        description: pageSize
      - name: pageToken
        type: string
        description: pageToken
      outputParameters:
      - type: object
        mapping: $.
    - name: createpolicy
      description: Create a new policy
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: majesco.createpolicy
      outputParameters:
      - type: object
        mapping: $.
    - name: getpolicy
      description: Get a policy by policy number
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: majesco.getpolicy
      with:
        policyNumber: tools.policyNumber
      inputParameters:
      - name: policyNumber
        type: string
        description: policyNumber
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: updatepolicy
      description: Update (endorse) a policy
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: majesco.updatepolicy
      with:
        policyNumber: tools.policyNumber
      inputParameters:
      - name: policyNumber
        type: string
        description: policyNumber
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: cancelpolicy
      description: Cancel a policy
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: majesco.cancelpolicy
      with:
        policyNumber: tools.policyNumber
      inputParameters:
      - name: policyNumber
        type: string
        description: policyNumber
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: renewpolicy
      description: Renew a policy
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: majesco.renewpolicy
      with:
        policyNumber: tools.policyNumber
      inputParameters:
      - name: policyNumber
        type: string
        description: policyNumber
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listclaims
      description: List claims
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: majesco.listclaims
      with:
        status: tools.status
        policyNumber: tools.policyNumber
        claimDateFrom: tools.claimDateFrom
        pageSize: tools.pageSize
      inputParameters:
      - name: status
        type: string
        description: status
      - name: policyNumber
        type: string
        description: policyNumber
      - name: claimDateFrom
        type: string
        description: claimDateFrom
      - name: pageSize
        type: integer
        description: pageSize
      outputParameters:
      - type: object
        mapping: $.
    - name: createclaim
      description: Create a new claim
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: majesco.createclaim
      outputParameters:
      - type: object
        mapping: $.
    - name: getclaim
      description: Get claim details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: majesco.getclaim
      with:
        claimNumber: tools.claimNumber
      inputParameters:
      - name: claimNumber
        type: string
        description: claimNumber
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: listbillingaccounts
      description: List billing accounts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: majesco.listbillingaccounts
      with:
        policyNumber: tools.policyNumber
        pageSize: tools.pageSize
      inputParameters:
      - name: policyNumber
        type: string
        description: policyNumber
      - name: pageSize
        type: integer
        description: pageSize
      outputParameters:
      - type: object
        mapping: $.
    - name: recordpayment
      description: Record a payment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: majesco.recordpayment
      with:
        accountId: tools.accountId
      inputParameters:
      - name: accountId
        type: string
        description: accountId
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: createquote
      description: Generate an insurance quote
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: majesco.createquote
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    MAJESCO_TOKEN: MAJESCO_TOKEN