diff --git a/docs/discovery.md b/docs/discovery.md index 8838b39..8cb0c76 100644 --- a/docs/discovery.md +++ b/docs/discovery.md @@ -50,12 +50,12 @@ An MCP Catalog document is a JSON object that MUST contain the following members Each entry in the `entries` array describes a single MCP server and MUST contain: -| Member | Type | Required | Description | -| :------------ | :----- | :------- | :------------------------------------------------------------------------------------ | -| `identifier` | string | Yes | A logical discovery URN for this server (e.g., `urn:air:example.com:weather`) | -| `displayName` | string | Yes | A human-readable name for the server | -| `mediaType` | string | Yes | The media type of the referenced artifact. MUST be `application/mcp-server-card+json` | -| `url` | string | Yes | URL where the full [Server Card](#mcp-server-cards) can be retrieved | +| Member | Type | Required | Description | +| :------------ | :----- | :------- | :------------------------------------------------------------------------------------------------------- | +| `identifier` | string | Yes | A logical discovery URN for this server (e.g., `urn:air:example.com:weather`) | +| `displayName` | string | Yes | A human-readable name for the server | +| `type` | string | Yes | An identifier specifying the type of the referenced artifact. MUST be `application/mcp-server-card+json` | +| `url` | string | Yes | URL where the full [Server Card](#mcp-server-cards) can be retrieved | The `identifier` is a **logical discovery name** that follows the [AI Catalog](https://github.com/Agent-Card/ai-catalog) domain-anchored URN convention @@ -89,7 +89,7 @@ A domain hosting a single MCP server, using only the required fields: { "identifier": "urn:air:example.com:weather", "displayName": "Weather Service", - "mediaType": "application/mcp-server-card+json", + "type": "application/mcp-server-card+json", "url": "https://example.com/mcp/server-card" } ] @@ -107,19 +107,19 @@ A domain hosting several MCP servers, each with its own server card: { "identifier": "urn:air:acme.com:code-review", "displayName": "Code Review Assistant", - "mediaType": "application/mcp-server-card+json", + "type": "application/mcp-server-card+json", "url": "https://acme.com/code-review/server-card" }, { "identifier": "urn:air:acme.com:docs-search", "displayName": "Documentation Search", - "mediaType": "application/mcp-server-card+json", + "type": "application/mcp-server-card+json", "url": "https://acme.com/docs-search/server-card" }, { "identifier": "urn:air:acme.com:ci-cd", "displayName": "CI/CD Pipeline", - "mediaType": "application/mcp-server-card+json", + "type": "application/mcp-server-card+json", "url": "https://acme.com/ci-cd/server-card" } ] @@ -147,8 +147,8 @@ flowchart TD [Server Card Location](#server-card-location)) 4. Use the server card metadata to configure and establish an MCP connection -Clients SHOULD validate that each entry has `mediaType` set to `application/mcp-server-card+json` -and ignore entries with unrecognized media types. +Clients SHOULD validate that each entry has `type` set to `application/mcp-server-card+json` +and ignore entries with unrecognized types. ## MCP Server Cards