> ## Documentation Index
> Fetch the complete documentation index at: https://dev-docs.altrum.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP endpoint

> Altrum's MCP server, for MCP clients and coding agents. It speaks the Model Context Protocol over streamable HTTP (JSON-RPC 2.0) and lists the tools your key may use, across your organization's MCP servers.



## OpenAPI

````yaml /api-reference/openapi.json post /mcp
openapi: 3.1.0
info:
  title: Altrum AI Gateway API
  version: 1.0.0
  description: >-
    The public API of the Altrum AI Gateway. It accepts the OpenAI, Anthropic
    and Gemini request formats, so an existing client needs only a new base URL
    and a virtual key.
servers:
  - url: https://api.altrum.ai
security:
  - bearer: []
  - apiKey: []
  - googleApiKey: []
  - altrumKey: []
tags:
  - name: OpenAI
  - name: Anthropic
  - name: Gemini
  - name: MCP
  - name: Health
paths:
  /mcp:
    post:
      tags:
        - MCP
      summary: MCP endpoint
      description: >-
        Altrum's MCP server, for MCP clients and coding agents. It speaks the
        Model Context Protocol over streamable HTTP (JSON-RPC 2.0) and lists the
        tools your key may use, across your organization's MCP servers.
      operationId: mcpRequest
      parameters:
        - $ref: '#/components/parameters/RequestIdIn'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: A JSON-RPC 2.0 message.
              additionalProperties: true
            example:
              jsonrpc: '2.0'
              id: 1
              method: tools/list
      responses:
        '200':
          description: The JSON-RPC reply.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                jsonrpc: '2.0'
                id: 1
                result:
                  tools:
                    - name: tickets-search
                      description: Search tickets.
        '401':
          description: No virtual key was sent.
          content:
            text/plain:
              schema:
                type: string
        '403':
          description: >-
            The key may not reach the MCP server, or access could not be
            decided.
          content:
            text/plain:
              schema:
                type: string
components:
  parameters:
    RequestIdIn:
      name: x-request-id
      in: header
      required: false
      description: >-
        Your own reference for the request. Altrum uses it instead of making
        one, and returns it.
      schema:
        type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: >-
        Your virtual key, `sk-alt-...`. What every OpenAI and Anthropic SDK
        sends.
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your virtual key, as Anthropic clients send it.
    googleApiKey:
      type: apiKey
      in: header
      name: x-goog-api-key
      description: Your virtual key, as Gemini clients send it.
    altrumKey:
      type: apiKey
      in: header
      name: x-alt-vk
      description: >-
        Your virtual key. Needed when `Authorization` carries your own provider
        key (`x-alt-direct-key`).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.