generated: '2026-08-04'
method: searched
source: https://github.com/h2oai/h2ogpte-mcp-server
status: published
server:
  name: h2ogpte-mcp-server
  vendor: H2O.ai
  first_party: true
  transport: stdio
  command: h2ogpte-mcp-server
  repository: https://github.com/h2oai/h2ogpte-mcp-server
  package: https://pypi.org/project/h2ogpte-mcp-server/
  version: 0.1.6
  install: pip install h2ogpte-mcp-server
  framework: FastMCP (OpenAPI-driven)
  backs: https://h2ogpte.genai.h2o.ai/api/v1
  openapi: openapi/h2o-ai-h2ogpte-openapi-original.yml
description: >-
  H2OGPTe MCP Server is H2O.ai's first-party Model Context Protocol server for Enterprise
  h2oGPTe. It is a LOCAL stdio proxy — there is no hosted/remote MCP endpoint — and it
  builds its tool surface directly from the h2oGPTe OpenAPI document it fetches from the
  configured server at start-up. Every tool is therefore one REST operationId, and every
  tool's inputSchema is that operation's parameters + requestBody verbatim.
authentication:
  type: bearer-api-key
  env: H2OGPTE_API_KEY
  docs: https://docs.h2o.ai/enterprise-h2ogpte/guide/apis#create-an-api-key
  note: >-
    Because the server is a local proxy, the MCP client supplies the same h2oGPTe API key
    the REST API uses; there is no MCP-specific OAuth surface and no anonymous tools/list.
configuration:
  - name: H2OGPTE_API_KEY
    required: true
    description: h2oGPTe access key
  - name: H2OGPTE_SERVER_URL
    required: false
    default: https://h2ogpte.genai.h2o.ai
    description: URL of the h2oGPTe server to proxy
  - name: H2OGPTE_ALL_ENDPOINTS_AS_TOOLS
    required: false
    default: 'true'
    description: >-
      When true every REST endpoint becomes an MCP tool. When false, GET endpoints are
      exposed as MCP resources instead of tools.
  - name: H2OGPTE_ENDPOINT_SET
    required: false
    default: all_without_async_ingest
    values: [all, all_without_async_ingest, basic, custom]
    description: Which subset of REST endpoints is projected onto the MCP surface
  - name: H2OGPTE_CUSTOM_ENDPOINT_SET_FILE
    required: false
    description: Path to a newline-delimited list of operationIds (required when endpoint_set is custom)
  - name: H2OGPTE_CUSTOM_OPENAPI_SPEC_FILE
    required: false
    description: Path to a local OpenAPI YAML file (debugging only; normally fetched from the server)
tool_surface:
  model: one-tool-per-operationId
  sets:
    all:
      tools: 422
      description: Every REST operation on the h2oGPTe server
    all_without_async_ingest:
      tools: 412
      default: true
      description: >-
        Every operation except the ten asynchronous ingestion job-starters
        (create_ingest_upload_job, create_ingest_from_s3_job, create_ingest_from_gcs_job,
        create_ingest_from_azure_blob_storage_job, create_ingest_from_website_job,
        create_ingest_from_plain_text_job, create_ingest_from_file_system_job,
        create_ingest_from_confluence_job, create_ingest_from_sharepoint_online_job,
        create_ingest_agent_only_to_standard_job)
    basic:
      tools: 36
      description: Minimal set for chatting with collections and ingesting new documents
    custom:
      description: Caller-supplied operationId list
  overridden_tools:
  - name: upload_file
    reason: >-
      Reimplemented in tools.py so the tool takes a local file path and performs the
      multipart PUT /uploads itself, rather than expecting the caller to build the body.
  - name: update_collection_thumbnail
    reason: >-
      Reimplemented in tools.py to read a local image (max 5MB) and PUT it to
      /collections/{collection_id}/thumbnail.
x-evidence:
  fetched: '2026-08-04'
  sources:
  - url: https://github.com/h2oai/h2ogpte-mcp-server
    http_status: 200
  - url: https://raw.githubusercontent.com/h2oai/h2ogpte-mcp-server/main/README.md
    http_status: 200
  - url: https://raw.githubusercontent.com/h2oai/h2ogpte-mcp-server/main/src/h2ogpte_mcp_server/settings.py
    http_status: 200
    note: source of the verbatim `basic` endpoint set used in the tool crosswalk
  - url: https://pypi.org/project/h2ogpte-mcp-server/
    http_status: 200
  live_tools_list: not-applicable
  live_tools_list_note: >-
    tools/list cannot be probed anonymously — the server is stdio-only and requires an
    H2OGPTE_API_KEY. The tool set is instead derived deterministically from the published
    OpenAPI document plus the endpoint-set definitions in the server's own source.