Skip to content

[Documentation]: Clarify the scope of "server" and "service" in the README #6

@ognis1205

Description

@ognis1205

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 server
  • https://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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions