Provider Listings
A listing is a provider enriched with marketplace metadata.
Provider Listings object
Attributes
object
StringString representing the object's type
id
StringUnique listing identifier
attributes
ObjectListing attribute flags
name
StringDisplay name
description
StringNullableFull description
slug
StringURL-friendly identifier
image_url
StringURL of the listing logo/icon
readme
StringNullableREADME content in markdown
skills
Array of StringsCapability tags
provider
Objectcategories
ObjectProvider categories for organization and filtering
collections
ObjectProvider collections this provider belongs to
groups
ObjectUser groups with access to this provider
created_at
DateTimestamp when created
updated_at
DateTimestamp 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
NumberOptionalMaximum number of items to return (1-100)
after
StringOptionalReturn items after this ID
before
StringOptionalReturn items before this ID
cursor
StringOptionalPagination cursor from a previous response
order
EnumOptionalSort order for results
search
StringOptionalprovider_category_id
UnionOptionalprovider_collection_id
UnionOptionalprovider_group_id
UnionOptionalpublisher_id
UnionOptionalis_public
BooleanOptionalonly_from_tenant
BooleanOptionalis_verified
BooleanOptionalis_official
BooleanOptionalis_metorial
BooleanOptionalorder_by_rank
BooleanOptionalcurl -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
StringThe unique identifier for the provider_listing
curl -X GET "https://api.metorial.com/provider-listings/pro_Rm4Mnheq2bfEPhBhP7SY" \-H "Authorization: Bearer metorial_sk_..."