Portal

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

Portal object

Attributes

object

String

id

String

status

Enum

name

String

slug

String

description

StringNullable

auth

Object

urls

Object

created_at

Date

updated_at

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

List portals

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 portal

Retrieves details for a specific portal.

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 portal

Creates a new portal for the instance.

Request Body

name

String

description

StringOptional

allowed_redirect_url_filters

ObjectOptional

session_expiry_time_in_seconds

NumberOptional
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",
  "allowed_redirect_url_filters": {
    "url": "example_url"
  },
  "session_expiry_time_in_seconds": 0
}'

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

allowed_redirect_url_filters

ObjectOptional

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",
  "allowed_redirect_url_filters": {
    "url": "example_url"
  },
  "session_expiry_time_in_seconds": 0
}'

Delete portal

Archives a portal.

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_..."