Provider Listings

A listing is a provider enriched with marketplace metadata.

Provider Listings object

Attributes

object

String

String representing the object's type

id

String

Unique listing identifier

attributes

Object

Listing attribute flags

name

String

Display name

description

StringNullable

Full description

slug

String

URL-friendly identifier

image_url

String

URL of the listing logo/icon

readme

StringNullable

README content in markdown

skills

Array of Strings

Capability tags

provider

Object

categories

Object

Provider categories for organization and filtering

collections

Object

Provider collections this provider belongs to

groups

Object

User groups with access to this provider

created_at

Date

Timestamp when created

updated_at

Date

Timestamp when last updated

{
"object": "provider.listing",
"id": "plg_8kLmNpQrStUvWxYz",
"attributes": {},
"name": "GitHub",
"description": "Connect to GitHub repositories, issues, and pull requests",
"slug": "github",
"image_url": "https://cdn.metorial.com/images/github.png",
"readme": "# GitHub\n\nConnect to GitHub repositories, issues, and pull requests.",
"skills": [
"code-review",
"pull-requests"
],
"provider": {
"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"
},
"categories": [
{
"object": "provider.listing_category",
"id": "pca_2mNpQrStUvWxYzAb",
"name": "Developer Tools",
"description": "Tools for software development and CI/CD",
"slug": "developer-tools",
"created_at": "2025-09-15T10:30:00.000Z",
"updated_at": "2026-01-10T14:45:00.000Z"
}
],
"collections": [
{
"object": "provider.listing_collection",
"id": "pco_6pQrStUvWxYzAbCd",
"name": "CRM Integrations",
"description": "Providers for customer relationship management",
"slug": "crm",
"created_at": "2025-09-15T10:30:00.000Z",
"updated_at": "2026-01-10T14:45:00.000Z"
}
],
"groups": [
{
"object": "provider.listing_group",
"id": "pgr_3nPqRsTuVwXyZaBc",
"name": "Sales Integrations",
"description": "CRM and sales pipeline integrations for sales agents",
"slug": "sales-integrations",
"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"
}

List provider listings

Returns a paginated list of provider listings.

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

search

StringOptional

provider_category_id

UnionOptional

provider_collection_id

UnionOptional

provider_group_id

UnionOptional

publisher_id

UnionOptional

is_public

BooleanOptional

only_from_tenant

BooleanOptional

is_verified

BooleanOptional

is_official

BooleanOptional

is_metorial

BooleanOptional

order_by_rank

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

Get provider listing

Retrieves a specific provider listing by ID.

URL Parameters

provider_listing_id

String

The unique identifier for the provider_listing

GEThttp://api.metorial.com/provider-listings/:provider_listing_id
curl -X GET "https://api.metorial.com/provider-listings/pro_Rm4Mnheq2bfEPhBhP7SY" \
-H "Authorization: Bearer metorial_sk_..."