naftiko: 1.0.0-alpha2
info:
  label: ThemeParks.wiki API — Entities
  description: 'ThemeParks.wiki API — Entities. 5 operations. Lead operation: ThemeParks.wiki Get Entity Details. Self-contained
    Naftiko capability covering one Themeparks Wiki business surface.'
  tags:
  - Themeparks Wiki
  - Entities
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    THEMEPARKS_WIKI_API_KEY: THEMEPARKS_WIKI_API_KEY
capability:
  consumes:
  - type: http
    namespace: themeparks-wiki-entities
    baseUri: https://api.themeparks.wiki/v1
    description: ThemeParks.wiki API — Entities business capability. Self-contained, no shared references.
    resources:
    - name: entity-entityID
      path: /entity/{entityID}
      operations:
      - name: getentity
        method: GET
        description: ThemeParks.wiki Get Entity Details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: entityID
          in: path
          type: string
          description: Unique entity UUID identifier
          required: true
    - name: entity-entityID-children
      path: /entity/{entityID}/children
      operations:
      - name: getentitychildren
        method: GET
        description: ThemeParks.wiki Get Entity Children
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: entityID
          in: path
          type: string
          description: Unique entity UUID identifier
          required: true
    - name: entity-entityID-live
      path: /entity/{entityID}/live
      operations:
      - name: getentitylivedata
        method: GET
        description: ThemeParks.wiki Get Live Entity Data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: entityID
          in: path
          type: string
          description: Unique entity UUID identifier
          required: true
    - name: entity-entityID-schedule
      path: /entity/{entityID}/schedule
      operations:
      - name: getentityschedule
        method: GET
        description: ThemeParks.wiki Get Entity Schedule
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: entityID
          in: path
          type: string
          description: Unique entity UUID identifier
          required: true
    - name: entity-entityID-schedule-year-month
      path: /entity/{entityID}/schedule/{year}/{month}
      operations:
      - name: getentityschedulebymonth
        method: GET
        description: ThemeParks.wiki Get Entity Schedule for Specific Month
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: entityID
          in: path
          type: string
          description: Unique entity UUID identifier
          required: true
        - name: year
          in: path
          type: integer
          description: Four-digit year
          required: true
        - name: month
          in: path
          type: integer
          description: Month number (1-12)
          required: true
  exposes:
  - type: rest
    namespace: themeparks-wiki-entities-rest
    port: 8080
    description: REST adapter for ThemeParks.wiki API — Entities. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/entity/{entityid}
      name: entity-entityid
      description: REST surface for entity-entityID.
      operations:
      - method: GET
        name: getentity
        description: ThemeParks.wiki Get Entity Details
        call: themeparks-wiki-entities.getentity
        with:
          entityID: rest.entityID
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/entity/{entityid}/children
      name: entity-entityid-children
      description: REST surface for entity-entityID-children.
      operations:
      - method: GET
        name: getentitychildren
        description: ThemeParks.wiki Get Entity Children
        call: themeparks-wiki-entities.getentitychildren
        with:
          entityID: rest.entityID
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/entity/{entityid}/live
      name: entity-entityid-live
      description: REST surface for entity-entityID-live.
      operations:
      - method: GET
        name: getentitylivedata
        description: ThemeParks.wiki Get Live Entity Data
        call: themeparks-wiki-entities.getentitylivedata
        with:
          entityID: rest.entityID
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/entity/{entityid}/schedule
      name: entity-entityid-schedule
      description: REST surface for entity-entityID-schedule.
      operations:
      - method: GET
        name: getentityschedule
        description: ThemeParks.wiki Get Entity Schedule
        call: themeparks-wiki-entities.getentityschedule
        with:
          entityID: rest.entityID
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/entity/{entityid}/schedule/{year}/{month}
      name: entity-entityid-schedule-year-month
      description: REST surface for entity-entityID-schedule-year-month.
      operations:
      - method: GET
        name: getentityschedulebymonth
        description: ThemeParks.wiki Get Entity Schedule for Specific Month
        call: themeparks-wiki-entities.getentityschedulebymonth
        with:
          entityID: rest.entityID
          year: rest.year
          month: rest.month
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: themeparks-wiki-entities-mcp
    port: 9090
    transport: http
    description: MCP adapter for ThemeParks.wiki API — Entities. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: themeparks-wiki-get-entity-details
      description: ThemeParks.wiki Get Entity Details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: themeparks-wiki-entities.getentity
      with:
        entityID: tools.entityID
      outputParameters:
      - type: object
        mapping: $.
    - name: themeparks-wiki-get-entity-children
      description: ThemeParks.wiki Get Entity Children
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: themeparks-wiki-entities.getentitychildren
      with:
        entityID: tools.entityID
      outputParameters:
      - type: object
        mapping: $.
    - name: themeparks-wiki-get-live-entity-data
      description: ThemeParks.wiki Get Live Entity Data
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: themeparks-wiki-entities.getentitylivedata
      with:
        entityID: tools.entityID
      outputParameters:
      - type: object
        mapping: $.
    - name: themeparks-wiki-get-entity-schedule
      description: ThemeParks.wiki Get Entity Schedule
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: themeparks-wiki-entities.getentityschedule
      with:
        entityID: tools.entityID
      outputParameters:
      - type: object
        mapping: $.
    - name: themeparks-wiki-get-entity-schedule-specific
      description: ThemeParks.wiki Get Entity Schedule for Specific Month
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: themeparks-wiki-entities.getentityschedulebymonth
      with:
        entityID: tools.entityID
        year: tools.year
        month: tools.month
      outputParameters:
      - type: object
        mapping: $.