naftiko: 1.0.0-alpha2
info:
  title: Monkcast Sdk Vs Capability Reference
  description: A reference capability used in the MonkCast podcast comparing raw SDK use vs Naftiko-capability use, with the same target API exposed both ways.
  tags: [Naftiko, MonkCast, SDK, Reference]
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: stripe-env
  keys: {STRIPE_API_KEY: STRIPE_API_KEY}
capability:
  consumes:
  - namespace: stripe
    type: http
    baseUri: https://api.stripe.com
    authentication: {type: bearer, token: '{{STRIPE_API_KEY}}'}
    resources:
    - {name: customers, path: /v1/customers, operations: [{name: list-customers, method: GET}]}
    - name: customer
      path: /v1/customers/{{customer_id}}
      operations:
      - {name: get-customer, method: GET, inputParameters: [{name: customer_id, in: path}]}
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: monkcast-sdk-vs-capability-reference-rest
    description: REST surface for the SDK-vs-capability reference.
    resources:
    - {name: customers, path: /customers, operations: [{method: GET, name: list-customers, call: stripe.list-customers}]}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: monkcast-sdk-vs-capability-reference-mcp
    description: MCP for the reference.
    tools:
    - {name: list-customers, hints: {readOnly: true}, call: stripe.list-customers}
    - name: get-customer
      hints: {readOnly: true}
      inputParameters: [{name: customer_id, type: string, required: true}]
      call: stripe.get-customer
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: monkcast-sdk-vs-capability-reference-skills
    description: Skill for the reference.
    skills:
    - name: monkcast-sdk-vs-capability-reference
      description: SDK-vs-capability reference.
      location: file:///opt/naftiko/skills/monkcast-sdk-vs-capability-reference
      allowed-tools: list-customers,get-customer
      tools:
      - {name: list-customers, from: {sourceNamespace: monkcast-sdk-vs-capability-reference-mcp, action: list-customers}}
      - {name: get-customer, from: {sourceNamespace: monkcast-sdk-vs-capability-reference-mcp, action: get-customer}}