Server Listing

Provides access to public server listings, including metadata, filtering, and ranking.

Server Listing object

Attributes

object

String

id

String

The unique identifier of the server listing

status

Enum

The current status of the server listing

slug

String

A URL-friendly unique string identifier for the listing

image_url

String

URL to the image representing the server listing

profile

ObjectNullable

name

String

The name of the server listing

description

String

A detailed description of the server listing

readme

String

README content or notes related to the server listing

categories

Object

Categories associated with the server listing

skills

Array of Strings

List of skills relevant to the server listing

is_official

Boolean

Indicates if the listing is officially recognized

is_community

Boolean

Indicates if the listing is community contributed

is_hostable

Boolean

Indicates if the listing can be hosted

is_metorial

Boolean

True if this listing is managed directly by Metorial

is_verified

Boolean

Indicates whether the listing has been verified for authenticity

server

Object

vendor

ObjectNullable

Information about the vendor, if any

repository

ObjectNullable

Repository details, if any

installation

ObjectNullable

Installation details, if any

created_at

Date

Server listing creation timestamp

updated_at

Date

Server listing last update timestamp

{
  "object": "server_listing",
  "status": "active",
  "profile": {
    "object": "profile",
    "slug": "openai",
    "image_url": "https://cdn.metorial.com/images/profiles/12345/avatar.png",
    "badges": [
      {
        "type": "system",
        "name": "Top Contributor"
      },
      {
        "type": "system",
        "name": "Top Contributor"
      }
    ]
  },
  "categories": [
    {
      "object": "server_listing.category"
    },
    {
      "object": "server_listing.category"
    }
  ],
  "server": {
    "object": "server#preview",
    "type": "public"
  },
  "vendor": {},
  "repository": {},
  "installation": {}
}

List server listings

Returns a paginated list of server listings, filterable by collection, category, profile, or instance.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

search

StringOptional

collection_id

UnionOptional

category_id

UnionOptional

profile_id

UnionOptional

instance_id

StringOptional

order_by_rank

BooleanOptional
GEThttp://api.metorial.comserver-listings
curl -X GET "https://api.metorial.comserver-listings" \
  -H "Authorization: Bearer metorial_sk_..."

Get server listing

Returns metadata and readme content for a specific server listing.

URL Parameters

server_listing_id

String

The unique identifier for the server_listing

Query Parameters

instance_id

StringOptional
GEThttp://api.metorial.comserver-listings/:server_listing_id
curl -X GET "https://api.metorial.comserver-listings/ser_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."