Emporix · Schema

McpServerResponse

CompanyCommerceE-CommerceB2B CommerceHeadless CommerceComposable CommerceCommerce OrchestrationAgentic CommerceiPaaSSoftware-as-a-Service
View JSON Schema on GitHub

JSON Schema

emporix-mcp-server-response-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/emporix/json-schema/emporix-mcp-server-response-schema.json",
  "title": "McpServerResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/emporix-mcp-server-api-openapi.yml#/components/schemas/McpServerResponse",
  "oneOf": [
    {
      "$ref": "#/$defs/CustomMcpServerResponse"
    },
    {
      "$ref": "#/$defs/DynamicMcpServerResponse"
    }
  ],
  "$defs": {
    "BaseManagedMcpServer": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name of the MCP server."
        },
        "enabled": {
          "type": "boolean",
          "description": "An indicator whether the MCP server is enabled.",
          "default": false
        },
        "transport": {
          "$ref": "#/$defs/CustomMcpServerTransportType"
        }
      }
    },
    "CustomMcpServerResponse": {
      "allOf": [
        {
          "$ref": "#/$defs/BaseManagedMcpServer"
        },
        {
          "type": "object",
          "description": "An object representing customer's own implementation of the MCP server.",
          "properties": {
            "id": {
              "type": "string",
              "description": "Unique identifier of the MCP server."
            },
            "type": {
              "allOf": [
                {
                  "$ref": "#/$defs/ManagedMcpServerType"
                }
              ],
              "description": "Type of the managed MCP server resource."
            },
            "config": {
              "$ref": "#/$defs/McpServerConfigResponse"
            },
            "metadata": {
              "$ref": "#/$defs/MetadataResponse"
            }
          }
        }
      ]
    },
    "CustomMcpServerTransportType": {
      "type": "string",
      "enum": [
        "streamable_http",
        "sse"
      ],
      "description": "Type of the communication between the agent and the MCP server. The `streamable_http` protocol is recommended, since the `sse` protocol is deprecated as transport for custom MCP servers."
    },
    "DynamicMcpServerResponse": {
      "allOf": [
        {
          "$ref": "#/$defs/BaseManagedMcpServer"
        },
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "description": "Unique identifier of the MCP server."
            },
            "type": {
              "allOf": [
                {
                  "$ref": "#/$defs/ManagedMcpServerType"
                }
              ],
              "description": "For dynamic MCP servers it has to be set to `dynamic`."
            },
            "tools": {
              "type": "array",
              "description": "List of tools exposed by this MCP server.\n\n**The `tools` field is in preview mode** - some of the features may not be fully operational yet.",
              "items": {
                "$ref": "#/$defs/McpToolResponse"
              }
            },
            "metadata": {
              "$ref": "#/$defs/MetadataResponse"
            }
          }
        }
      ]
    },
    "ExpandableTokenResponse": {
      "oneOf": [
        {
          "$ref": "#/$defs/IdResponse"
        },
        {
          "$ref": "#/$defs/ExpandedTokenResponse"
        }
      ],
      "description": "The full response representing token. If the `expand=token` is **not** used, then only `id` field is returned, otherwise all fields are returned."
    },
    "ExpandedTokenResponse": {
      "allOf": [
        {
          "$ref": "#/$defs/IdResponse"
        },
        {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "Name of the token."
            },
            "metadata": {
              "$ref": "#/$defs/MetadataResponse"
            }
          }
        }
      ]
    },
    "IdResponse": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Identifier of the resource."
        }
      }
    },
    "ManagedMcpServerType": {
      "type": "string",
      "enum": [
        "custom",
        "dynamic"
      ],
      "description": "Type of the managed MCP server resource. Possible values:\n* `custom`\n* `dynamic`\n\n  **The `dynamic` value is in preview mode** - some of the features may not be fully operational yet."
    },
    "McpServerConfig": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string",
          "description": "URL of the MCP server."
        },
        "authorizationHeaderName": {
          "type": "string",
          "description": "Name of the header required for authorization, e.g. `Authorization`."
        }
      },
      "required": [
        "url"
      ]
    },
    "McpServerConfigResponse": {
      "allOf": [
        {
          "$ref": "#/$defs/McpServerConfig"
        },
        {
          "type": "object",
          "properties": {
            "authorizationHeaderToken": {
              "$ref": "#/$defs/ExpandableTokenResponse"
            }
          }
        }
      ]
    },
    "McpToolConfigResponse": {
      "type": "object",
      "properties": {
        "requiredScopes": {
          "type": "array",
          "description": "OAuth scopes required to invoke the tool.",
          "items": {
            "type": "string"
          }
        },
        "inputSchema": {
          "type": "string",
          "description": "JSON Schema document describing the tool input, provided as a JSON string."
        },
        "invocation": {
          "$ref": "#/$defs/McpToolInvocationResponse"
        }
      }
    },
    "McpToolInvocationArgsLocation": {
      "type": "string",
      "enum": [
        "body",
        "query"
      ],
      "description": "Location of the tool arguments in the HTTP request. Defaults to `body` when omitted."
    },
    "McpToolInvocationMethod": {
      "type": "string",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "PATCH",
        "DELETE"
      ],
      "description": "HTTP method used to invoke the Automation function."
    },
    "McpToolInvocationResponse": {
      "type": "object",
      "properties": {
        "functionId": {
          "type": "string",
          "description": "Identifier of the Automation function to invoke when the tool is called."
        },
        "method": {
          "$ref": "#/$defs/McpToolInvocationMethod"
        },
        "argsLocation": {
          "$ref": "#/$defs/McpToolInvocationArgsLocation"
        }
      }
    },
    "McpToolResponse": {
      "type": "object",
      "description": "Tool definition for a dynamic MCP server.\n\n**Dynamic MCP tools are in preview mode** - some of the features may not be fully operational yet.",
      "properties": {
        "name": {
          "type": "string",
          "description": "Unique name of the tool. Contains only letters, numbers, and underscores."
        },
        "description": {
          "type": "string",
          "description": "Human-readable description of the tool."
        },
        "prompt": {
          "type": "string",
          "description": "Prompt that defines when and why the agent should call this tool."
        },
        "enabled": {
          "type": "boolean",
          "description": "An indicator whether the tool is enabled."
        },
        "config": {
          "$ref": "#/$defs/McpToolConfigResponse"
        }
      }
    },
    "MetadataRequest": {
      "type": "object",
      "properties": {
        "version": {
          "minimum": 1,
          "type": "integer",
          "description": "Version of the object. The version is required during the update operation because of the optimistic locking mechanism."
        }
      },
      "required": [
        "version"
      ]
    },
    "MetadataResponse": {
      "allOf": [
        {
          "$ref": "#/$defs/MetadataRequest"
        },
        {
          "type": "object",
          "properties": {
            "createdAt": {
              "description": "Date and time when the object was created. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-30T13:18:02.379Z`",
              "type": "string"
            },
            "modifiedAt": {
              "description": "Date and time when the object was last modified. The value is approved as an ISO-8601 representation of an Instant. For example: `2022-04-30T13:18:02.379Z`",
              "type": "string"
            }
          },
          "required": [
            "version",
            "createdAt",
            "modifiedAt"
          ]
        }
      ]
    }
  }
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • 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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/emporix-mcp-server-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

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