PokéAPI — Items

naftiko: 1.0.0-alpha2
info:
  label: "Pok\xE9API \u2014 Items"
  description: "Pok\xE9API Items capability. 10 read-only operations covering the items resource family."
  tags:
  - "Pok\xE9API"
  - Items
  created: '2026-05-30'
  modified: '2026-05-30'
capability:
  consumes:
  - type: http
    namespace: pokeapi-items
    baseUri: https://pokeapi.co/api/v2
    description: "Pok\xE9API Items business capability. Self-contained, no shared references."
    resources:
    - name: pokeapi-item
      path: /item
      operations:
      - name: listitems
        method: GET
        description: List Items
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
          description: Number of items to return per page.
        - name: offset
          in: query
          type: integer
          description: Number of items to skip before starting to collect the result set.
    - name: pokeapi-item-id
      path: /item/{id}
      operations:
      - name: getitem
        method: GET
        description: Get Item
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Resource id (integer) or name (slug).
    - name: pokeapi-item-attribute
      path: /item-attribute
      operations:
      - name: listitemattributes
        method: GET
        description: List Item Attributes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
          description: Number of items to return per page.
        - name: offset
          in: query
          type: integer
          description: Number of items to skip before starting to collect the result set.
    - name: pokeapi-item-attribute-id
      path: /item-attribute/{id}
      operations:
      - name: getitemattribute
        method: GET
        description: Get Item Attribute
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Resource id (integer) or name (slug).
    - name: pokeapi-item-category
      path: /item-category
      operations:
      - name: listitemcategories
        method: GET
        description: List Item Categories
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
          description: Number of items to return per page.
        - name: offset
          in: query
          type: integer
          description: Number of items to skip before starting to collect the result set.
    - name: pokeapi-item-category-id
      path: /item-category/{id}
      operations:
      - name: getitemcategory
        method: GET
        description: Get Item Category
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Resource id (integer) or name (slug).
    - name: pokeapi-item-fling-effect
      path: /item-fling-effect
      operations:
      - name: listitemflingeffects
        method: GET
        description: List Item Fling Effects
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
          description: Number of items to return per page.
        - name: offset
          in: query
          type: integer
          description: Number of items to skip before starting to collect the result set.
    - name: pokeapi-item-fling-effect-id
      path: /item-fling-effect/{id}
      operations:
      - name: getitemflingeffect
        method: GET
        description: Get Item Fling Effect
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Resource id (integer) or name (slug).
    - name: pokeapi-item-pocket
      path: /item-pocket
      operations:
      - name: listitempockets
        method: GET
        description: List Item Pockets
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
          description: Number of items to return per page.
        - name: offset
          in: query
          type: integer
          description: Number of items to skip before starting to collect the result set.
    - name: pokeapi-item-pocket-id
      path: /item-pocket/{id}
      operations:
      - name: getitempocket
        method: GET
        description: Get Item Pocket
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
          description: Resource id (integer) or name (slug).
    authentication:
      type: none
  exposes:
  - type: rest
    namespace: pokeapi-items-rest
    port: 8080
    description: "REST adapter for Pok\xE9API Items."
    resources:
    - path: /v1/item
      name: pokeapi-item
      description: REST surface for pokeapi-item.
      operations:
      - method: GET
        name: listitems
        description: List Items
        call: pokeapi-items.listitems
        with:
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/item/{id}
      name: pokeapi-item-id
      description: REST surface for pokeapi-item-id.
      operations:
      - method: GET
        name: getitem
        description: Get Item
        call: pokeapi-items.getitem
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/item-attribute
      name: pokeapi-item-attribute
      description: REST surface for pokeapi-item-attribute.
      operations:
      - method: GET
        name: listitemattributes
        description: List Item Attributes
        call: pokeapi-items.listitemattributes
        with:
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/item-attribute/{id}
      name: pokeapi-item-attribute-id
      description: REST surface for pokeapi-item-attribute-id.
      operations:
      - method: GET
        name: getitemattribute
        description: Get Item Attribute
        call: pokeapi-items.getitemattribute
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/item-category
      name: pokeapi-item-category
      description: REST surface for pokeapi-item-category.
      operations:
      - method: GET
        name: listitemcategories
        description: List Item Categories
        call: pokeapi-items.listitemcategories
        with:
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/item-category/{id}
      name: pokeapi-item-category-id
      description: REST surface for pokeapi-item-category-id.
      operations:
      - method: GET
        name: getitemcategory
        description: Get Item Category
        call: pokeapi-items.getitemcategory
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/item-fling-effect
      name: pokeapi-item-fling-effect
      description: REST surface for pokeapi-item-fling-effect.
      operations:
      - method: GET
        name: listitemflingeffects
        description: List Item Fling Effects
        call: pokeapi-items.listitemflingeffects
        with:
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/item-fling-effect/{id}
      name: pokeapi-item-fling-effect-id
      description: REST surface for pokeapi-item-fling-effect-id.
      operations:
      - method: GET
        name: getitemflingeffect
        description: Get Item Fling Effect
        call: pokeapi-items.getitemflingeffect
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/item-pocket
      name: pokeapi-item-pocket
      description: REST surface for pokeapi-item-pocket.
      operations:
      - method: GET
        name: listitempockets
        description: List Item Pockets
        call: pokeapi-items.listitempockets
        with:
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/item-pocket/{id}
      name: pokeapi-item-pocket-id
      description: REST surface for pokeapi-item-pocket-id.
      operations:
      - method: GET
        name: getitempocket
        description: Get Item Pocket
        call: pokeapi-items.getitempocket
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: pokeapi-items-mcp
    port: 9090
    transport: http
    description: "MCP adapter for Pok\xE9API Items."
    tools:
    - name: pokeapi-listitems
      description: List Items
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pokeapi-items.listitems
      with:
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: pokeapi-getitem
      description: Get Item
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pokeapi-items.getitem
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: pokeapi-listitemattributes
      description: List Item Attributes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pokeapi-items.listitemattributes
      with:
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: pokeapi-getitemattribute
      description: Get Item Attribute
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pokeapi-items.getitemattribute
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: pokeapi-listitemcategories
      description: List Item Categories
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pokeapi-items.listitemcategories
      with:
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: pokeapi-getitemcategory
      description: Get Item Category
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pokeapi-items.getitemcategory
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: pokeapi-listitemflingeffects
      description: List Item Fling Effects
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pokeapi-items.listitemflingeffects
      with:
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: pokeapi-getitemflingeffect
      description: Get Item Fling Effect
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pokeapi-items.getitemflingeffect
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: pokeapi-listitempockets
      description: List Item Pockets
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pokeapi-items.listitempockets
      with:
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: pokeapi-getitempocket
      description: Get Item Pocket
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pokeapi-items.getitempocket
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.