Plaid user/ — Plaid

naftiko: 1.0.0-alpha2
info:
  label: Plaid user/ — Plaid
  description: 'Plaid user/ — Plaid. 7 operations. Lead operation: Plaid Create a Beacon User. Self-contained Naftiko capability
    covering one Plaid business surface.'
  tags:
  - Plaid
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    PLAID_API_KEY: PLAID_API_KEY
capability:
  consumes:
  - type: http
    namespace: user--plaid
    baseUri: https://production.plaid.com
    description: Plaid user/ — Plaid business capability. Self-contained, no shared references.
    resources:
    - name: beacon-user-create
      path: /beacon/user/create
      operations:
      - name: beaconusercreate
        method: POST
        description: Plaid Create a Beacon User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: beacon-user-get
      path: /beacon/user/get
      operations:
      - name: beaconuserget
        method: POST
        description: Plaid Get a Beacon User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: beacon-user-history-list
      path: /beacon/user/history/list
      operations:
      - name: beaconuserhistorylist
        method: POST
        description: Plaid List a Beacon User's history
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: beacon-user-review
      path: /beacon/user/review
      operations:
      - name: beaconuserreview
        method: POST
        description: Plaid Review a Beacon User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: beacon-user-update
      path: /beacon/user/update
      operations:
      - name: beaconuserupdate
        method: POST
        description: Plaid Update the identity data of a Beacon User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-create
      path: /user/create
      operations:
      - name: usercreate
        method: POST
        description: Plaid Create user
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: user-update
      path: /user/update
      operations:
      - name: userupdate
        method: POST
        description: Plaid Update user information
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  exposes:
  - type: rest
    namespace: user--plaid-rest
    port: 8080
    description: REST adapter for Plaid user/ — Plaid. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/beacon/user/create
      name: beacon-user-create
      description: REST surface for beacon-user-create.
      operations:
      - method: POST
        name: beaconusercreate
        description: Plaid Create a Beacon User
        call: user--plaid.beaconusercreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/beacon/user/get
      name: beacon-user-get
      description: REST surface for beacon-user-get.
      operations:
      - method: POST
        name: beaconuserget
        description: Plaid Get a Beacon User
        call: user--plaid.beaconuserget
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/beacon/user/history/list
      name: beacon-user-history-list
      description: REST surface for beacon-user-history-list.
      operations:
      - method: POST
        name: beaconuserhistorylist
        description: Plaid List a Beacon User's history
        call: user--plaid.beaconuserhistorylist
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/beacon/user/review
      name: beacon-user-review
      description: REST surface for beacon-user-review.
      operations:
      - method: POST
        name: beaconuserreview
        description: Plaid Review a Beacon User
        call: user--plaid.beaconuserreview
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/beacon/user/update
      name: beacon-user-update
      description: REST surface for beacon-user-update.
      operations:
      - method: POST
        name: beaconuserupdate
        description: Plaid Update the identity data of a Beacon User
        call: user--plaid.beaconuserupdate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/create
      name: user-create
      description: REST surface for user-create.
      operations:
      - method: POST
        name: usercreate
        description: Plaid Create user
        call: user--plaid.usercreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/user/update
      name: user-update
      description: REST surface for user-update.
      operations:
      - method: POST
        name: userupdate
        description: Plaid Update user information
        call: user--plaid.userupdate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: user--plaid-mcp
    port: 9090
    transport: http
    description: MCP adapter for Plaid user/ — Plaid. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: plaid-create-beacon-user
      description: Plaid Create a Beacon User
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: user--plaid.beaconusercreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: plaid-get-beacon-user
      description: Plaid Get a Beacon User
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: user--plaid.beaconuserget
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: plaid-list-beacon-user-s-history
      description: Plaid List a Beacon User's history
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: user--plaid.beaconuserhistorylist
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: plaid-review-beacon-user
      description: Plaid Review a Beacon User
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: user--plaid.beaconuserreview
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: plaid-update-identity-data-beacon
      description: Plaid Update the identity data of a Beacon User
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: user--plaid.beaconuserupdate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: plaid-create-user
      description: Plaid Create user
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: user--plaid.usercreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: plaid-update-user-information
      description: Plaid Update user information
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: user--plaid.userupdate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.