naftiko: 1.0.0-alpha2 info: label: Core API — gpa orders description: 'Core API — gpa orders. 5 operations. Lead operation: Funds a user''s GPA account. Self-contained Naftiko capability covering one Marqeta business surface.' tags: - Marqeta - gpa orders created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: MARQETA_API_KEY: MARQETA_API_KEY capability: consumes: - type: http namespace: core-gpa-orders baseUri: '' description: Core API — gpa orders business capability. Self-contained, no shared references. resources: - name: gpaorders path: /gpaorders operations: - name: postgpaorders method: POST description: Funds a user's GPA account outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: gpaorders-unloads path: /gpaorders/unloads operations: - name: getgpaordersunloads method: GET description: Lists all GPA returns outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: count in: query type: integer description: Number of GPA unloads to retrieve - name: start_index in: query type: integer description: Start index - name: fields in: query type: string description: Comma-delimited list of fields to return (e.g. field_1,field_2,..). Leave blank to return all fields. - name: sort_by in: query type: string description: Sort order - name: user_token in: query type: string description: User token - name: business_token in: query type: string description: Business token - name: original_order_token in: query type: string description: Original order token - name: postgpaordersunloads method: POST description: Returns a GPA order outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: gpaorders-unloads-unload_token path: /gpaorders/unloads/{unload_token} operations: - name: getgpaordersunloadsunloadtoken method: GET description: Returns a specific GPA return outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: unload_token in: path type: string description: Unload token required: true - name: gpaorders-token path: /gpaorders/{token} operations: - name: getgpaorderstoken method: GET description: Returns a GPA order outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: token in: path type: string required: true authentication: type: basic username: '{{env.MARQETA_USER}}' password: '{{env.MARQETA_PASS}}' exposes: - type: rest namespace: core-gpa-orders-rest port: 8080 description: REST adapter for Core API — gpa orders. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/gpaorders name: gpaorders description: REST surface for gpaorders. operations: - method: POST name: postgpaorders description: Funds a user's GPA account call: core-gpa-orders.postgpaorders with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/gpaorders/unloads name: gpaorders-unloads description: REST surface for gpaorders-unloads. operations: - method: GET name: getgpaordersunloads description: Lists all GPA returns call: core-gpa-orders.getgpaordersunloads with: count: rest.count start_index: rest.start_index fields: rest.fields sort_by: rest.sort_by user_token: rest.user_token business_token: rest.business_token original_order_token: rest.original_order_token outputParameters: - type: object mapping: $. - method: POST name: postgpaordersunloads description: Returns a GPA order call: core-gpa-orders.postgpaordersunloads with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/gpaorders/unloads/{unload-token} name: gpaorders-unloads-unload-token description: REST surface for gpaorders-unloads-unload_token. operations: - method: GET name: getgpaordersunloadsunloadtoken description: Returns a specific GPA return call: core-gpa-orders.getgpaordersunloadsunloadtoken with: unload_token: rest.unload_token outputParameters: - type: object mapping: $. - path: /v1/gpaorders/{token} name: gpaorders-token description: REST surface for gpaorders-token. operations: - method: GET name: getgpaorderstoken description: Returns a GPA order call: core-gpa-orders.getgpaorderstoken with: token: rest.token outputParameters: - type: object mapping: $. - type: mcp namespace: core-gpa-orders-mcp port: 9090 transport: http description: MCP adapter for Core API — gpa orders. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: funds-user-s-gpa-account description: Funds a user's GPA account hints: readOnly: false destructive: false idempotent: false call: core-gpa-orders.postgpaorders with: body: tools.body outputParameters: - type: object mapping: $. - name: lists-all-gpa-returns description: Lists all GPA returns hints: readOnly: true destructive: false idempotent: true call: core-gpa-orders.getgpaordersunloads with: count: tools.count start_index: tools.start_index fields: tools.fields sort_by: tools.sort_by user_token: tools.user_token business_token: tools.business_token original_order_token: tools.original_order_token outputParameters: - type: object mapping: $. - name: returns-gpa-order description: Returns a GPA order hints: readOnly: false destructive: false idempotent: false call: core-gpa-orders.postgpaordersunloads with: body: tools.body outputParameters: - type: object mapping: $. - name: returns-specific-gpa-return description: Returns a specific GPA return hints: readOnly: true destructive: false idempotent: true call: core-gpa-orders.getgpaordersunloadsunloadtoken with: unload_token: tools.unload_token outputParameters: - type: object mapping: $. - name: returns-gpa-order-2 description: Returns a GPA order hints: readOnly: true destructive: false idempotent: true call: core-gpa-orders.getgpaorderstoken with: token: tools.token outputParameters: - type: object mapping: $.