naftiko: 1.0.0-alpha2 info: label: Shopify API — Cards description: 'Shopify API — Cards. 18 operations. Lead operation: Shopify Retrieves A List Of Gift Cards. Self-contained Naftiko capability covering one Shopify business surface.' tags: - Shopify - Cards created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: SHOPIFY_API_KEY: SHOPIFY_API_KEY capability: consumes: - type: http namespace: shopify-cards baseUri: '' description: Shopify API — Cards business capability. Self-contained, no shared references. resources: - name: admin-api-2020-01-gift_cards.json path: /admin/api/2020-01/gift_cards.json operations: - name: deprecated202001getgiftcards method: GET description: Shopify Retrieves A List Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Retrieve gift cards with a given status. Valid values:' - name: limit in: query type: string description: The maximum number of results to show. - name: since_id in: query type: string description: Restrict results to after the specified ID. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. - name: admin-api-2020-01-gift_cards-count.json path: /admin/api/2020-01/gift_cards/count.json operations: - name: deprecated202001getgiftcardscount method: GET description: Shopify Retrieves A Count Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Count gift cards with a given status. Valid values:' - name: admin-api-2020-01-gift_cards-search.json path: /admin/api/2020-01/gift_cards/search.json operations: - name: deprecated202001getgiftcardssearch method: GET description: Shopify Searches For Gift Cards That Match A Supplied Query outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: order in: query type: string description: The field and direction to order results by. - name: query in: query type: string description: The text to search for. - name: limit in: query type: string description: The maximum number of results to retrieve. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. - name: admin-api-2020-04-gift_cards.json path: /admin/api/2020-04/gift_cards.json operations: - name: deprecated202004getgiftcards method: GET description: Shopify Retrieves A List Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Retrieve gift cards with a given status. Valid values:' - name: limit in: query type: string description: The maximum number of results to show. - name: since_id in: query type: string description: Restrict results to after the specified ID. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. - name: admin-api-2020-04-gift_cards-count.json path: /admin/api/2020-04/gift_cards/count.json operations: - name: deprecated202004getgiftcardscount method: GET description: Shopify Retrieves A Count Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Count gift cards with a given status. Valid values:' - name: admin-api-2020-04-gift_cards-search.json path: /admin/api/2020-04/gift_cards/search.json operations: - name: deprecated202004getgiftcardssearch method: GET description: Shopify Searches For Gift Cards That Match A Supplied Query outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: order in: query type: string description: The field and direction to order results by. - name: query in: query type: string description: The text to search for. - name: limit in: query type: string description: The maximum number of results to retrieve. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. - name: admin-api-2020-07-gift_cards.json path: /admin/api/2020-07/gift_cards.json operations: - name: deprecated202007getgiftcards method: GET description: Shopify Retrieves A List Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Retrieve gift cards with a given status. Valid values:' - name: limit in: query type: string description: The maximum number of results to show. - name: since_id in: query type: string description: Restrict results to after the specified ID. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. - name: admin-api-2020-07-gift_cards-count.json path: /admin/api/2020-07/gift_cards/count.json operations: - name: deprecated202007getgiftcardscount method: GET description: Shopify Retrieves A Count Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Count gift cards with a given status. Valid values:' - name: admin-api-2020-07-gift_cards-search.json path: /admin/api/2020-07/gift_cards/search.json operations: - name: deprecated202007getgiftcardssearch method: GET description: Shopify Searches For Gift Cards That Match A Supplied Query outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: order in: query type: string description: The field and direction to order results by. - name: query in: query type: string description: The text to search for. - name: limit in: query type: string description: The maximum number of results to retrieve. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. - name: admin-api-2020-10-gift_cards.json path: /admin/api/2020-10/gift_cards.json operations: - name: getgiftcards method: GET description: Shopify Retrieves A List Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Retrieve gift cards with a given status. Valid values:' - name: limit in: query type: string description: The maximum number of results to show. - name: since_id in: query type: string description: Restrict results to after the specified ID. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. - name: admin-api-2020-10-gift_cards-count.json path: /admin/api/2020-10/gift_cards/count.json operations: - name: getgiftcardscount method: GET description: Shopify Retrieves A Count Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Count gift cards with a given status. Valid values:' - name: admin-api-2020-10-gift_cards-search.json path: /admin/api/2020-10/gift_cards/search.json operations: - name: getgiftcardssearch method: GET description: Shopify Searches For Gift Cards That Match A Supplied Query outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: order in: query type: string description: The field and direction to order results by. - name: query in: query type: string description: The text to search for. - name: limit in: query type: string description: The maximum number of results to retrieve. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. - name: admin-api-2021-01-gift_cards.json path: /admin/api/2021-01/gift_cards.json operations: - name: deprecated202101getgiftcards method: GET description: Shopify Retrieves A List Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Retrieve gift cards with a given status. Valid values:' - name: limit in: query type: string description: The maximum number of results to show. - name: since_id in: query type: string description: Restrict results to after the specified ID. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. - name: admin-api-2021-01-gift_cards-count.json path: /admin/api/2021-01/gift_cards/count.json operations: - name: deprecated202101getgiftcardscount method: GET description: Shopify Retrieves A Count Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Count gift cards with a given status. Valid values:' - name: admin-api-2021-01-gift_cards-search.json path: /admin/api/2021-01/gift_cards/search.json operations: - name: deprecated202101getgiftcardssearch method: GET description: Shopify Searches For Gift Cards That Match A Supplied Query outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: order in: query type: string description: The field and direction to order results by. - name: query in: query type: string description: The text to search for. - name: limit in: query type: string description: The maximum number of results to retrieve. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. - name: admin-api-unstable-gift_cards.json path: /admin/api/unstable/gift_cards.json operations: - name: deprecatedunstablegetgiftcards method: GET description: Shopify Retrieves A List Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Retrieve gift cards with a given status. Valid values:' - name: limit in: query type: string description: The maximum number of results to show. - name: since_id in: query type: string description: Restrict results to after the specified ID. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. - name: admin-api-unstable-gift_cards-count.json path: /admin/api/unstable/gift_cards/count.json operations: - name: deprecatedunstablegetgiftcardscount method: GET description: Shopify Retrieves A Count Of Gift Cards outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: 'Count gift cards with a given status. Valid values:' - name: admin-api-unstable-gift_cards-search.json path: /admin/api/unstable/gift_cards/search.json operations: - name: deprecatedunstablegetgiftcardssearch method: GET description: Shopify Searches For Gift Cards That Match A Supplied Query outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: order in: query type: string description: The field and direction to order results by. - name: query in: query type: string description: The text to search for. - name: limit in: query type: string description: The maximum number of results to retrieve. - name: fields in: query type: string description: Show only certain fields, specified by a comma-separated list of field names. exposes: - type: rest namespace: shopify-cards-rest port: 8080 description: REST adapter for Shopify API — Cards. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/admin/api/2020-01/gift-cards-json name: admin-api-2020-01-gift-cards-json description: REST surface for admin-api-2020-01-gift_cards.json. operations: - method: GET name: deprecated202001getgiftcards description: Shopify Retrieves A List Of Gift Cards call: shopify-cards.deprecated202001getgiftcards with: status: rest.status limit: rest.limit since_id: rest.since_id fields: rest.fields outputParameters: - type: object mapping: $. - path: /v1/admin/api/2020-01/gift-cards/count-json name: admin-api-2020-01-gift-cards-count-json description: REST surface for admin-api-2020-01-gift_cards-count.json. operations: - method: GET name: deprecated202001getgiftcardscount description: Shopify Retrieves A Count Of Gift Cards call: shopify-cards.deprecated202001getgiftcardscount with: status: rest.status outputParameters: - type: object mapping: $. - path: /v1/admin/api/2020-01/gift-cards/search-json name: admin-api-2020-01-gift-cards-search-json description: REST surface for admin-api-2020-01-gift_cards-search.json. operations: - method: GET name: deprecated202001getgiftcardssearch description: Shopify Searches For Gift Cards That Match A Supplied Query call: shopify-cards.deprecated202001getgiftcardssearch with: order: rest.order query: rest.query limit: rest.limit fields: rest.fields outputParameters: - type: object mapping: $. - path: /v1/admin/api/2020-04/gift-cards-json name: admin-api-2020-04-gift-cards-json description: REST surface for admin-api-2020-04-gift_cards.json. operations: - method: GET name: deprecated202004getgiftcards description: Shopify Retrieves A List Of Gift Cards call: shopify-cards.deprecated202004getgiftcards with: status: rest.status limit: rest.limit since_id: rest.since_id fields: rest.fields outputParameters: - type: object mapping: $. - path: /v1/admin/api/2020-04/gift-cards/count-json name: admin-api-2020-04-gift-cards-count-json description: REST surface for admin-api-2020-04-gift_cards-count.json. operations: - method: GET name: deprecated202004getgiftcardscount description: Shopify Retrieves A Count Of Gift Cards call: shopify-cards.deprecated202004getgiftcardscount with: status: rest.status outputParameters: - type: object mapping: $. - path: /v1/admin/api/2020-04/gift-cards/search-json name: admin-api-2020-04-gift-cards-search-json description: REST surface for admin-api-2020-04-gift_cards-search.json. operations: - method: GET name: deprecated202004getgiftcardssearch description: Shopify Searches For Gift Cards That Match A Supplied Query call: shopify-cards.deprecated202004getgiftcardssearch with: order: rest.order query: rest.query limit: rest.limit fields: rest.fields outputParameters: - type: object mapping: $. - path: /v1/admin/api/2020-07/gift-cards-json name: admin-api-2020-07-gift-cards-json description: REST surface for admin-api-2020-07-gift_cards.json. operations: - method: GET name: deprecated202007getgiftcards description: Shopify Retrieves A List Of Gift Cards call: shopify-cards.deprecated202007getgiftcards with: status: rest.status limit: rest.limit since_id: rest.since_id fields: rest.fields outputParameters: - type: object mapping: $. - path: /v1/admin/api/2020-07/gift-cards/count-json name: admin-api-2020-07-gift-cards-count-json description: REST surface for admin-api-2020-07-gift_cards-count.json. operations: - method: GET name: deprecated202007getgiftcardscount description: Shopify Retrieves A Count Of Gift Cards call: shopify-cards.deprecated202007getgiftcardscount with: status: rest.status outputParameters: - type: object mapping: $. - path: /v1/admin/api/2020-07/gift-cards/search-json name: admin-api-2020-07-gift-cards-search-json description: REST surface for admin-api-2020-07-gift_cards-search.json. operations: - method: GET name: deprecated202007getgiftcardssearch description: Shopify Searches For Gift Cards That Match A Supplied Query call: shopify-cards.deprecated202007getgiftcardssearch with: order: rest.order query: rest.query limit: rest.limit fields: rest.fields outputParameters: - type: object mapping: $. - path: /v1/admin/api/2020-10/gift-cards-json name: admin-api-2020-10-gift-cards-json description: REST surface for admin-api-2020-10-gift_cards.json. operations: - method: GET name: getgiftcards description: Shopify Retrieves A List Of Gift Cards call: shopify-cards.getgiftcards with: status: rest.status limit: rest.limit since_id: rest.since_id fields: rest.fields outputParameters: - type: object mapping: $. - path: /v1/admin/api/2020-10/gift-cards/count-json name: admin-api-2020-10-gift-cards-count-json description: REST surface for admin-api-2020-10-gift_cards-count.json. operations: - method: GET name: getgiftcardscount description: Shopify Retrieves A Count Of Gift Cards call: shopify-cards.getgiftcardscount with: status: rest.status outputParameters: - type: object mapping: $. - path: /v1/admin/api/2020-10/gift-cards/search-json name: admin-api-2020-10-gift-cards-search-json description: REST surface for admin-api-2020-10-gift_cards-search.json. operations: - method: GET name: getgiftcardssearch description: Shopify Searches For Gift Cards That Match A Supplied Query call: shopify-cards.getgiftcardssearch with: order: rest.order query: rest.query limit: rest.limit fields: rest.fields outputParameters: - type: object mapping: $. - path: /v1/admin/api/2021-01/gift-cards-json name: admin-api-2021-01-gift-cards-json description: REST surface for admin-api-2021-01-gift_cards.json. operations: - method: GET name: deprecated202101getgiftcards description: Shopify Retrieves A List Of Gift Cards call: shopify-cards.deprecated202101getgiftcards with: status: rest.status limit: rest.limit since_id: rest.since_id fields: rest.fields outputParameters: - type: object mapping: $. - path: /v1/admin/api/2021-01/gift-cards/count-json name: admin-api-2021-01-gift-cards-count-json description: REST surface for admin-api-2021-01-gift_cards-count.json. operations: - method: GET name: deprecated202101getgiftcardscount description: Shopify Retrieves A Count Of Gift Cards call: shopify-cards.deprecated202101getgiftcardscount with: status: rest.status outputParameters: - type: object mapping: $. - path: /v1/admin/api/2021-01/gift-cards/search-json name: admin-api-2021-01-gift-cards-search-json description: REST surface for admin-api-2021-01-gift_cards-search.json. operations: - method: GET name: deprecated202101getgiftcardssearch description: Shopify Searches For Gift Cards That Match A Supplied Query call: shopify-cards.deprecated202101getgiftcardssearch with: order: rest.order query: rest.query limit: rest.limit fields: rest.fields outputParameters: - type: object mapping: $. - path: /v1/admin/api/unstable/gift-cards-json name: admin-api-unstable-gift-cards-json description: REST surface for admin-api-unstable-gift_cards.json. operations: - method: GET name: deprecatedunstablegetgiftcards description: Shopify Retrieves A List Of Gift Cards call: shopify-cards.deprecatedunstablegetgiftcards with: status: rest.status limit: rest.limit since_id: rest.since_id fields: rest.fields outputParameters: - type: object mapping: $. - path: /v1/admin/api/unstable/gift-cards/count-json name: admin-api-unstable-gift-cards-count-json description: REST surface for admin-api-unstable-gift_cards-count.json. operations: - method: GET name: deprecatedunstablegetgiftcardscount description: Shopify Retrieves A Count Of Gift Cards call: shopify-cards.deprecatedunstablegetgiftcardscount with: status: rest.status outputParameters: - type: object mapping: $. - path: /v1/admin/api/unstable/gift-cards/search-json name: admin-api-unstable-gift-cards-search-json description: REST surface for admin-api-unstable-gift_cards-search.json. operations: - method: GET name: deprecatedunstablegetgiftcardssearch description: Shopify Searches For Gift Cards That Match A Supplied Query call: shopify-cards.deprecatedunstablegetgiftcardssearch with: order: rest.order query: rest.query limit: rest.limit fields: rest.fields outputParameters: - type: object mapping: $. - type: mcp namespace: shopify-cards-mcp port: 9090 transport: http description: MCP adapter for Shopify API — Cards. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: shopify-retrieves-list-gift-cards description: Shopify Retrieves A List Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202001getgiftcards with: status: tools.status limit: tools.limit since_id: tools.since_id fields: tools.fields outputParameters: - type: object mapping: $. - name: shopify-retrieves-count-gift-cards description: Shopify Retrieves A Count Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202001getgiftcardscount with: status: tools.status outputParameters: - type: object mapping: $. - name: shopify-searches-gift-cards-that description: Shopify Searches For Gift Cards That Match A Supplied Query hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202001getgiftcardssearch with: order: tools.order query: tools.query limit: tools.limit fields: tools.fields outputParameters: - type: object mapping: $. - name: shopify-retrieves-list-gift-cards-2 description: Shopify Retrieves A List Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202004getgiftcards with: status: tools.status limit: tools.limit since_id: tools.since_id fields: tools.fields outputParameters: - type: object mapping: $. - name: shopify-retrieves-count-gift-cards-2 description: Shopify Retrieves A Count Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202004getgiftcardscount with: status: tools.status outputParameters: - type: object mapping: $. - name: shopify-searches-gift-cards-that-2 description: Shopify Searches For Gift Cards That Match A Supplied Query hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202004getgiftcardssearch with: order: tools.order query: tools.query limit: tools.limit fields: tools.fields outputParameters: - type: object mapping: $. - name: shopify-retrieves-list-gift-cards-3 description: Shopify Retrieves A List Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202007getgiftcards with: status: tools.status limit: tools.limit since_id: tools.since_id fields: tools.fields outputParameters: - type: object mapping: $. - name: shopify-retrieves-count-gift-cards-3 description: Shopify Retrieves A Count Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202007getgiftcardscount with: status: tools.status outputParameters: - type: object mapping: $. - name: shopify-searches-gift-cards-that-3 description: Shopify Searches For Gift Cards That Match A Supplied Query hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202007getgiftcardssearch with: order: tools.order query: tools.query limit: tools.limit fields: tools.fields outputParameters: - type: object mapping: $. - name: shopify-retrieves-list-gift-cards-4 description: Shopify Retrieves A List Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.getgiftcards with: status: tools.status limit: tools.limit since_id: tools.since_id fields: tools.fields outputParameters: - type: object mapping: $. - name: shopify-retrieves-count-gift-cards-4 description: Shopify Retrieves A Count Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.getgiftcardscount with: status: tools.status outputParameters: - type: object mapping: $. - name: shopify-searches-gift-cards-that-4 description: Shopify Searches For Gift Cards That Match A Supplied Query hints: readOnly: true destructive: false idempotent: true call: shopify-cards.getgiftcardssearch with: order: tools.order query: tools.query limit: tools.limit fields: tools.fields outputParameters: - type: object mapping: $. - name: shopify-retrieves-list-gift-cards-5 description: Shopify Retrieves A List Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202101getgiftcards with: status: tools.status limit: tools.limit since_id: tools.since_id fields: tools.fields outputParameters: - type: object mapping: $. - name: shopify-retrieves-count-gift-cards-5 description: Shopify Retrieves A Count Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202101getgiftcardscount with: status: tools.status outputParameters: - type: object mapping: $. - name: shopify-searches-gift-cards-that-5 description: Shopify Searches For Gift Cards That Match A Supplied Query hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecated202101getgiftcardssearch with: order: tools.order query: tools.query limit: tools.limit fields: tools.fields outputParameters: - type: object mapping: $. - name: shopify-retrieves-list-gift-cards-6 description: Shopify Retrieves A List Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecatedunstablegetgiftcards with: status: tools.status limit: tools.limit since_id: tools.since_id fields: tools.fields outputParameters: - type: object mapping: $. - name: shopify-retrieves-count-gift-cards-6 description: Shopify Retrieves A Count Of Gift Cards hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecatedunstablegetgiftcardscount with: status: tools.status outputParameters: - type: object mapping: $. - name: shopify-searches-gift-cards-that-6 description: Shopify Searches For Gift Cards That Match A Supplied Query hints: readOnly: true destructive: false idempotent: true call: shopify-cards.deprecatedunstablegetgiftcardssearch with: order: tools.order query: tools.query limit: tools.limit fields: tools.fields outputParameters: - type: object mapping: $.