Google Cloud Natural Language API

naftiko: 1.0.0-alpha2
info:
  label: Google Cloud Natural Language API
  description: Provides natural language understanding technologies to extract insights from unstructured text including sentiment,
    entities, and syntax.
  tags:
  - Google
  - Cloud
  - Natural
  - Language
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: google-cloud-natural-language
    baseUri: https://language.googleapis.com/v1
    description: Google Cloud Natural Language API HTTP API.
    resources:
    - name: documents-analyzesentiment
      path: /documents:analyzeSentiment
      operations:
      - name: analyzesentiment
        method: POST
        description: Google Cloud Natural Language Analyze sentiment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: documents-analyzeentities
      path: /documents:analyzeEntities
      operations:
      - name: analyzeentities
        method: POST
        description: Google Cloud Natural Language Analyze entities
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: documents-classifytext
      path: /documents:classifyText
      operations:
      - name: classifytext
        method: POST
        description: Google Cloud Natural Language Classify text
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: documents-analyzesyntax
      path: /documents:analyzeSyntax
      operations:
      - name: analyzesyntax
        method: POST
        description: Google Cloud Natural Language Analyze syntax
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: documents-annotatetext
      path: /documents:annotateText
      operations:
      - name: annotatetext
        method: POST
        description: Google Cloud Natural Language Annotate text
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: google-cloud-natural-language-rest
    description: REST adapter for Google Cloud Natural Language API.
    resources:
    - path: /documents:analyzeSentiment
      name: analyzesentiment
      operations:
      - method: POST
        name: analyzesentiment
        description: Google Cloud Natural Language Analyze sentiment
        call: google-cloud-natural-language.analyzesentiment
        outputParameters:
        - type: object
          mapping: $.
    - path: /documents:analyzeEntities
      name: analyzeentities
      operations:
      - method: POST
        name: analyzeentities
        description: Google Cloud Natural Language Analyze entities
        call: google-cloud-natural-language.analyzeentities
        outputParameters:
        - type: object
          mapping: $.
    - path: /documents:classifyText
      name: classifytext
      operations:
      - method: POST
        name: classifytext
        description: Google Cloud Natural Language Classify text
        call: google-cloud-natural-language.classifytext
        outputParameters:
        - type: object
          mapping: $.
    - path: /documents:analyzeSyntax
      name: analyzesyntax
      operations:
      - method: POST
        name: analyzesyntax
        description: Google Cloud Natural Language Analyze syntax
        call: google-cloud-natural-language.analyzesyntax
        outputParameters:
        - type: object
          mapping: $.
    - path: /documents:annotateText
      name: annotatetext
      operations:
      - method: POST
        name: annotatetext
        description: Google Cloud Natural Language Annotate text
        call: google-cloud-natural-language.annotatetext
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: google-cloud-natural-language-mcp
    transport: http
    description: MCP adapter for Google Cloud Natural Language API for AI agent use.
    tools:
    - name: analyzesentiment
      description: Google Cloud Natural Language Analyze sentiment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-cloud-natural-language.analyzesentiment
      outputParameters:
      - type: object
        mapping: $.
    - name: analyzeentities
      description: Google Cloud Natural Language Analyze entities
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-cloud-natural-language.analyzeentities
      outputParameters:
      - type: object
        mapping: $.
    - name: classifytext
      description: Google Cloud Natural Language Classify text
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-cloud-natural-language.classifytext
      outputParameters:
      - type: object
        mapping: $.
    - name: analyzesyntax
      description: Google Cloud Natural Language Analyze syntax
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-cloud-natural-language.analyzesyntax
      outputParameters:
      - type: object
        mapping: $.
    - name: annotatetext
      description: Google Cloud Natural Language Annotate text
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: google-cloud-natural-language.annotatetext
      outputParameters:
      - type: object
        mapping: $.