EVE Online ESI — Character

naftiko: 1.0.0-alpha2
info:
  label: EVE Online ESI — Character
  description: 'ESI — Character. 14 operations. Lead operation: EVE Online Character Affiliation. Self-contained Naftiko capability covering one EVE Online business surface.'
  tags:
    - EVE Online
    - ESI
    - Character
  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-character
      baseUri: https://esi.evetech.net/latest
      description: EVE Online ESI — Character business capability. Self-contained, no shared references.
      authentication:
        type: bearer
        token: '{{env.EVE_ONLINE_ACCESS_TOKEN}}'
      resources:
        - name: characters-affiliation
          path: /characters/affiliation/
          operations:
            - name: post_characters_affiliation
              method: POST
              description: EVE Online Character Affiliation
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
                  description: Request body payload.
        - name: characters-character-id
          path: /characters/{character_id}/
          operations:
            - name: get_characters_character_id
              method: GET
              description: EVE Online Get Character's Public Information
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-agents-research
          path: /characters/{character_id}/agents_research/
          operations:
            - name: get_characters_character_id_agents_research
              method: GET
              description: EVE Online Get Agents Research
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-blueprints
          path: /characters/{character_id}/blueprints/
          operations:
            - name: get_characters_character_id_blueprints
              method: GET
              description: EVE Online Get Blueprints
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-corporationhistory
          path: /characters/{character_id}/corporationhistory/
          operations:
            - name: get_characters_character_id_corporationhistory
              method: GET
              description: EVE Online Get Corporation History
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-cspa
          path: /characters/{character_id}/cspa/
          operations:
            - name: post_characters_character_id_cspa
              method: POST
              description: EVE Online Calculate a CSPA Charge Cost
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: body
                  in: body
                  type: object
                  required: true
                  description: Request body payload.
        - name: characters-character-id-fatigue
          path: /characters/{character_id}/fatigue/
          operations:
            - name: get_characters_character_id_fatigue
              method: GET
              description: EVE Online Get Jump Fatigue
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-medals
          path: /characters/{character_id}/medals/
          operations:
            - name: get_characters_character_id_medals
              method: GET
              description: EVE Online Get Medals
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-notifications
          path: /characters/{character_id}/notifications/
          operations:
            - name: get_characters_character_id_notifications
              method: GET
              description: EVE Online Get Character Notifications
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-notifications-contacts
          path: /characters/{character_id}/notifications/contacts/
          operations:
            - name: get_characters_character_id_notifications_contacts
              method: GET
              description: EVE Online Get New Contact Notifications
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-portrait
          path: /characters/{character_id}/portrait/
          operations:
            - name: get_characters_character_id_portrait
              method: GET
              description: EVE Online Get Character Portraits
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-roles
          path: /characters/{character_id}/roles/
          operations:
            - name: get_characters_character_id_roles
              method: GET
              description: EVE Online Get Character Corporation Roles
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-standings
          path: /characters/{character_id}/standings/
          operations:
            - name: get_characters_character_id_standings
              method: GET
              description: EVE Online Get Standings
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: characters-character-id-titles
          path: /characters/{character_id}/titles/
          operations:
            - name: get_characters_character_id_titles
              method: GET
              description: EVE Online Get Character Corporation Titles
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
  exposes:
    - type: rest
      namespace: eve-online-character-rest
      port: 8080
      description: REST adapter for EVE Online ESI — Character. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/characters/affiliation
          name: characters-affiliation
          description: REST surface for /characters/affiliation/.
          operations:
            - method: POST
              name: post_characters_affiliation
              description: EVE Online Character Affiliation
              call: eve-online-character.post_characters_affiliation
              with:
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}
          name: characters-character-id
          description: REST surface for /characters/{character_id}/.
          operations:
            - method: GET
              name: get_characters_character_id
              description: EVE Online Get Character's Public Information
              call: eve-online-character.get_characters_character_id
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/agents-research
          name: characters-character-id-agents-research
          description: REST surface for /characters/{character_id}/agents_research/.
          operations:
            - method: GET
              name: get_characters_character_id_agents_research
              description: EVE Online Get Agents Research
              call: eve-online-character.get_characters_character_id_agents_research
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/blueprints
          name: characters-character-id-blueprints
          description: REST surface for /characters/{character_id}/blueprints/.
          operations:
            - method: GET
              name: get_characters_character_id_blueprints
              description: EVE Online Get Blueprints
              call: eve-online-character.get_characters_character_id_blueprints
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/corporationhistory
          name: characters-character-id-corporationhistory
          description: REST surface for /characters/{character_id}/corporationhistory/.
          operations:
            - method: GET
              name: get_characters_character_id_corporationhistory
              description: EVE Online Get Corporation History
              call: eve-online-character.get_characters_character_id_corporationhistory
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/cspa
          name: characters-character-id-cspa
          description: REST surface for /characters/{character_id}/cspa/.
          operations:
            - method: POST
              name: post_characters_character_id_cspa
              description: EVE Online Calculate a CSPA Charge Cost
              call: eve-online-character.post_characters_character_id_cspa
              with:
                body: rest.body
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/fatigue
          name: characters-character-id-fatigue
          description: REST surface for /characters/{character_id}/fatigue/.
          operations:
            - method: GET
              name: get_characters_character_id_fatigue
              description: EVE Online Get Jump Fatigue
              call: eve-online-character.get_characters_character_id_fatigue
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/medals
          name: characters-character-id-medals
          description: REST surface for /characters/{character_id}/medals/.
          operations:
            - method: GET
              name: get_characters_character_id_medals
              description: EVE Online Get Medals
              call: eve-online-character.get_characters_character_id_medals
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/notifications
          name: characters-character-id-notifications
          description: REST surface for /characters/{character_id}/notifications/.
          operations:
            - method: GET
              name: get_characters_character_id_notifications
              description: EVE Online Get Character Notifications
              call: eve-online-character.get_characters_character_id_notifications
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/notifications/contacts
          name: characters-character-id-notifications-contacts
          description: REST surface for /characters/{character_id}/notifications/contacts/.
          operations:
            - method: GET
              name: get_characters_character_id_notifications_contacts
              description: EVE Online Get New Contact Notifications
              call: eve-online-character.get_characters_character_id_notifications_contacts
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/portrait
          name: characters-character-id-portrait
          description: REST surface for /characters/{character_id}/portrait/.
          operations:
            - method: GET
              name: get_characters_character_id_portrait
              description: EVE Online Get Character Portraits
              call: eve-online-character.get_characters_character_id_portrait
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/roles
          name: characters-character-id-roles
          description: REST surface for /characters/{character_id}/roles/.
          operations:
            - method: GET
              name: get_characters_character_id_roles
              description: EVE Online Get Character Corporation Roles
              call: eve-online-character.get_characters_character_id_roles
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/standings
          name: characters-character-id-standings
          description: REST surface for /characters/{character_id}/standings/.
          operations:
            - method: GET
              name: get_characters_character_id_standings
              description: EVE Online Get Standings
              call: eve-online-character.get_characters_character_id_standings
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/characters/{character-id}/titles
          name: characters-character-id-titles
          description: REST surface for /characters/{character_id}/titles/.
          operations:
            - method: GET
              name: get_characters_character_id_titles
              description: EVE Online Get Character Corporation Titles
              call: eve-online-character.get_characters_character_id_titles
              with: {}
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: eve-online-character-mcp
      port: 9090
      transport: http
      description: MCP adapter for EVE Online ESI — Character. One tool per consumed operation, routed inline through this capability's consumes block.
      tools:
        - name: character-affiliation
          description: EVE Online Character Affiliation
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: eve-online-character.post_characters_affiliation
          with:
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.
        - name: get-character-s-public-information
          description: EVE Online Get Character's Public Information
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-agents-research
          description: EVE Online Get Agents Research
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id_agents_research
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-blueprints
          description: EVE Online Get Blueprints
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id_blueprints
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-corporation-history
          description: EVE Online Get Corporation History
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id_corporationhistory
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: calculate-cspa-charge-cost
          description: EVE Online Calculate a CSPA Charge Cost
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: eve-online-character.post_characters_character_id_cspa
          with:
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.
        - name: get-jump-fatigue
          description: EVE Online Get Jump Fatigue
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id_fatigue
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-medals
          description: EVE Online Get Medals
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id_medals
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-character-notifications
          description: EVE Online Get Character Notifications
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id_notifications
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-new-contact-notifications
          description: EVE Online Get New Contact Notifications
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id_notifications_contacts
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-character-portraits
          description: EVE Online Get Character Portraits
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id_portrait
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-character-corporation-roles
          description: EVE Online Get Character Corporation Roles
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id_roles
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-standings
          description: EVE Online Get Standings
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id_standings
          with: {}
          outputParameters:
            - type: object
              mapping: $.
        - name: get-character-corporation-titles
          description: EVE Online Get Character Corporation Titles
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: eve-online-character.get_characters_character_id_titles
          with: {}
          outputParameters:
            - type: object
              mapping: $.