Portal

Use Portals to create custom branded MCP server marketplaces for your organization.

Portal object

Attributes

object

String

Type of the object, fixed as portal

id

String

The unique identifier of the portal

status

Enum

The status of the portal

name

String

The name of the portal

slug

String

The slug of the portal

description

StringNullable

The description of the portal

auth

Object

Authentication settings for the portal

urls

Object

List of URLs associated with the portal

brand

Object

The brand information of the portal

created_at

Date

The ISO 8601 timestamp when the portal was created

updated_at

Date

The ISO 8601 timestamp when the portal was last updated

{
  "object": "portal",
  "status": "active",
  "auth": {
    "object": "portal.auth"
  },
  "urls": [
    {
      "type": "default"
    },
    {
      "type": "default"
    }
  ],
  "brand": {}
}

List Portal

Returns a paginated list of portals.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

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

Get SSO Tenant by ID

Retrieves details for a specific portal by its ID.

URL Parameters

portal_id

String

The unique identifier for the portal

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

Create SSO Tenant

Creates a new sso tenant for the instance.

Request Body

name

String

description

StringOptional
POSThttp://api.metorial.com/portals
curl -X POST "https://api.metorial.com/portals" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description"
}'

Update Portal

Updates an existing portal for the instance.

URL Parameters

portal_id

String

The unique identifier for the portal

Request Body

name

StringOptional

description

StringOptional

brand_name

StringOptional

session_expiry_time_in_seconds

NumberOptional
PATCHhttp://api.metorial.com/portals/:portal_id
curl -X PATCH "https://api.metorial.com/portals/por_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "brand_name": "example_brand_name",
  "session_expiry_time_in_seconds": 0
}'

Delete Portal

Deletes a portal from the instance.

URL Parameters

portal_id

String

The unique identifier for the portal

DELETEhttp://api.metorial.com/portals/:portal_id
curl -X DELETE "https://api.metorial.com/portals/por_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."