MCPNest

MCPNest API

MCPNest API as documented publicly: 14 operations. Contract generated from the documentation by API Evangelist (2026-10-18); not the provider's own document.

GitHub OpenAPI

Operations 14

POST /api/gw/{workspaceSlug} Gateway — Live in Production #
GET /api/health Verify deployment #
POST /api/health POST /api/health #
GET /api/hosted API — List instances #
POST /api/hosted API — Deploy an instance #
GET /api/hosted/{id}/logs API — Get logs #
GET /api/v1/categories GET /categories #
GET /api/v1/servers GET /api/v1/servers #
GET /api/v1/servers/{slug} GET /servers/:slug #
GET /categories GET /categories #
GET /servers Registry API — Overview #
GET /servers/{slug} GET /servers/:slug #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/mcpnest/refs/heads/main/openapi/_ae-authored/mcpnest-openapi-generated.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mcpnest/refs/heads/main/json-schema/mcpnest-get-api-v1-servers-slug-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mcpnest/refs/heads/main/json-schema/mcpnest-get-servers-slug-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mcpnest/refs/heads/main/json-schema/mcpnest-post-api-hosted-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mcpnest/refs/heads/main/json-schema/mcpnest-get-servers-response-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mcpnest/refs/heads/main/json-schema/mcpnest-post-api-health-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/mcpnest/refs/heads/main/json-schema/mcpnest-get-categories-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/mcpnest:mcpnest-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mcpnest-openapi-generated.yml Raw ↑ 
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