-
Notifications
You must be signed in to change notification settings - Fork 7
Description
The current README uses the terms "server" and "service" in ways that can be interpreted differently depending on the reader's background (A2A, MCP, general web architecture, etc.). This creates ambiguity about what the AI Card is intended to describe and what its scope is.
To avoid confusion, I suggest explicitly distinguishing the following two concepts:
1. Host
A single host or network endpoint that may expose AI-related services. In a web environment, this corresponds to what is commonly referred to as a "web origin" (scheme + host + port).**
Example: https://ai.example.com
2. Protocol Server (A2A server, MCP server, etc.)
These represent "services" in the sense used by each protocol.
They typically exist within a single origin, for example:
https://ai.example.com/a2a/v1– A2A serverhttps://ai.example.com/mcp/v1– MCP server
To avoid ambiguity, I propose defining “service” explicitly as:
A protocol-specific server instance (e.g., A2A server, MCP server) representing a unit of capability within a single origin.
If the maintainers agree with this direction, I would be happy to contribute a PR improving the README with clearer definitions.