Scryfall Migrations

naftiko: 1.0.0-alpha2
info:
  label: Scryfall Migrations
  description: 'Scryfall Migrations capability — list and retrieve records of card-object merges and deletions in the Scryfall database. 2 operations. Lead operation: List Migrations.'
  tags:
    - Scryfall
    - Migrations
    - 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-migrations
      baseUri: https://api.scryfall.com
      description: Scryfall Migrations business capability.
      resources:
        - name: migrations
          path: /migrations
          operations:
            - name: listmigrations
              method: GET
              description: List Migrations
              outputRawFormat: json
              outputParameters:
                - { name: result, type: object, value: $. }
        - name: migrations-id
          path: /migrations/{id}
          operations:
            - name: getmigrationbyid
              method: GET
              description: Get a Migration by ID
              outputRawFormat: json
              outputParameters:
                - { name: result, type: object, value: $. }
      authentication:
        type: header
        key: User-Agent
        value: '{{env.SCRYFALL_USER_AGENT}}'
        placement: header
  exposes:
    - type: mcp
      namespace: scryfall-migrations-mcp
      port: 9090
      transport: http
      description: MCP adapter for Scryfall Migrations.
      tools:
        - name: list-migrations
          description: List all card-object migration records published by Scryfall.
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: scryfall-migrations.listmigrations
          outputParameters:
            - { type: object, mapping: $. }
        - name: get-migration-by-id
          description: Retrieve a single Scryfall migration record by ID.
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: scryfall-migrations.getmigrationbyid
          outputParameters:
            - { type: object, mapping: $. }