Wolfram|Alpha AI Knowledge Integration

naftiko: "1.0.0-alpha1"

info:
  label: "Wolfram|Alpha AI Knowledge Integration"
  description: >-
    Unified capability for integrating Wolfram|Alpha computational knowledge into
    AI applications. Combines the LLM API (structured results for AI), Short Answers
    API (concise factual answers), and Spoken Results API (voice-ready responses) into
    a single interface for AI assistant developers and chatbot engineers.
  tags:
    - AI
    - Chatbot
    - Computational Knowledge
    - LLM
    - Natural Language Processing
    - Wolfram Alpha
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys:
      WOLFRAM_ALPHA_APP_ID: WOLFRAM_ALPHA_APP_ID

capability:
  consumes:
    - import: wolfram-llm
      location: ./shared/llm-api.yaml
    - import: wolfram-short
      location: ./shared/short-answers-api.yaml
    - import: wolfram-spoken
      location: ./shared/spoken-results-api.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: wolfram-ai-api
      description: "Unified REST API for AI Knowledge Integration with Wolfram|Alpha."
      resources:
        - path: /v1/queries/llm
          name: llm-queries
          description: "LLM-optimized computational knowledge queries."
          operations:
            - method: GET
              name: query-llm
              description: "Query Wolfram|Alpha for LLM-optimized computational results."
              call: "wolfram-llm.query-llm-api"
              with:
                input: "rest.input"
                maxchars: "rest.maxchars"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/queries/short-answer
          name: short-answers
          description: "Concise plain-text factual answers."
          operations:
            - method: GET
              name: get-short-answer
              description: "Get a concise plain-text answer from Wolfram|Alpha."
              call: "wolfram-short.get-short-answer"
              with:
                i: "rest.query"
              outputParameters:
                - type: string
                  mapping: "$."

        - path: /v1/queries/spoken
          name: spoken-results
          description: "Voice-optimized computational results."
          operations:
            - method: GET
              name: get-spoken-result
              description: "Get a Wolfram|Alpha answer formatted for text-to-speech."
              call: "wolfram-spoken.get-spoken-result"
              with:
                i: "rest.query"
              outputParameters:
                - type: string
                  mapping: "$."

    - type: mcp
      port: 9090
      namespace: wolfram-ai-mcp
      transport: http
      description: "MCP server for AI-assisted Wolfram|Alpha knowledge integration."
      tools:
        - name: query-wolfram-for-llm
          description: >-
            Query Wolfram|Alpha for computational knowledge results optimized for
            LLM processing. Returns structured text with interpretation and data.
          hints:
            readOnly: true
            openWorld: true
          call: "wolfram-llm.query-llm-api"
          with:
            input: "tools.input"
            maxchars: "tools.maxchars"
          outputParameters:
            - type: object
              mapping: "$."

        - name: get-short-factual-answer
          description: >-
            Get a single concise plain-text factual answer from Wolfram|Alpha.
            Ideal for chatbot responses and AI assistant integrations.
          hints:
            readOnly: true
            openWorld: true
          call: "wolfram-short.get-short-answer"
          with:
            i: "tools.query"
          outputParameters:
            - type: string
              mapping: "$."

        - name: get-spoken-answer
          description: >-
            Get a Wolfram|Alpha answer formatted for voice delivery. Returns
            natural language text ready for text-to-speech synthesis.
          hints:
            readOnly: true
            openWorld: true
          call: "wolfram-spoken.get-spoken-result"
          with:
            i: "tools.query"
          outputParameters:
            - type: string
              mapping: "$."