naftiko: 1.0.0-alpha2
info:
  label: Wolfram|Alpha Computational Search
  description: Comprehensive computational search capability combining the Full Results API (complete pod-based results) and
    LLM API (AI-optimized results) for applications requiring deep computational intelligence. Used by search platforms, educational
    tools, and research applications needing rich multi-format results.
  tags:
  - Computation
  - Education
  - Full Results
  - Math
  - Research
  - Science
  - Search
  - Wolfram Alpha
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    WOLFRAM_ALPHA_APP_ID: WOLFRAM_ALPHA_APP_ID
capability:
  consumes:
  - type: http
    namespace: wolfram-full
    baseUri: https://api.wolframalpha.com/v2
    description: Wolfram|Alpha Full Results API with complete pod data.
    authentication:
      type: apikey
      key: appid
      value: '{{WOLFRAM_ALPHA_APP_ID}}'
      placement: query
    resources:
    - name: queries
      path: /query
      description: Submit queries for full pod-based computational results.
      operations:
      - name: query-full-results
        method: GET
        description: Submit a natural language query for full results with disambiguation and drilldown.
        inputParameters:
        - name: input
          in: query
          type: string
          required: true
          description: URL-encoded query string.
        - name: output
          in: query
          type: string
          required: false
          description: 'Response format: xml or json.'
        - name: format
          in: query
          type: string
          required: false
          description: 'Content formats: image, plaintext, mathml, etc.'
        - name: includepodid
          in: query
          type: string
          required: false
          description: Include only pods with these IDs.
        - name: units
          in: query
          type: string
          required: false
          description: 'Measurement system: metric or imperial.'
        - name: timeout
          in: query
          type: integer
          required: false
          description: Maximum processing time in seconds.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  - type: http
    namespace: wolfram-llm
    baseUri: https://www.wolframalpha.com/api/v1
    description: Wolfram|Alpha LLM API for computational knowledge results.
    authentication:
      type: apikey
      key: appid
      value: '{{WOLFRAM_ALPHA_APP_ID}}'
      placement: query
    resources:
    - name: queries
      path: /llm-api
      description: Submit natural language queries for LLM-optimized computational results.
      operations:
      - name: query-llm-api
        method: GET
        description: Submit a natural language query and receive computational results formatted for LLM consumption.
        inputParameters:
        - name: input
          in: query
          type: string
          required: true
          description: URL-encoded natural language query string.
        - name: maxchars
          in: query
          type: integer
          required: false
          description: Maximum characters in response. Default 6800.
        - name: units
          in: query
          type: string
          required: false
          description: 'Measurement system: metric or imperial.'
        - name: timezone
          in: query
          type: string
          required: false
          description: IANA timezone name for context.
        - name: latlong
          in: query
          type: string
          required: false
          description: Latitude,longitude for location-aware results.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8081
    namespace: wolfram-search-api
    description: Unified REST API for Wolfram|Alpha computational search.
    resources:
    - path: /v1/compute
      name: computations
      description: Full computational results with pod-based output.
      operations:
      - method: GET
        name: compute-full
        description: Get complete Wolfram|Alpha results with all pods and formats.
        call: wolfram-full.query-full-results
        with:
          input: rest.input
          output: rest.output
          format: rest.format
          includepodid: rest.includepodid
          units: rest.units
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/compute/llm
      name: llm-computations
      description: LLM-optimized computational results.
      operations:
      - method: GET
        name: compute-for-llm
        description: Get Wolfram|Alpha results formatted for LLM processing.
        call: wolfram-llm.query-llm-api
        with:
          input: rest.input
          maxchars: rest.maxchars
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9091
    namespace: wolfram-search-mcp
    transport: http
    description: MCP server for AI-assisted computational search and scientific queries.
    tools:
    - name: compute-full-results
      description: Get complete Wolfram|Alpha computational results with all data pods. Returns structured JSON with math,
        science, geography, and more.
      hints:
        readOnly: true
        openWorld: true
      call: wolfram-full.query-full-results
      with:
        input: tools.input
        output: tools.output
        format: tools.format
      outputParameters:
      - type: object
        mapping: $.
    - name: compute-for-llm
      description: Query Wolfram|Alpha and receive computational results formatted for LLM consumption. Includes structured
        text with interpretation and result data.
      hints:
        readOnly: true
        openWorld: true
      call: wolfram-llm.query-llm-api
      with:
        input: tools.input
        maxchars: tools.maxchars
      outputParameters:
      - type: object
        mapping: $.