Add MCP server card and AI catalog for agent discovery #2832
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,14 @@ | ||
| # Shared response headers for the agent-discovery documents under | ||
| # /.well-known (MCP Server Card, AI Catalog). CORS set and caching follow | ||
| # the SEP-2127 discovery doc: | ||
| # https://github.com/modelcontextprotocol/ext-server-card/blob/main/docs/discovery.md | ||
| # The documents are public, read-only metadata, so wide-open CORS is safe. | ||
| add_header 'Access-Control-Allow-Origin' '*' always; | ||
| add_header 'Access-Control-Allow-Methods' 'GET' always; | ||
| add_header 'Access-Control-Allow-Headers' 'Content-Type, If-None-Match' always; | ||
| add_header 'Access-Control-Expose-Headers' 'ETag' always; | ||
| add_header 'Cache-Control' 'public, max-age=3600' always; | ||
| # Browser preflight. The static handler would answer OPTIONS with 405. | ||
| if ($request_method = OPTIONS) { | ||
| return 204; | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,41 @@ | ||
| { | ||
| "specVersion": "1.0", | ||
| "host": { | ||
| "displayName": "Stellar Developer Documentation", | ||
| "documentationUrl": "https://developers.stellar.org/" | ||
| }, | ||
| "entries": [ | ||
| { | ||
| "identifier": "urn:air:stellar.org:mcp:raven", | ||
| "displayName": "Stellar Raven MCP server", | ||
| "type": "application/mcp-server-card+json", | ||
| "url": "https://developers.stellar.org/.well-known/mcp/server-card.json", | ||
| "description": "Server card for Stellar Raven, the remote MCP server that gives agents Stellar docs, live ecosystem data, and tested playbooks.", | ||
| "tags": ["stellar", "mcp", "raven"] | ||
| }, | ||
| { | ||
| "identifier": "urn:air:stellar.org:skills:index", | ||
| "displayName": "Stellar Agent Skills index", | ||
| "type": "application/agent-skills+json", | ||
| "url": "https://developers.stellar.org/.well-known/agent-skills/index.json", | ||
| "description": "Index of the official Stellar agent skills with pinned download URLs and digests.", | ||
| "tags": ["stellar", "agent-skills"] | ||
| }, | ||
| { | ||
| "identifier": "urn:air:stellar.org:api:catalog", | ||
| "displayName": "Stellar API Catalog", | ||
| "type": "application/linkset+json", | ||
| "url": "https://developers.stellar.org/.well-known/api-catalog", | ||
| "description": "RFC 9727 API catalog for Stellar RPC, Horizon, Anchor Platform, and Stellar Disbursement Platform.", | ||
| "tags": ["stellar", "api", "rfc9727"] | ||
| }, | ||
| { | ||
| "identifier": "urn:air:stellar.org:docs:llms-txt", | ||
| "displayName": "Stellar Docs llms.txt", | ||
| "type": "text/plain", | ||
| "url": "https://developers.stellar.org/llms.txt", | ||
| "description": "Text index of the Stellar developer documentation for AI systems.", | ||
| "tags": ["stellar", "documentation", "llms.txt"] | ||
| } | ||
| ] | ||
| } | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,18 @@ | ||
| { | ||
| "$schema": "https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json", | ||
| "name": "org.stellar/raven", | ||
|
Contributor
Author
There was a problem hiding this comment. The card schema requires exactly one slash in name (pattern ^[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+$). Raven's runtime name stellar-raven-codemode does not fit that pattern, so the card cannot copy it. version matches the runtime (0.1.0). Aligning Raven's serverInfo.name to org.stellar/raven is a follow-up in the stellar-raven repo. |
||
| "title": "Stellar Raven", | ||
| "version": "0.1.0", | ||
| "description": "Stellar MCP server for AI agents: official docs search, live ecosystem data, and tested playbooks.", | ||
| "websiteUrl": "https://raven.stellar.org", | ||
| "repository": { | ||
| "url": "https://github.com/stellar-experimental/stellar-raven", | ||
| "source": "github" | ||
| }, | ||
| "remotes": [ | ||
| { | ||
| "type": "streamable-http", | ||
| "url": "https://raven.stellar.org/mcp" | ||
| } | ||
| ] | ||
| } | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Not changed on purpose. The agent-skills discovery RFC says to serve /.well-known/agent-skills/index.json with application/json (cloudflare/agent-skills-discovery-rfc README, publishing checklist). The catalog type field names the artifact kind with the AI Catalog known type. developers.cloudflare.com does the same: catalog type application/agent-skills+json, index served as application/json.