Scryfall Symbology

naftiko: 1.0.0-alpha2
info:
  label: Scryfall Symbology
  description: 'Scryfall Symbology capability — list all Magic mana and text symbols, and parse a mana cost string. 2 operations. Lead operation: List All Card Symbols.'
  tags:
    - Scryfall
    - Symbology
    - Magic The Gathering
  created: '2026-05-29'
  modified: '2026-05-29'
binds:
  - namespace: env
    keys:
      SCRYFALL_USER_AGENT: SCRYFALL_USER_AGENT
capability:
  consumes:
    - type: http
      namespace: scryfall-symbology
      baseUri: https://api.scryfall.com
      description: Scryfall Symbology business capability.
      resources:
        - name: symbology
          path: /symbology
          operations:
            - name: listsymbology
              method: GET
              description: List All Card Symbols
              outputRawFormat: json
              outputParameters:
                - { name: result, type: object, value: $. }
        - name: symbology-parse-mana
          path: /symbology/parse-mana
          operations:
            - name: parsemana
              method: GET
              description: Parse a Mana Cost
              outputRawFormat: json
              outputParameters:
                - { name: result, type: object, value: $. }
              inputParameters:
                - { name: cost, in: query, type: string, required: true }
      authentication:
        type: header
        key: User-Agent
        value: '{{env.SCRYFALL_USER_AGENT}}'
        placement: header
  exposes:
    - type: mcp
      namespace: scryfall-symbology-mcp
      port: 9090
      transport: http
      description: MCP adapter for Scryfall Symbology.
      tools:
        - name: list-card-symbols
          description: List every documented Magic mana and text symbol.
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: scryfall-symbology.listsymbology
          outputParameters:
            - { type: object, mapping: $. }
        - name: parse-mana-cost
          description: Parse a Magic mana-cost string into a normalized representation including converted mana cost.
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: scryfall-symbology.parsemana
          outputParameters:
            - { type: object, mapping: $. }