openapi: 3.1.0
info:
  title: MCPNest API
  version: '2026-10-18'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-18: 14 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; MCPNest has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 11
    pages-with-code: 1
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-18'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://mcpnest.io/docs
  - https://mcpnest.io/gateway
paths:
  /api/gw/{workspaceSlug}:
    post:
      operationId: post_api_gw_workspaceSlug
      tags:
      - Api
      summary: Gateway — Live in Production
      description: Creates a gateway endpoint for the specified workspace.
      x-source: https://mcpnest.io/gateway
      parameters:
      - name: workspaceSlug
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/health:
    get:
      operationId: get_api_health
      tags:
      - Api
      summary: Verify deployment
      x-source: https://mcpnest.io/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_health
      tags:
      - Api
      summary: POST /api/health
      x-source: https://mcpnest.io/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiHealthRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl http://localhost:3000/api/health COPY OK The Gateway is stateless — all state lives in Supabase. You can run multiple Gateway
          instances behind a load balancer for high availability. Hosted MCP Servers MCPNest can host MCP servers on your behalf inside isolated
          Docker containers. Instead of running npx commands locally or maintaining your own server, MCPNest manages the container lifecycle,
          he
  /api/hosted:
    get:
      operationId: get_api_hosted
      tags:
      - Api
      summary: API — List instances
      description: List hosted server instances for a workspace.
      x-source: https://mcpnest.io/docs
      parameters:
      - name: workspace_id
        in: query
        required: true
        schema:
          type: string
        description: Workspace UUID
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_hosted
      tags:
      - Api
      summary: API — Deploy an instance
      description: Deploy a hosted MCP server instance.
      x-source: https://mcpnest.io/docs
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiHostedRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/hosted/{id}/logs:
    get:
      operationId: get_api_hosted_id_logs
      tags:
      - Api
      summary: API — Get logs
      description: Retrieve logs for a hosted instance.
      x-source: https://mcpnest.io/docs
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: tail
        in: query
        required: false
        schema:
          type: number
        description: Number of log lines to return
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/categories:
    get:
      operationId: get_api_v1_categories
      tags:
      - Api
      summary: GET /categories
      description: List all categories with server counts (v1 API).
      x-source: https://mcpnest.io/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1CategoriesResponse'
      x-evidence:
        kind: documentation
  /api/v1/servers:
    get:
      operationId: get_api_v1_servers
      tags:
      - Api
      summary: GET /api/v1/servers
      x-source: https://mcpnest.io/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: python
        snippet: "requests.get(\n 'https://mcpnest.io/api/v1/servers',\n params={'q': 'postgres', 'verified': 'true', 'limit': 10}\n)"
  /api/v1/servers/{slug}:
    get:
      operationId: get_api_v1_servers_slug
      tags:
      - Api
      summary: GET /servers/:slug
      description: Get a single server by slug (v1 API).
      x-source: https://mcpnest.io/docs
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1ServersSlugResponse'
      x-evidence:
        kind: documentation
  /api/v1/trending:
    get:
      operationId: get_api_v1_trending
      tags:
      - Api
      summary: GET /trending
      description: Most installed servers this week (v1 API).
      x-source: https://mcpnest.io/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1TrendingResponse'
      x-evidence:
        kind: documentation
  /categories:
    get:
      operationId: get_categories
      tags:
      - Categories
      summary: GET /categories
      description: List all categories with server counts.
      x-source: https://mcpnest.io/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetCategoriesResponse'
      x-evidence:
        kind: documentation
  /servers:
    get:
      operationId: get_servers
      tags:
      - Servers
      summary: Registry API — Overview
      description: 'List and search MCP servers. Query parameters: q (string), category (string), verified (boolean), sort (string), limit (number),
        page (number).'
      x-source: https://mcpnest.io/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetServersResponse'
      x-evidence:
        kind: documentation
  /servers/{slug}:
    get:
      operationId: get_servers_slug
      tags:
      - Servers
      summary: GET /servers/:slug
      description: Get a single server by slug.
      x-source: https://mcpnest.io/docs
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetServersSlugResponse'
      x-evidence:
        kind: documentation
  /trending:
    get:
      operationId: get_trending
      tags:
      - Trending
      summary: GET /trending
      description: Most installed servers this week.
      x-source: https://mcpnest.io/docs
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTrendingResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiHealthRequest:
      type: object
      properties:
        workspace_id:
          type: string
        server_slug:
          type: string
        env_vars:
          type: object
    PostApiHostedRequest:
      type: object
      properties:
        workspace_id:
          type: string
          description: Workspace UUID
        server_slug:
          type: string
          description: Slug of the server to deploy
        env_vars:
          type: object
          description: Environment variables for the instance
      required:
      - workspace_id
      - server_slug
    GetApiV1CategoriesResponse:
      type: object
      properties:
        categories:
          type: array
    GetApiV1ServersSlugResponse:
      type: object
      properties:
        slug:
          type: string
        name:
          type: string
        description:
          type: string
        long_description:
          type: string
        category:
          type: string
        tags:
          type: array
        github_url:
          type: string
        endpoint_url:
          type: string
        install_configs:
          type: object
        compatibility:
          type: object
        github_stars:
          type: number
        install_count:
          type: number
        tool_count:
          type: number
        is_verified:
          type: boolean
        quality_score:
          type: number
        language:
          type: string
        created_at:
          type: string
    GetApiV1TrendingResponse:
      type: object
      properties:
        servers:
          type: array
    GetCategoriesResponse:
      type: object
      properties:
        categories:
          type: array
          description: List of category objects with name and count
    GetServersResponse:
      type: object
      properties:
        servers:
          type: array
          description: List of server objects
        meta:
          type: object
          description: Pagination metadata
    GetServersSlugResponse:
      type: object
      properties:
        slug:
          type: string
        name:
          type: string
        description:
          type: string
        long_description:
          type: string
        category:
          type: string
        tags:
          type: array
        github_url:
          type: string
        endpoint_url:
          type: string
        install_configs:
          type: object
        compatibility:
          type: object
        github_stars:
          type: number
        install_count:
          type: number
        tool_count:
          type: number
        is_verified:
          type: boolean
        quality_score:
          type: number
        language:
          type: string
        created_at:
          type: string
    GetTrendingResponse:
      type: object
      properties:
        servers:
          type: array
          description: Most installed servers this week
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Categories
- name: Servers
- name: Trending