agent-card-starter 0.2.0__py3-none-any.whl

agent_card/__init__.py

@@ -0,0 +1,2 @@
+"""agent-card-starter: make a small business readable for AI assistants. Standard library only."""
+__version__ = "0.2.0"

agent_card/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from agent_card.cli import main
+
+sys.exit(main())

agent_card/cli.py

@@ -0,0 +1,105 @@
+"""Command line: `agent-card validate FILE` and `agent-card init`. Standard library only."""
+import argparse
+import json
+import os
+import re
+import sys
+from importlib import resources
+
+from agent_card import __version__, validator
+
+
+def _template() -> str:
+    return resources.files("agent_card").joinpath("data/agent-card.template.json").read_text(encoding="utf-8")
+
+
+def _slug(text: str) -> str:
+    s = re.sub(r"[^a-z0-9]+", "-", text.lower().replace("ä", "ae").replace("ö", "oe").replace("ü", "ue").replace("ß", "ss")).strip("-")
+    return s or "leistung"
+
+
+def skills_from(items) -> list:
+    """`--skill "Name"` or `--skill "Name: one sentence"`. Ids are made from the name and stay stable."""
+    out, seen = [], set()
+    for raw in items:
+        name, _, desc = raw.partition(":")
+        name, desc = name.strip(), desc.strip()
+        if not name:
+            continue
+        sid, n = _slug(name), 2
+        while sid in seen:
+            sid, n = "%s-%d" % (_slug(name), n), n + 1
+        seen.add(sid)
+        out.append({"id": sid, "name": name, "description": desc or name + ".", "tags": [_slug(name)]})
+    return out
+
+
+def build_card(name: str, description: str, website: str, endpoint: str, skills=None) -> dict:
+    """Fill the template. Values go through json so quotes in names cannot break the file."""
+    card = json.loads(_template())
+
+    def fill(x):
+        if isinstance(x, str):
+            return x.replace("{name}", name).replace("{description}", description).replace("{website}", website).replace("{endpoint}", endpoint)
+        if isinstance(x, list):
+            return [fill(i) for i in x]
+        if isinstance(x, dict):
+            return {k: fill(v) for k, v in x.items()}
+        return x
+    card = fill(card)
+    if skills:
+        card["skills"] = skills + card["skills"]      # the inquiry skill stays last
+    return card
+
+
+def cmd_init(a) -> int:
+    website = a.website.rstrip("/")
+    endpoint = a.endpoint or website + "/mcp"
+    card = build_card(a.name, a.description, website, endpoint, skills_from(a.skill))
+    errors, warnings = validator.validate(card, "agent-card")
+    if errors:
+        for m in errors:
+            print("ERROR  " + m)
+        return 1
+    target = os.path.join(a.out, ".well-known", "agent-card.json")
+    if os.path.exists(target) and not a.force:
+        print("ERROR  %s exists already (use --force to overwrite)" % target)
+        return 1
+    os.makedirs(os.path.dirname(target), exist_ok=True)
+    with open(target, "w", encoding="utf-8") as f:
+        json.dump(card, f, ensure_ascii=False, indent=2)
+        f.write("\n")
+    for m in warnings:
+        print("WARN   " + m)
+    print("Wrote %s" % target)
+    print("Next: add one skill per service you really offer, keep prices and phone numbers out,")
+    print("point supportedInterfaces at an endpoint you really operate, run `agent-card validate %s`," % target)
+    print("then publish the file at %s/.well-known/agent-card.json" % website)
+    return 0
+
+
+def main(argv=None) -> int:
+    ap = argparse.ArgumentParser(prog="agent-card", description="Make a small business readable for AI assistants.")
+    ap.add_argument("--version", action="version", version="agent-card-starter " + __version__)
+    sub = ap.add_subparsers(dest="cmd", required=True)
+    v = sub.add_parser("validate", help="check an agent card, server card or catalog (offline)")
+    v.add_argument("file")
+    v.add_argument("--type", choices=["auto", "agent-card", "server-card", "catalog"], default="auto")
+    v.add_argument("--strict", action="store_true", help="treat warnings as errors")
+    i = sub.add_parser("init", help="write a first agent card to <out>/.well-known/agent-card.json")
+    i.add_argument("--name", required=True, help="business name")
+    i.add_argument("--description", required=True, help="one or two sentences: what you do and where")
+    i.add_argument("--website", required=True, help="https URL of your website")
+    i.add_argument("--endpoint", default="", help="https URL of an endpoint you really operate (default: <website>/mcp)")
+    i.add_argument("--skill", action="append", default=[], metavar="NAME[: SENTENCE]", help="one service you really offer, repeat for more")
+    i.add_argument("--out", default=".", help="folder to write into (default: current folder)")
+    i.add_argument("--force", action="store_true", help="overwrite an existing card")
+    a = ap.parse_args(argv)
+    if a.cmd == "validate":
+        extra = [a.file, "--type", a.type] + (["--strict"] if a.strict else [])
+        return validator.main(extra)
+    return cmd_init(a)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

