EVE Online ESI — Corporation

naftiko: 1.0.0-alpha2
info:
  label: EVE Online ESI — Corporation
  description: 'ESI — Corporation. 22 operations. Lead operation: EVE Online Get Npc Corporations. Self-contained Naftiko capability covering one EVE Online business surface.'
  tags:
    - EVE Online
    - ESI
    - Corporation
  created: '2026-05-30'
  modified: '2026-05-30'
binds:
  - namespace: env
    keys:
      EVE_ONLINE_ACCESS_TOKEN: EVE_ONLINE_ACCESS_TOKEN
capability:
  consumes:
    - type: http
      namespace: eve-online-corporation
      baseUri: https://esi.evetech.net/latest
      description: EVE Online ESI — Corporation business capability. Self-contained, no shared references.
      authentication:
        type: bearer
        token: '{{env.EVE_ONLINE_ACCESS_TOKEN}}'
      resources:
        - name: corporations-npccorps
          path: /corporations/npccorps/
          operations:
            - name: get_corporations_npccorps
              method: GET
              description: EVE Online Get Npc Corporations
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id
          path: /corporations/{corporation_id}/
          operations:
            - name: get_corporations_corporation_id
              method: GET
              description: EVE Online Get Corporation Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-alliancehistory
          path: /corporations/{corporation_id}/alliancehistory/
          operations:
            - name: get_corporations_corporation_id_alliancehistory
              method: GET
              description: EVE Online Get Alliance History
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-blueprints
          path: /corporations/{corporation_id}/blueprints/
          operations:
            - name: get_corporations_corporation_id_blueprints
              method: GET
              description: EVE Online Get Corporation Blueprints
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-containers-logs
          path: /corporations/{corporation_id}/containers/logs/
          operations:
            - name: get_corporations_corporation_id_containers_logs
              method: GET
              description: EVE Online Get All Corporation ALSC Logs
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-divisions
          path: /corporations/{corporation_id}/divisions/
          operations:
            - name: get_corporations_corporation_id_divisions
              method: GET
              description: EVE Online Get Corporation Divisions
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-facilities
          path: /corporations/{corporation_id}/facilities/
          operations:
            - name: get_corporations_corporation_id_facilities
              method: GET
              description: EVE Online Get Corporation Facilities
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-icons
          path: /corporations/{corporation_id}/icons/
          operations:
            - name: get_corporations_corporation_id_icons
              method: GET
              description: EVE Online Get Corporation Icon
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-medals
          path: /corporations/{corporation_id}/medals/
          operations:
            - name: get_corporations_corporation_id_medals
              method: GET
              description: EVE Online Get Corporation Medals
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-medals-issued
          path: /corporations/{corporation_id}/medals/issued/
          operations:
            - name: get_corporations_corporation_id_medals_issued
              method: GET
              description: EVE Online Get Corporation Issued Medals
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-members
          path: /corporations/{corporation_id}/members/
          operations:
            - name: get_corporations_corporation_id_members
              method: GET
              description: EVE Online Get Corporation Members
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-members-limit
          path: /corporations/{corporation_id}/members/limit/
          operations:
            - name: get_corporations_corporation_id_members_limit
              method: GET
              description: EVE Online Get Corporation Member Limit
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-members-titles
          path: /corporations/{corporation_id}/members/titles/
          operations:
            - name: get_corporations_corporation_id_members_titles
              method: GET
              description: EVE Online Get Corporation's Members' Titles
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-membertracking
          path: /corporations/{corporation_id}/membertracking/
          operations:
            - name: get_corporations_corporation_id_membertracking
              method: GET
              description: EVE Online Track Corporation Members
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-roles
          path: /corporations/{corporation_id}/roles/
          operations:
            - name: get_corporations_corporation_id_roles
              method: GET
              description: EVE Online Get Corporation Member Roles
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-roles-history
          path: /corporations/{corporation_id}/roles/history/
          operations:
            - name: get_corporations_corporation_id_roles_history
              method: GET
              description: EVE Online Get Corporation Member Roles History
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-shareholders
          path: /corporations/{corporation_id}/shareholders/
          operations:
            - name: get_corporations_corporation_id_shareholders
              method: GET
              description: EVE Online Get Corporation Shareholders
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-standings
          path: /corporations/{corporation_id}/standings/
          operations:
            - name: get_corporations_corporation_id_standings
              method: GET
              description: EVE Online Get Corporation Standings
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-starbases
          path: /corporations/{corporation_id}/starbases/
          operations:
            - name: get_corporations_corporation_id_starbases
              method: GET
              description: EVE Online Get Corporation Starbases (POSes)
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-starbases-starbase-id
          path: /corporations/{corporation_id}/starbases/{starbase_id}/
          operations:
            - name: get_corporations_corporation_id_starbases_starbase_id
              method: GET
              description: EVE Online Get Starbase (POS) Detail
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: starbase_id
                  in: path
                  type: integer
                  required: true
                  description: An EVE starbase (POS) ID
                - name: system_id
                  in: query
                  type: integer
                  required: true
                  description: The solar system this starbase (POS) is located in,
        - name: corporations-corporation-id-structures
          path: /corporations/{corporation_id}/structures/
          operations:
            - name: get_corporations_corporation_id_structures
              method: GET
              description: EVE Online Get Corporation Structures
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: corporations-corporation-id-titles
          path: /corporations/{corporation_id}/titles/
          operations:
            - name: get_corporations_corporation_id_titles
              method: GET
              description: EVE Online Get Corporation Titles
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
  exposes:
    - type: rest
      namespace: eve-online-corporation-rest
      port: 8080
      description: REST adapter for EVE Online ESI — Corporation. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/corporations/npccorps
          name: corporations-npccorps
          description: REST surface for /corporations/npccorps/.
          operations:
            - method: GET
              name: get_corporations_npccorps
              description: EVE Online Get Npc Corporations
              call: eve-online-corporation.get_corporations_npccorps
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}
          name: corporations-corporation-id
          description: REST surface for /corporations/{corporation_id}/.
          operations:
            - method: GET
              name: get_corporations_corporation_id
              description: EVE Online Get Corporation Information
              call: eve-online-corporation.get_corporations_corporation_id
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/alliancehistory
          name: corporations-corporation-id-alliancehistory
          description: REST surface for /corporations/{corporation_id}/alliancehistory/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_alliancehistory
              description: EVE Online Get Alliance History
              call: eve-online-corporation.get_corporations_corporation_id_alliancehistory
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/blueprints
          name: corporations-corporation-id-blueprints
          description: REST surface for /corporations/{corporation_id}/blueprints/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_blueprints
              description: EVE Online Get Corporation Blueprints
              call: eve-online-corporation.get_corporations_corporation_id_blueprints
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/containers/logs
          name: corporations-corporation-id-containers-logs
          description: REST surface for /corporations/{corporation_id}/containers/logs/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_containers_logs
              description: EVE Online Get All Corporation ALSC Logs
              call: eve-online-corporation.get_corporations_corporation_id_containers_logs
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/divisions
          name: corporations-corporation-id-divisions
          description: REST surface for /corporations/{corporation_id}/divisions/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_divisions
              description: EVE Online Get Corporation Divisions
              call: eve-online-corporation.get_corporations_corporation_id_divisions
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/facilities
          name: corporations-corporation-id-facilities
          description: REST surface for /corporations/{corporation_id}/facilities/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_facilities
              description: EVE Online Get Corporation Facilities
              call: eve-online-corporation.get_corporations_corporation_id_facilities
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/icons
          name: corporations-corporation-id-icons
          description: REST surface for /corporations/{corporation_id}/icons/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_icons
              description: EVE Online Get Corporation Icon
              call: eve-online-corporation.get_corporations_corporation_id_icons
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/medals
          name: corporations-corporation-id-medals
          description: REST surface for /corporations/{corporation_id}/medals/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_medals
              description: EVE Online Get Corporation Medals
              call: eve-online-corporation.get_corporations_corporation_id_medals
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/medals/issued
          name: corporations-corporation-id-medals-issued
          description: REST surface for /corporations/{corporation_id}/medals/issued/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_medals_issued
              description: EVE Online Get Corporation Issued Medals
              call: eve-online-corporation.get_corporations_corporation_id_medals_issued
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/members
          name: corporations-corporation-id-members
          description: REST surface for /corporations/{corporation_id}/members/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_members
              description: EVE Online Get Corporation Members
              call: eve-online-corporation.get_corporations_corporation_id_members
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/members/limit
          name: corporations-corporation-id-members-limit
          description: REST surface for /corporations/{corporation_id}/members/limit/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_members_limit
              description: EVE Online Get Corporation Member Limit
              call: eve-online-corporation.get_corporations_corporation_id_members_limit
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/members/titles
          name: corporations-corporation-id-members-titles
          description: REST surface for /corporations/{corporation_id}/members/titles/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_members_titles
              description: EVE Online Get Corporation's Members' Titles
              call: eve-online-corporation.get_corporations_corporation_id_members_titles
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/membertracking
          name: corporations-corporation-id-membertracking
          description: REST surface for /corporations/{corporation_id}/membertracking/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_membertracking
              description: EVE Online Track Corporation Members
              call: eve-online-corporation.get_corporations_corporation_id_membertracking
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/roles
          name: corporations-corporation-id-roles
          description: REST surface for /corporations/{corporation_id}/roles/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_roles
              description: EVE Online Get Corporation Member Roles
              call: eve-online-corporation.get_corporations_corporation_id_roles
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/roles/history
          name: corporations-corporation-id-roles-history
          description: REST surface for /corporations/{corporation_id}/roles/history/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_roles_history
              description: EVE Online Get Corporation Member Roles History
              call: eve-online-corporation.get_corporations_corporation_id_roles_history
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/shareholders
          name: corporations-corporation-id-shareholders
          description: REST surface for /corporations/{corporation_id}/shareholders/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_shareholders
              description: EVE Online Get Corporation Shareholders
              call: eve-online-corporation.get_corporations_corporation_id_shareholders
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/standings
          name: corporations-corporation-id-standings
          description: REST surface for /corporations/{corporation_id}/standings/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_standings
              description: EVE Online Get Corporation Standings
              call: eve-online-corporation.get_corporations_corporation_id_standings
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/starbases
          name: corporations-corporation-id-starbases
          description: REST surface for /corporations/{corporation_id}/starbases/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_starbases
              description: EVE Online Get Corporation Starbases (POSes)
              call: eve-online-corporation.get_corporations_corporation_id_starbases
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/starbases/{starbase-id}
          name: corporations-corporation-id-starbases-starbase-id
          description: REST surface for /corporations/{corporation_id}/starbases/{starbase_id}/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_starbases_starbase_id
              description: EVE Online Get Starbase (POS) Detail
              call: eve-online-corporation.get_corporations_corporation_id_starbases_starbase_id
              with:
                starbase_id: rest.starbase_id
                system_id: rest.system_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/structures
          name: corporations-corporation-id-structures
          description: REST surface for /corporations/{corporation_id}/structures/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_structures
              description: EVE Online Get Corporation Structures
              call: eve-online-corporation.get_corporations_corporation_id_structures
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/corporations/{corporation-id}/titles
          name: corporations-corporation-id-titles
          description: REST surface for /corporations/{corporation_id}/titles/.
          operations:
            - method: GET
              name: get_corporations_corporation_id_titles
              description: EVE Online Get Corporation Titles
              call: eve-online-corporation.get_corporations_corporation_id_titles
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: eve-online-corporation-mcp
      port: 9090
      transport: http
      description: MCP adapter for EVE Online ESI — Corporation. One tool per consumed operation, routed inline through this capability's consumes block.
      tools:
        - name: get-npc-corporations
          description: EVE Online Get Npc Corporations
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_npccorps
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-information
          description: EVE Online Get Corporation Information
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-alliance-history
          description: EVE Online Get Alliance History
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_alliancehistory
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-blueprints
          description: EVE Online Get Corporation Blueprints
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_blueprints
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-all-corporation-alsc-logs
          description: EVE Online Get All Corporation ALSC Logs
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_containers_logs
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-divisions
          description: EVE Online Get Corporation Divisions
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_divisions
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-facilities
          description: EVE Online Get Corporation Facilities
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_facilities
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-icon
          description: EVE Online Get Corporation Icon
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_icons
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-medals
          description: EVE Online Get Corporation Medals
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_medals
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-issued-medals
          description: EVE Online Get Corporation Issued Medals
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_medals_issued
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-members
          description: EVE Online Get Corporation Members
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_members
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-member-limit
          description: EVE Online Get Corporation Member Limit
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_members_limit
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-s-members-titles
          description: EVE Online Get Corporation's Members' Titles
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_members_titles
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: track-corporation-members
          description: EVE Online Track Corporation Members
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_membertracking
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-member-roles
          description: EVE Online Get Corporation Member Roles
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_roles
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-member-roles-history
          description: EVE Online Get Corporation Member Roles History
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_roles_history
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-shareholders
          description: EVE Online Get Corporation Shareholders
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_shareholders
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-standings
          description: EVE Online Get Corporation Standings
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_standings
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-starbases-poses
          description: EVE Online Get Corporation Starbases (POSes)
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_starbases
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-starbase-pos-detail
          description: EVE Online Get Starbase (POS) Detail
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_starbases_starbase_id
          with:
            starbase_id: tools.starbase_id
            system_id: tools.system_id
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-structures
          description: EVE Online Get Corporation Structures
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-corporation.get_corporations_corporation_id_structures
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-titles
          description: EVE Online Get Corporation Titles
          hints:
            readOnly: true
            destructive: false
            idempotent: true


# --- truncated at 32 KB (32 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/eve-online/refs/heads/main/capabilities/eve-online-corporation.yaml