EVE Online ESI — Universe

naftiko: 1.0.0-alpha2
info:
  label: EVE Online ESI — Universe
  description: 'ESI — Universe. 30 operations. Lead operation: EVE Online Get Ancestries. Self-contained Naftiko capability covering one EVE Online business surface.'
  tags:
    - EVE Online
    - ESI
    - Universe
  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-universe
      baseUri: https://esi.evetech.net/latest
      description: EVE Online ESI — Universe business capability. Self-contained, no shared references.
      authentication:
        type: bearer
        token: '{{env.EVE_ONLINE_ACCESS_TOKEN}}'
      resources:
        - name: universe-ancestries
          path: /universe/ancestries/
          operations:
            - name: get_universe_ancestries
              method: GET
              description: EVE Online Get Ancestries
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-asteroid-belts-asteroid-belt-id
          path: /universe/asteroid_belts/{asteroid_belt_id}/
          operations:
            - name: get_universe_asteroid_belts_asteroid_belt_id
              method: GET
              description: EVE Online Get Asteroid Belt Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: asteroid_belt_id
                  in: path
                  type: integer
                  required: true
                  description: asteroid_belt_id integer
        - name: universe-bloodlines
          path: /universe/bloodlines/
          operations:
            - name: get_universe_bloodlines
              method: GET
              description: EVE Online Get Bloodlines
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-categories
          path: /universe/categories/
          operations:
            - name: get_universe_categories
              method: GET
              description: EVE Online Get Item Categories
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-categories-category-id
          path: /universe/categories/{category_id}/
          operations:
            - name: get_universe_categories_category_id
              method: GET
              description: EVE Online Get Item Category Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: category_id
                  in: path
                  type: integer
                  required: true
                  description: An Eve item category ID
        - name: universe-constellations
          path: /universe/constellations/
          operations:
            - name: get_universe_constellations
              method: GET
              description: EVE Online Get Constellations
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-constellations-constellation-id
          path: /universe/constellations/{constellation_id}/
          operations:
            - name: get_universe_constellations_constellation_id
              method: GET
              description: EVE Online Get Constellation Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: constellation_id
                  in: path
                  type: integer
                  required: true
                  description: constellation_id integer
        - name: universe-factions
          path: /universe/factions/
          operations:
            - name: get_universe_factions
              method: GET
              description: EVE Online Get Factions
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-graphics
          path: /universe/graphics/
          operations:
            - name: get_universe_graphics
              method: GET
              description: EVE Online Get Graphics
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-graphics-graphic-id
          path: /universe/graphics/{graphic_id}/
          operations:
            - name: get_universe_graphics_graphic_id
              method: GET
              description: EVE Online Get Graphic Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: graphic_id
                  in: path
                  type: integer
                  required: true
                  description: graphic_id integer
        - name: universe-groups
          path: /universe/groups/
          operations:
            - name: get_universe_groups
              method: GET
              description: EVE Online Get Item Groups
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-groups-group-id
          path: /universe/groups/{group_id}/
          operations:
            - name: get_universe_groups_group_id
              method: GET
              description: EVE Online Get Item Group Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: group_id
                  in: path
                  type: integer
                  required: true
                  description: An Eve item group ID
        - name: universe-ids
          path: /universe/ids/
          operations:
            - name: post_universe_ids
              method: POST
              description: EVE Online Bulk Names to IDs
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
                  description: Request body payload.
        - name: universe-moons-moon-id
          path: /universe/moons/{moon_id}/
          operations:
            - name: get_universe_moons_moon_id
              method: GET
              description: EVE Online Get Moon Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: moon_id
                  in: path
                  type: integer
                  required: true
                  description: moon_id integer
        - name: universe-names
          path: /universe/names/
          operations:
            - name: post_universe_names
              method: POST
              description: EVE Online Get Names and Categories for a Set of IDs
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
                  description: Request body payload.
        - name: universe-planets-planet-id
          path: /universe/planets/{planet_id}/
          operations:
            - name: get_universe_planets_planet_id
              method: GET
              description: EVE Online Get Planet Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: planet_id
                  in: path
                  type: integer
                  required: true
                  description: planet_id integer
        - name: universe-races
          path: /universe/races/
          operations:
            - name: get_universe_races
              method: GET
              description: EVE Online Get Character Races
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-regions
          path: /universe/regions/
          operations:
            - name: get_universe_regions
              method: GET
              description: EVE Online Get Regions
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-regions-region-id
          path: /universe/regions/{region_id}/
          operations:
            - name: get_universe_regions_region_id
              method: GET
              description: EVE Online Get Region Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: region_id
                  in: path
                  type: integer
                  required: true
                  description: region_id integer
        - name: universe-stargates-stargate-id
          path: /universe/stargates/{stargate_id}/
          operations:
            - name: get_universe_stargates_stargate_id
              method: GET
              description: EVE Online Get Stargate Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: stargate_id
                  in: path
                  type: integer
                  required: true
                  description: stargate_id integer
        - name: universe-stars-star-id
          path: /universe/stars/{star_id}/
          operations:
            - name: get_universe_stars_star_id
              method: GET
              description: EVE Online Get Star Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: star_id
                  in: path
                  type: integer
                  required: true
                  description: star_id integer
        - name: universe-stations-station-id
          path: /universe/stations/{station_id}/
          operations:
            - name: get_universe_stations_station_id
              method: GET
              description: EVE Online Get Station Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: station_id
                  in: path
                  type: integer
                  required: true
                  description: station_id integer
        - name: universe-structures
          path: /universe/structures/
          operations:
            - name: get_universe_structures
              method: GET
              description: EVE Online List All Public Structures
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: filter
                  in: query
                  type: string
                  required: false
                  description: Only list public structures that have this service online
        - name: universe-structures-structure-id
          path: /universe/structures/{structure_id}/
          operations:
            - name: get_universe_structures_structure_id
              method: GET
              description: EVE Online Get Structure Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: structure_id
                  in: path
                  type: integer
                  required: true
                  description: An Eve structure ID
        - name: universe-system-jumps
          path: /universe/system_jumps/
          operations:
            - name: get_universe_system_jumps
              method: GET
              description: EVE Online Get System Jumps
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-system-kills
          path: /universe/system_kills/
          operations:
            - name: get_universe_system_kills
              method: GET
              description: EVE Online Get System Kills
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-systems
          path: /universe/systems/
          operations:
            - name: get_universe_systems
              method: GET
              description: EVE Online Get Solar Systems
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-systems-system-id
          path: /universe/systems/{system_id}/
          operations:
            - name: get_universe_systems_system_id
              method: GET
              description: EVE Online Get Solar System Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: system_id
                  in: path
                  type: integer
                  required: true
                  description: system_id integer
        - name: universe-types
          path: /universe/types/
          operations:
            - name: get_universe_types
              method: GET
              description: EVE Online Get Types
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: universe-types-type-id
          path: /universe/types/{type_id}/
          operations:
            - name: get_universe_types_type_id
              method: GET
              description: EVE Online Get Type Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: type_id
                  in: path
                  type: integer
                  required: true
                  description: An Eve item type ID
  exposes:
    - type: rest
      namespace: eve-online-universe-rest
      port: 8080
      description: REST adapter for EVE Online ESI — Universe. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/universe/ancestries
          name: universe-ancestries
          description: REST surface for /universe/ancestries/.
          operations:
            - method: GET
              name: get_universe_ancestries
              description: EVE Online Get Ancestries
              call: eve-online-universe.get_universe_ancestries
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/asteroid-belts/{asteroid-belt-id}
          name: universe-asteroid-belts-asteroid-belt-id
          description: REST surface for /universe/asteroid_belts/{asteroid_belt_id}/.
          operations:
            - method: GET
              name: get_universe_asteroid_belts_asteroid_belt_id
              description: EVE Online Get Asteroid Belt Information
              call: eve-online-universe.get_universe_asteroid_belts_asteroid_belt_id
              with:
                asteroid_belt_id: rest.asteroid_belt_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/bloodlines
          name: universe-bloodlines
          description: REST surface for /universe/bloodlines/.
          operations:
            - method: GET
              name: get_universe_bloodlines
              description: EVE Online Get Bloodlines
              call: eve-online-universe.get_universe_bloodlines
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/categories
          name: universe-categories
          description: REST surface for /universe/categories/.
          operations:
            - method: GET
              name: get_universe_categories
              description: EVE Online Get Item Categories
              call: eve-online-universe.get_universe_categories
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/categories/{category-id}
          name: universe-categories-category-id
          description: REST surface for /universe/categories/{category_id}/.
          operations:
            - method: GET
              name: get_universe_categories_category_id
              description: EVE Online Get Item Category Information
              call: eve-online-universe.get_universe_categories_category_id
              with:
                category_id: rest.category_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/constellations
          name: universe-constellations
          description: REST surface for /universe/constellations/.
          operations:
            - method: GET
              name: get_universe_constellations
              description: EVE Online Get Constellations
              call: eve-online-universe.get_universe_constellations
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/constellations/{constellation-id}
          name: universe-constellations-constellation-id
          description: REST surface for /universe/constellations/{constellation_id}/.
          operations:
            - method: GET
              name: get_universe_constellations_constellation_id
              description: EVE Online Get Constellation Information
              call: eve-online-universe.get_universe_constellations_constellation_id
              with:
                constellation_id: rest.constellation_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/factions
          name: universe-factions
          description: REST surface for /universe/factions/.
          operations:
            - method: GET
              name: get_universe_factions
              description: EVE Online Get Factions
              call: eve-online-universe.get_universe_factions
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/graphics
          name: universe-graphics
          description: REST surface for /universe/graphics/.
          operations:
            - method: GET
              name: get_universe_graphics
              description: EVE Online Get Graphics
              call: eve-online-universe.get_universe_graphics
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/graphics/{graphic-id}
          name: universe-graphics-graphic-id
          description: REST surface for /universe/graphics/{graphic_id}/.
          operations:
            - method: GET
              name: get_universe_graphics_graphic_id
              description: EVE Online Get Graphic Information
              call: eve-online-universe.get_universe_graphics_graphic_id
              with:
                graphic_id: rest.graphic_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/groups
          name: universe-groups
          description: REST surface for /universe/groups/.
          operations:
            - method: GET
              name: get_universe_groups
              description: EVE Online Get Item Groups
              call: eve-online-universe.get_universe_groups
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/groups/{group-id}
          name: universe-groups-group-id
          description: REST surface for /universe/groups/{group_id}/.
          operations:
            - method: GET
              name: get_universe_groups_group_id
              description: EVE Online Get Item Group Information
              call: eve-online-universe.get_universe_groups_group_id
              with:
                group_id: rest.group_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/ids
          name: universe-ids
          description: REST surface for /universe/ids/.
          operations:
            - method: POST
              name: post_universe_ids
              description: EVE Online Bulk Names to IDs
              call: eve-online-universe.post_universe_ids
              with:
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/moons/{moon-id}
          name: universe-moons-moon-id
          description: REST surface for /universe/moons/{moon_id}/.
          operations:
            - method: GET
              name: get_universe_moons_moon_id
              description: EVE Online Get Moon Information
              call: eve-online-universe.get_universe_moons_moon_id
              with:
                moon_id: rest.moon_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/names
          name: universe-names
          description: REST surface for /universe/names/.
          operations:
            - method: POST
              name: post_universe_names
              description: EVE Online Get Names and Categories for a Set of IDs
              call: eve-online-universe.post_universe_names
              with:
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/planets/{planet-id}
          name: universe-planets-planet-id
          description: REST surface for /universe/planets/{planet_id}/.
          operations:
            - method: GET
              name: get_universe_planets_planet_id
              description: EVE Online Get Planet Information
              call: eve-online-universe.get_universe_planets_planet_id
              with:
                planet_id: rest.planet_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/races
          name: universe-races
          description: REST surface for /universe/races/.
          operations:
            - method: GET
              name: get_universe_races
              description: EVE Online Get Character Races
              call: eve-online-universe.get_universe_races
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/regions
          name: universe-regions
          description: REST surface for /universe/regions/.
          operations:
            - method: GET
              name: get_universe_regions
              description: EVE Online Get Regions
              call: eve-online-universe.get_universe_regions
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/regions/{region-id}
          name: universe-regions-region-id
          description: REST surface for /universe/regions/{region_id}/.
          operations:
            - method: GET
              name: get_universe_regions_region_id
              description: EVE Online Get Region Information
              call: eve-online-universe.get_universe_regions_region_id
              with:
                region_id: rest.region_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/stargates/{stargate-id}
          name: universe-stargates-stargate-id
          description: REST surface for /universe/stargates/{stargate_id}/.
          operations:
            - method: GET
              name: get_universe_stargates_stargate_id
              description: EVE Online Get Stargate Information
              call: eve-online-universe.get_universe_stargates_stargate_id
              with:
                stargate_id: rest.stargate_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/stars/{star-id}
          name: universe-stars-star-id
          description: REST surface for /universe/stars/{star_id}/.
          operations:
            - method: GET
              name: get_universe_stars_star_id
              description: EVE Online Get Star Information
              call: eve-online-universe.get_universe_stars_star_id
              with:
                star_id: rest.star_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/stations/{station-id}
          name: universe-stations-station-id
          description: REST surface for /universe/stations/{station_id}/.
          operations:
            - method: GET
              name: get_universe_stations_station_id
              description: EVE Online Get Station Information
              call: eve-online-universe.get_universe_stations_station_id
              with:
                station_id: rest.station_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/structures
          name: universe-structures
          description: REST surface for /universe/structures/.
          operations:
            - method: GET
              name: get_universe_structures
              description: EVE Online List All Public Structures
              call: eve-online-universe.get_universe_structures
              with:
                filter: rest.filter
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/structures/{structure-id}
          name: universe-structures-structure-id
          description: REST surface for /universe/structures/{structure_id}/.
          operations:
            - method: GET
              name: get_universe_structures_structure_id
              description: EVE Online Get Structure Information
              call: eve-online-universe.get_universe_structures_structure_id
              with:
                structure_id: rest.structure_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/system-jumps
          name: universe-system-jumps
          description: REST surface for /universe/system_jumps/.
          operations:
            - method: GET
              name: get_universe_system_jumps
              description: EVE Online Get System Jumps
              call: eve-online-universe.get_universe_system_jumps
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/system-kills
          name: universe-system-kills
          description: REST surface for /universe/system_kills/.
          operations:
            - method: GET
              name: get_universe_system_kills
              description: EVE Online Get System Kills
              call: eve-online-universe.get_universe_system_kills
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/systems
          name: universe-systems
          description: REST surface for /universe/systems/.
          operations:
            - method: GET
              name: get_universe_systems
              description: EVE Online Get Solar Systems
              call: eve-online-universe.get_universe_systems
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/systems/{system-id}
          name: universe-systems-system-id
          description: REST surface for /universe/systems/{system_id}/.
          operations:
            - method: GET
              name: get_universe_systems_system_id
              description: EVE Online Get Solar System Information
              call: eve-online-universe.get_universe_systems_system_id
              with:
                system_id: rest.system_id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/types
          name: universe-types
          description: REST surface for /universe/types/.
          operations:
            - method: GET
              name: get_universe_types
              description: EVE Online Get Types
              call: eve-online-universe.get_universe_types
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/universe/types/{type-id}
          name: universe-types-type-id
          description: REST surface for /universe/types/{type_id}/.
          operations:
            - method: GET
              name: get_universe_types_type_id
              description: EVE Online Get Type Information
              call: eve-online-universe.get_universe_types_type_id
              with:
                type_id: rest.type_id
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: eve-online-universe-mcp
      port: 9090
      transport: http
      description: MCP adapter for EVE Online ESI — Universe. One tool per consumed operation, routed inline through this capability's consumes block.
      tools:
        - name: get-ancestries
          description: EVE Online Get Ancestries
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-universe.get_universe_ancestries
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-asteroid-belt-information
          description: EVE Online Get Asteroid Belt Information
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-universe.get_universe_asteroid_belts_asteroid_belt_id
          with:
            asteroid_belt_id: tools.asteroid_belt_id
   

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