naftiko: 1.0.0-alpha2
info:
  title: Avatax Calculate As Agent Skill
  description: A capability wrapping Avalara AvaTax CalculateTax as an Agent Skill so AI assistants can compute sales tax inline without raw API access.
  tags: [Naftiko, AvaTax, Tax]
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: avatax-env
  description: Avalara AvaTax account/license credentials.
  keys: {AVATAX_USERNAME: AVATAX_USERNAME, AVATAX_PASSWORD: AVATAX_PASSWORD}
capability:
  consumes:
  - namespace: avatax
    type: http
    baseUri: https://rest.avatax.com
    authentication:
      type: basic
      username: '{{AVATAX_USERNAME}}'
      password: '{{AVATAX_PASSWORD}}'
    resources:
    - {name: transactions, path: /api/v2/transactions/create, operations: [{name: create-transaction, method: POST, description: Create and calculate tax on a transaction.}]}
    - name: transaction
      path: /api/v2/companies/{{company_code}}/transactions/{{transaction_code}}
      operations:
      - {name: get-transaction, method: GET, inputParameters: [{name: company_code, in: path}, {name: transaction_code, in: path}]}
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: avatax-calculate-as-agent-skill-rest
    description: REST surface for AvaTax tax calculation.
    resources:
    - {name: calculate, path: /calculate, operations: [{method: POST, name: calculate-tax, description: Compute sales tax for a transaction., call: avatax.create-transaction}]}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: avatax-calculate-as-agent-skill-mcp
    description: MCP exposing AvaTax CalculateTax for AI assistants.
    tools:
    - {name: calculate-tax, description: Calculate sales tax on a transaction., call: avatax.create-transaction}
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: avatax-calculate-as-agent-skill-skills
    description: Agent Skill bundle for inline tax calculation.
    skills:
    - name: avatax-calculate-as-agent-skill
      description: Inline AvaTax CalculateTax as an Agent Skill.
      location: file:///opt/naftiko/skills/avatax-calculate-as-agent-skill
      allowed-tools: calculate-tax
      tools:
      - {name: calculate-tax, from: {sourceNamespace: avatax-calculate-as-agent-skill-mcp, action: calculate-tax}}