Emporix · Schema
McpServerResponse
CompanyCommerceE-CommerceB2B CommerceHeadless CommerceComposable CommerceCommerce OrchestrationAgentic CommerceiPaaSSoftware-as-a-Service
JSON Schema
{
"$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.
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.