agent_card/data/agent-card.template.json

@@ -0,0 +1,31 @@
+{
+  "name": "{name}",
+  "description": "{description}",
+  "version": "1.0.0",
+  "supportedInterfaces": [
+    {
+      "url": "{endpoint}",
+      "protocolBinding": "MCP",
+      "protocolVersion": "2025-06-18"
+    }
+  ],
+  "provider": {
+    "organization": "{name}",
+    "url": "{website}"
+  },
+  "documentationUrl": "{website}",
+  "capabilities": {
+    "streaming": false,
+    "pushNotifications": false
+  },
+  "defaultInputModes": ["application/json"],
+  "defaultOutputModes": ["application/json"],
+  "skills": [
+    {
+      "id": "anfrage",
+      "name": "Anfrage hinterlassen",
+      "description": "Eine Anfrage anlegen. Ein Mensch im Betrieb meldet sich zurück. Keine Zusage und kein Preis durch den Assistenten.",
+      "tags": ["anfrage", "kontakt"]
+    }
+  ]
+}

agent_card/validator.py

@@ -0,0 +1,272 @@
+#!/usr/bin/env python3
+"""Validate an A2A Agent Card, an MCP Server Card or an AI catalog (offline, stdlib only).
+
+Usage:
+    agent-card validate path/to/agent-card.json   (or: python3 tools/validate_agent_card.py ...)
+    python3 tools/validate_agent_card.py card.json --type server-card --strict
+
+Exit code 0 = valid (warnings allowed), 1 = errors found (or warnings with --strict).
+
+This is a pragmatic subset check of the required fields, not a full JSON Schema
+validation. Standards move: check the official specs before you rely on it.
+Nützlich zum schnellen Prüfen der Pflichtfelder, ersetzt keine Volltest-Validierung.
+"""
+from __future__ import annotations
+
+import argparse
+import json
+import re
+import sys
+from typing import Any, List, Tuple
+
+KNOWN_BINDINGS = {"JSONRPC", "GRPC", "HTTP+JSON", "MCP"}
+SEMVER = re.compile(r"^\d+\.\d+\.\d+([-+][0-9A-Za-z.-]+)?$")
+MEDIA_TYPE = re.compile(r"^[A-Za-z0-9.+-]+/[A-Za-z0-9.+-]+$")
+EURO = re.compile(r"(€|\bEUR\b|\bEuro\b)", re.IGNORECASE)
+PHONE = re.compile(r"(\+\d{2}[\d\s/()-]{6,}|\b0\d{2,5}[\s/-]?\d{4,})")
+EMAIL = re.compile(r"[\w.+-]+@[\w-]+\.[\w.-]+")
+CATALOG_TYPES = {"application/a2a-agent-card+json", "application/mcp-server-card+json"}
+
+
+def strip_comments(text: str) -> str:
+    """Remove // line comments and /* block */ comments outside of strings (JSONC)."""
+    out: List[str] = []
+    i, n = 0, len(text)
+    in_str = False
+    while i < n:
+        c = text[i]
+        if in_str:
+            out.append(c)
+            if c == "\\" and i + 1 < n:
+                out.append(text[i + 1])
+                i += 1
+            elif c == '"':
+                in_str = False
+        elif c == '"':
+            in_str = True
+            out.append(c)
+        elif text.startswith("//", i):
+            while i < n and text[i] != "\n":
+                i += 1
+            continue
+        elif text.startswith("/*", i):
+            end = text.find("*/", i + 2)
+            i = n if end == -1 else end + 2
+            continue
+        else:
+            out.append(c)
+        i += 1
+    return "".join(out)
+
+
+def load(path: str) -> Any:
+    with open(path, encoding="utf-8") as fh:
+        return json.loads(strip_comments(fh.read()))
+
+
+def _is_str(v: Any) -> bool:
+    return isinstance(v, str) and v.strip() != ""
+
+
+def _https(v: Any) -> bool:
+    return _is_str(v) and v.startswith("https://") and " " not in v
+
+
+def detect_type(doc: Any) -> str:
+    if isinstance(doc, dict):
+        if "entries" in doc:
+            return "catalog"
+        if "remotes" in doc or "$schema" in doc:
+            return "server-card"
+    return "agent-card"
+
+
+def _texts(doc: Any):
+    if isinstance(doc, dict):
+        for k, v in doc.items():
+            if k in ("url", "$schema", "websiteUrl", "documentationUrl", "identifier"):
+                continue
+            yield from _texts(v)
+    elif isinstance(doc, list):
+        for v in doc:
+            yield from _texts(v)
+    elif isinstance(doc, str):
+        yield doc
+
+
+def content_warnings(doc: Any) -> List[str]:
+    w: List[str] = []
+    for t in _texts(doc):
+        if EURO.search(t):
+            w.append("price/currency in card text (%r): prices belong to a human offer" % t[:40])
+        if PHONE.search(t):
+            w.append("phone number in card text (%r)" % t[:40])
+        if EMAIL.search(t):
+            w.append("e-mail address in card text (%r)" % t[:40])
+    return w
+
+
+def validate_agent_card(d: Any) -> Tuple[List[str], List[str]]:
+    e: List[str] = []
+    w: List[str] = []
+    if not isinstance(d, dict):
+        return ["top level must be a JSON object"], w
+    for k in ("name", "description", "version"):
+        if not _is_str(d.get(k)):
+            e.append("%s: required, non-empty string" % k)
+    if _is_str(d.get("version")) and not SEMVER.match(d["version"]):
+        w.append("version %r is not semver (x.y.z)" % d["version"])
+    ifaces = d.get("supportedInterfaces")
+    if not isinstance(ifaces, list) or not ifaces:
+        e.append("supportedInterfaces: required, at least one entry")
+    else:
+        for i, it in enumerate(ifaces):
+            p = "supportedInterfaces[%d]" % i
+            if not isinstance(it, dict):
+                e.append(p + ": must be an object")
+                continue
+            if not _https(it.get("url")):
+                e.append(p + ".url: required, https URL")
+            if not _is_str(it.get("protocolBinding")):
+                e.append(p + ".protocolBinding: required")
+            elif it["protocolBinding"] not in KNOWN_BINDINGS:
+                w.append("%s.protocolBinding %r not in %s" % (p, it["protocolBinding"], sorted(KNOWN_BINDINGS)))
+            if not _is_str(it.get("protocolVersion")):
+                e.append(p + ".protocolVersion: required")
+    prov = d.get("provider")
+    if not isinstance(prov, dict):
+        w.append("provider: recommended (organization, url)")
+    else:
+        if not _is_str(prov.get("organization")):
+            e.append("provider.organization: required when provider is given")
+        if not _https(prov.get("url")):
+            e.append("provider.url: required when provider is given, https URL")
+    if "documentationUrl" in d and not _https(d["documentationUrl"]):
+        e.append("documentationUrl: must be an https URL")
+    if not isinstance(d.get("capabilities"), dict):
+        e.append("capabilities: required object (may be empty)")
+    for k in ("defaultInputModes", "defaultOutputModes"):
+        v = d.get(k)
+        if not isinstance(v, list) or not v:
+            e.append("%s: required, non-empty list of media types" % k)
+        else:
+            for m in v:
+                if not (isinstance(m, str) and MEDIA_TYPE.match(m)):
+                    e.append("%s: %r is not a media type" % (k, m))
+    skills = d.get("skills")
+    if not isinstance(skills, list) or not skills:
+        e.append("skills: required, at least one skill")
+    else:
+        seen = set()
+        for i, s in enumerate(skills):
+            p = "skills[%d]" % i
+            if not isinstance(s, dict):
+                e.append(p + ": must be an object")
+                continue
+            for k in ("id", "name", "description"):
+                if not _is_str(s.get(k)):
+                    e.append("%s.%s: required, non-empty string" % (p, k))
+            tags = s.get("tags")
+            if not isinstance(tags, list) or not tags or not all(_is_str(t) for t in tags):
+                e.append(p + ".tags: required, non-empty list of strings")
+            if _is_str(s.get("id")):
+                if s["id"] in seen:
+                    e.append("%s.id %r is duplicated" % (p, s["id"]))
+                seen.add(s["id"])
+    w.extend(content_warnings(d))
+    return e, w
+
+
+def validate_server_card(d: Any) -> Tuple[List[str], List[str]]:
+    e: List[str] = []
+    w: List[str] = []
+    if not isinstance(d, dict):
+        return ["top level must be a JSON object"], w
+    for k in ("$schema", "name", "version", "description"):
+        if not _is_str(d.get(k)):
+            e.append("%s: required, non-empty string" % k)
+    if _is_str(d.get("version")) and not SEMVER.match(d["version"]):
+        w.append("version %r is not semver (x.y.z)" % d["version"])
+    if "websiteUrl" in d and not _https(d["websiteUrl"]):
+        e.append("websiteUrl: must be an https URL")
+    remotes = d.get("remotes")
+    if remotes is None:
+        w.append("remotes: none given, assistants cannot connect")
+    elif not isinstance(remotes, list) or not remotes:
+        e.append("remotes: must be a non-empty list")
+    else:
+        for i, r in enumerate(remotes):
+            p = "remotes[%d]" % i
+            if not isinstance(r, dict):
+                e.append(p + ": must be an object")
+                continue
+            if r.get("type") not in ("streamable-http", "sse"):
+                e.append(p + ".type: must be 'streamable-http' or 'sse'")
+            if not _https(r.get("url")):
+                e.append(p + ".url: required, https URL")
+    w.extend(content_warnings(d))
+    return e, w
+
+
+def validate_catalog(d: Any) -> Tuple[List[str], List[str]]:
+    e: List[str] = []
+    w: List[str] = []
+    if not isinstance(d, dict):
+        return ["top level must be a JSON object"], w
+    if not _is_str(d.get("specVersion")):
+        e.append("specVersion: required")
+    entries = d.get("entries")
+    if not isinstance(entries, list) or not entries:
+        e.append("entries: required, at least one entry")
+        return e, w
+    ids = set()
+    for i, it in enumerate(entries):
+        p = "entries[%d]" % i
+        if not isinstance(it, dict):
+            e.append(p + ": must be an object")
+            continue
+        if not _is_str(it.get("identifier")):
+            e.append(p + ".identifier: required")
+        elif it["identifier"] in ids:
+            e.append("%s.identifier %r is duplicated" % (p, it["identifier"]))
+        else:
+            ids.add(it["identifier"])
+        if it.get("type") not in CATALOG_TYPES:
+            w.append("%s.type %r is not one of %s" % (p, it.get("type"), sorted(CATALOG_TYPES)))
+        if not _https(it.get("url")):
+            e.append(p + ".url: required, https URL")
+    return e, w
+
+
+def validate(doc: Any, kind: str = "auto") -> Tuple[List[str], List[str]]:
+    if kind == "auto":
+        kind = detect_type(doc)
+    return {"agent-card": validate_agent_card, "server-card": validate_server_card,
+            "catalog": validate_catalog}[kind](doc)
+
+
+def main(argv: List[str] = None) -> int:
+    ap = argparse.ArgumentParser(description=__doc__.split("\n")[0])
+    ap.add_argument("file")
+    ap.add_argument("--type", choices=["auto", "agent-card", "server-card", "catalog"], default="auto")
+    ap.add_argument("--strict", action="store_true", help="treat warnings as errors")
+    a = ap.parse_args(argv)
+    try:
+        doc = load(a.file)
+    except (OSError, ValueError) as ex:
+        print("ERROR cannot read %s: %s" % (a.file, ex))
+        return 1
+    errors, warnings = validate(doc, a.type)
+    for m in errors:
+        print("ERROR  " + m)
+    for m in warnings:
+        print("WARN   " + m)
+    if errors or (a.strict and warnings):
+        print("INVALID: %d error(s), %d warning(s)" % (len(errors), len(warnings)))
+        return 1
+    print("OK: %s (%d warning(s))" % (a.file, len(warnings)))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

