Providers

A provider is a read-only template for an MCP server integration (like GitHub or Slack). To use a provider, create a deployment from it.

Providers object

Attributes

object

String

String representing the object's type

id

String

Unique provider identifier

access

String

Access level of the provider

status

String

Current status of the provider

publisher

Object

current_version

ObjectNullable

type

Object

oauth

ObjectNullable

identifier

String

Provider identifier

tag

String

Provider tag

name

String

Display name of the provider

description

StringNullable

Brief description of the provider

slug

String

URL-friendly identifier

metadata

ObjectNullable

Custom key-value pairs for storing additional information

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
  "object": "provider",
  "id": "pro_5gHjKlMnPqRsTuVw",
  "access": "public",
  "status": "active",
  "publisher": {
    "object": "provider.publisher",
    "id": "pub_9hJkLmNpQrStUvWx",
    "name": "Acme Corp",
    "description": "A leading provider of developer tools",
    "slug": "acme-corp",
    "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": {
    "object": "provider.version",
    "id": "prv_4dEfGhJkLmNpQrSt",
    "version": "1.0.0",
    "provider_id": "pro_5gHjKlMnPqRsTuVw",
    "name": "Version 1.0.0",
    "metadata": {
      "imported_from": "legacy-system",
      "migration_date": "2025-09-01"
    },
    "specification_id": "psp_9gHjKlMnPqRsTuVw",
    "created_at": "2025-09-15T10:30:00.000Z",
    "updated_at": "2026-01-10T14:45:00.000Z"
  },
  "type": {
    "object": "provider.type",
    "id": "pty_3cDeFgHjKlMnPqRs",
    "name": "mcp",
    "config": {
      "status": "enabled",
      "read": {
        "status": "enabled"
      }
    },
    "triggers": {
      "status": "enabled"
    },
    "auth": {
      "status": "enabled",
      "oauth": {
        "status": "enabled",
        "oauth_auto_registration": {
          "status": "supported"
        }
      },
      "export": {
        "status": "enabled"
      },
      "import": {
        "status": "enabled"
      }
    },
    "created_at": "2025-09-15T10:30:00.000Z"
  },
  "oauth": {
    "auto_registration": {}
  },
  "metadata": {
    "imported_from": "legacy-system",
    "migration_date": "2025-09-01"
  },
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z"
}

List providers

Returns a paginated list of providers.

Query Parameters

limit

NumberOptional

Maximum number of items to return (1-100)

after

StringOptional

Return items after this ID

before

StringOptional

Return items before this ID

cursor

StringOptional

Pagination cursor from a previous response

order

EnumOptional

Sort order for results

GEThttp://api.metorial.com/providers
curl -X GET "https://api.metorial.com/providers" \
  -H "Authorization: Bearer metorial_sk_..."

Get provider

Retrieves a specific provider by ID.

URL Parameters

provider_id

String

The unique identifier for the provider

GEThttp://api.metorial.com/providers/:provider_id
curl -X GET "https://api.metorial.com/providers/pro_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."