MEmetorial
Custom Providers

Create custom provider

Creates a new custom provider.

post/custom-providers

Request

  • Base URL
    https://api.metorial.com
  • Auth
    HTTP bearer

Headers

Metorial-Versionstring
Example:2025-01-01

Pin the dated API version for this request, e.g. 2025-01-01. Defaults to the version configured for the environment.

Request body

namestring required
descriptionstring
metadataobject

Custom key-value pairs for storing additional information

Example request

{
  "name": "My Custom Provider",
  "description": "A custom MCP server for my application"
}

Response

Successful response

object'custom_provider' required

String representing the object's type

idstring required

Unique custom provider identifier

status'active' | 'archived' | 'deleted' required

Current status of the custom provider

type'function' | 'container' | 'remote' required

Type of the custom provider

namestring required

Display name of the custom provider

descriptionstring nullable required

Brief description of the custom provider

metadataobject nullable required

Custom key-value pairs for storing additional information

created_atstring date-time required

Timestamp when created

updated_atstring date-time required

Timestamp when last updated

Example response

{
  "id": "cpr_1aBcDeFgHjKlMnPq",
  "name": "My Custom Provider",
  "description": "A custom provider for my application",
  "draft": {
    "container_image": {
      "container_registry": "https://index.docker.io/v1/",
      "container_image_tag": "v1.0.0",
      "container_image": "my-app-image"
    },
    "remote_mcp_server": {
      "url": "https://mcp.example.com"
    }
  },
  "provider": {
    "id": "pro_5gHjKlMnPqRsTuVw",
    "publisher": {
      "id": "pub_9hJkLmNpQrStUvWx",
      "name": "Acme Corp",
      "description": "A leading provider of developer tools",
      "image_url": "https://cdn.metorial.com/images/acme.png",
      "created_at": "2025-09-15T10:30:00.000Z",
      "updated_at": "2026-01-10T14:45:00.000Z"
    },
    "current_version": {
      "id": "prv_4dEfGhJkLmNpQrSt",
      "version": "1.0.0",
      "provider_id": "pro_5gHjKlMnPqRsTuVw",
      "name": "Version 1.0.0",
      "specification_id": "psp_9gHjKlMnPqRsTuVw",
      "created_at": "2025-09-15T10:30:00.000Z",
      "updated_at": "2026-01-10T14:45:00.000Z"
    },
    "created_at": "2025-09-15T10:30:00.000Z",
    "updated_at": "2026-01-10T14:45:00.000Z"
  },
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.