agent_card_starter-0.2.0.dist-info/METADATA

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: agent-card-starter
+Version: 0.2.0
+Summary: Make a small business readable for AI assistants: write and check an A2A agent card or MCP server card. Standard library only.
+Author-email: flowboxx <kontakt@flowboxx.de>
+License: MIT
+Project-URL: Homepage, https://flowboxx.de/
+Project-URL: Source, https://github.com/flowboxx/agent-card-starter
+Project-URL: Issues, https://github.com/flowboxx/agent-card-starter/issues
+Keywords: a2a,agent-card,mcp,mcp-server-card,well-known,small-business
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# agent-card-starter
+
+[![tests](../../actions/workflows/ci.yml/badge.svg)](../../actions/workflows/ci.yml)
+![license MIT](https://img.shields.io/badge/license-MIT-blue)
+![python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue)
+
+**In 60 seconds:** AI assistants read a small JSON file to learn what your business does. This tool writes that file for you and checks it. Offline, no account, no dependencies.
+
+```bash
+pip install git+https://github.com/flowboxx/agent-card-starter
+agent-card init --name "Muster Roofing Ltd" --description "Roofer in Musterstadt, repairs and new roofs." --website https://www.example.com --skill "Flat roof sealing"
+agent-card validate .well-known/agent-card.json --strict
+```
+
+Upload the file to `https://<your-domain>/.well-known/agent-card.json` and you are readable. Nothing here guarantees that an assistant will mention you.
+
+**In 60 Sekunden:** KI-Assistenten lesen eine kleine Datei, um zu erfahren, was Ihr Betrieb macht. Dieses Werkzeug schreibt die Datei und prüft sie. Ohne Netz, ohne Konto, ohne Fremdpakete. Befehle siehe oben, die Datei kommt nach `https://<Ihre-Domain>/.well-known/agent-card.json`.
+
+<!-- Picture idea: a 20 second terminal recording (init, then validate with OK) of the three commands above. Fictional business only. -->
+
+Starter kit to make a small business readable and reachable for AI assistants:
+an A2A agent card, an MCP server card, a minimal MCP example server and a validator.
+Standard library only, Python 3.9+, MIT licensed.
+
+Starter-Set, damit ein kleiner Betrieb für KI-Assistenten lesbar und erreichbar wird:
+Agentenkarte (A2A), Server-Karte (MCP), ein minimaler MCP-Beispielserver und ein Prüfskript.
+Nur Python-Standardbibliothek, ab Python 3.9, MIT-Lizenz.
+
+Maintained by [flowboxx](https://flowboxx.de/?ref=github), an agency that builds AI doors for businesses.
+Gepflegt von [flowboxx](https://flowboxx.de/?ref=github), einer Agentur, die KI-Türen für Betriebe baut.
+
+---
+
+## English
+
+### What is in here
+
+| Path | What it is |
+| --- | --- |
+| `examples/well-known/agent-card.json` | A2A agent card for a fictional "Beispiel Dachdecker GmbH" |
+| `examples/well-known/agent.json` | Byte-identical copy for older readers |
+| `examples/agent-card.annotated.jsonc` | Same card with comments (documentation only) |
+| `examples/mcp-server-card.json` | MCP server card for the same business |
+| `templates/` | Blank-ish templates: server card and AI catalog |
+| `server/mcp_server.py` | MCP example server over stdio: tools `leistungen` and `anfrage_anlegen` (stub) |
+| `agent_card/` | The `agent-card` command: `init` writes a first card, `validate` checks card, server card and catalog (offline) |
+| `tools/validate_agent_card.py` | Same validator as a plain script |
+| `tests/` | pytest suite |
+
+### Quick start
+
+```bash
+agent-card init --name "Your Business" --description "What you do and where." --website https://www.example.com
+agent-card validate .well-known/agent-card.json --strict
+# from a clone, without installing:
+python3 tools/validate_agent_card.py examples/well-known/agent-card.json
+python3 tools/validate_agent_card.py examples/mcp-server-card.json --strict
+printf '{"jsonrpc":"2.0","id":1,"method":"tools/list"}\n' | python3 server/mcp_server.py
+python3 -m pip install pytest && python3 -m pytest -q
+docker build -t agent-card-starter . && docker run -i --rm agent-card-starter   # MCP over stdio
+```
+
+### Use it for your business
+
+1. Copy `examples/well-known/agent-card.json`, replace name, description, provider, skills.
+2. List only services you really offer. One skill per service, stable ids.
+3. Keep prices, phone numbers and promises out of the card. A human answers those.
+4. Run the validator, publish the file at `https://<your-domain>/.well-known/agent-card.json`.
+5. Point `supportedInterfaces` at an endpoint you really operate. The example server
+   speaks MCP over stdio for learning. A public endpoint needs HTTP transport,
+   rate limiting, spam protection and a privacy notice. `anfrage_anlegen` is a stub on purpose.
+
+### Notes on the standards
+
+- The agent card follows the A2A v1.0 field names (`supportedInterfaces`, `skills`, `provider`).
+- The server card follows the MCP Server Card proposal (SEP-2127). It is an extension and
+  the schema may still change. Check the current schema before you publish.
+- The validator checks required fields and a few sanity rules. It is not a full JSON Schema validation.
+- Nothing here guarantees that an assistant will mention or recommend you.
+
+---
+
+## Deutsch
+
+### Was drin ist
+
+| Pfad | Inhalt |
+| --- | --- |
+| `examples/well-known/agent-card.json` | A2A-Agentenkarte für die fiktive "Beispiel Dachdecker GmbH" |
+| `examples/well-known/agent.json` | Byte-gleiche Kopie für ältere Leser |
+| `examples/agent-card.annotated.jsonc` | Dieselbe Karte mit Kommentaren (nur zur Erklärung) |
+| `examples/mcp-server-card.json` | MCP-Server-Karte für denselben Betrieb |
+| `templates/` | Vorlagen: Server-Karte und KI-Katalog |
+| `server/mcp_server.py` | MCP-Beispielserver über stdio: Werkzeuge `leistungen` und `anfrage_anlegen` (Stub) |
+| `agent_card/` | Der Befehl `agent-card`: `init` schreibt eine erste Karte, `validate` prüft Karte, Server-Karte und Katalog (ohne Netz) |
+| `tools/validate_agent_card.py` | Dasselbe Prüfskript als einfache Datei |
+| `tests/` | pytest-Tests |
+
+### Schnellstart
+
+```bash
+agent-card init --name "Ihr Betrieb" --description "Was Sie tun und wo." --website https://www.example.com
+agent-card validate .well-known/agent-card.json --strict
+# aus einem Klon, ohne Installation:
+python3 tools/validate_agent_card.py examples/well-known/agent-card.json
+python3 tools/validate_agent_card.py examples/mcp-server-card.json --strict
+printf '{"jsonrpc":"2.0","id":1,"method":"tools/list"}\n' | python3 server/mcp_server.py
+python3 -m pip install pytest && python3 -m pytest -q
+docker build -t agent-card-starter . && docker run -i --rm agent-card-starter   # MCP over stdio
+```
+
+### Für den eigenen Betrieb nutzen
+
+1. `examples/well-known/agent-card.json` kopieren, Name, Beschreibung, Anbieter und Fähigkeiten ersetzen.
+2. Nur Leistungen eintragen, die Sie wirklich anbieten. Eine Fähigkeit je Leistung, stabile Ids.
+3. Keine Preise, Telefonnummern oder Zusagen in die Karte. Das beantwortet ein Mensch.
+4. Prüfskript laufen lassen, Datei unter `https://<Ihre-Domain>/.well-known/agent-card.json` ablegen.
+5. `supportedInterfaces` auf einen Endpunkt zeigen lassen, den Sie wirklich betreiben. Der Beispielserver
+   spricht MCP über stdio zum Lernen. Ein öffentlicher Endpunkt braucht HTTP, Mengenbegrenzung,
+   Spam-Schutz und einen Datenschutzhinweis. `anfrage_anlegen` ist absichtlich ein Stub und speichert nichts.
+
+### Hinweise zu den Standards
+
+- Die Agentenkarte folgt den Feldnamen von A2A v1.0 (`supportedInterfaces`, `skills`, `provider`).
+- Die Server-Karte folgt dem MCP-Vorschlag Server Card (SEP-2127). Das ist eine Erweiterung,
+  das Schema kann sich noch ändern. Vor dem Veröffentlichen das aktuelle Schema prüfen.
+- Das Prüfskript prüft Pflichtfelder und einige Plausibilitäten, keine vollständige JSON-Schema-Validierung.
+- Nichts hier garantiert, dass ein Assistent Sie nennt oder empfiehlt.
+
+---
+
+## Built with this? Tell us / Damit gebaut? Erzählen Sie es uns
+
+If you published a card with this kit, show it in [Discussions, Show and tell](../../discussions/categories/show-and-tell). We read every one. If you like, add the badge to your README:
+
+Wenn Sie mit diesem Kit eine Karte veröffentlicht haben, zeigen Sie sie unter [Discussions, Show and tell](../../discussions/categories/show-and-tell). Das Abzeichen für Ihre README:
+
+```markdown
+[![built with agent-card-starter](https://img.shields.io/badge/built%20with-agent--card--starter-2b6cb0)](https://github.com/flowboxx/agent-card-starter)
+```
+
+---
+
+## As is / Ohne Gewähr
+
+This is a starting point, provided "as is" under the MIT license, without warranty of any kind. Standards around agent cards and server cards are young and change. Check the current specifications before you publish. Nothing here is legal advice, and nothing guarantees that an assistant will mention or recommend your business. Changes are listed in [CHANGELOG.md](CHANGELOG.md), how to help is in [CONTRIBUTING.md](CONTRIBUTING.md).
+
+Dies ist ein Ausgangspunkt, bereitgestellt "wie besehen" unter der MIT-Lizenz, ohne Gewähr. Die Standards rund um Agentenkarten und Server-Karten sind jung und ändern sich. Prüfen Sie vor dem Veröffentlichen die aktuellen Spezifikationen. Nichts hier ist Rechtsberatung, und nichts garantiert, dass ein Assistent Ihren Betrieb nennt oder empfiehlt. Änderungen stehen in [CHANGELOG.md](CHANGELOG.md), Mitmachen steht in [CONTRIBUTING.md](CONTRIBUTING.md).
+
+MIT License, see `LICENSE`. Questions and contributions welcome via issues. Fragen und Beiträge gern als Issue.
+
+Built and maintained by [flowboxx](https://flowboxx.de/?ref=github), Germany.

agent_card_starter-0.2.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+agent_card/__init__.py,sha256=ORgqAZYtC0VgENTUF4RUU3tQYnzKNCmLdc1Yg4RhFAw,121
+agent_card/__main__.py,sha256=luiLj9IADr6Ex8TNsHdq3fmYeFmmxWGwgmFMGOyl2GE,62
+agent_card/cli.py,sha256=JTk0klqEpDaNc9dG3sFAUTr340wqub_0E5DUOvdx4_g,4654
+agent_card/validator.py,sha256=3Yf6Fq59GXaxkIDc8MDsc9dkEuyGX88Z8GEdrHf_oc0,10356
+agent_card/data/agent-card.template.json,sha256=ck1-mmmWLFlbuQZIr66EacYiiKEaCyt8v7t7FZihsPE,769
+agent_card_starter-0.2.0.dist-info/licenses/LICENSE,sha256=va0C7WxTZdn3cANATOM4RIwhYveIH0Unpv_aipbV2Ks,1065
+agent_card_starter-0.2.0.dist-info/METADATA,sha256=agnyX4WbawiNEX6b0bK-6XeWGo_rgtq2ZabFfbro-lo,9765
+agent_card_starter-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+agent_card_starter-0.2.0.dist-info/entry_points.txt,sha256=JIGFWzWnUt83no3m7YcJVX5M03lH7-6gNL9HTqzv-ck,51
+agent_card_starter-0.2.0.dist-info/top_level.txt,sha256=pcy9JqHeVQ6Nx0FZHU-_VFeIRyL1Gf8g_z1cTEP0cj8,11
+agent_card_starter-0.2.0.dist-info/RECORD,,

agent_card_starter-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

agent_card_starter-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agent-card = agent_card.cli:main

agent_card_starter-0.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 flowboxx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agent_card_starter-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+agent_card