Für Entwickler

Was ein Client über den Server wissen muss und wie Sie ihn ohne zwischengeschalteten Assistenten aufrufen.

Das Protokoll, wie wir es bereitstellen

• Streamable HTTP unter https://api.publicwww.com/mcp: eine JSON-RPC-Nachricht pro POST (ein Batch wird ebenfalls akzeptiert), Antworten sind schlichtes application/json. Keine Server-Sent Events, keine Sitzungen - jede Anfrage trägt ihr Token. GET ergibt 405.
• Beide Generationen des Protokolls werden unter derselben URL bedient: die Revisionen mit dem initialize-Handshake (2024-11-05 bis 2025-11-25) und 2026-07-28 mit server/discover, bei der Version und Client-Fähigkeiten in params._meta jeder Anfrage übertragen werden und Mcp-Method / Mcp-Name mit dem Body übereinstimmen müssen.
• Kein Token oder ein gelöschtes Token ergibt bei jeder Anfrage 401, mit einem WWW-Authenticate-Header, der die Metadaten der geschützten Ressource (RFC 9728) nennt, über die ein OAuth-Client den Autorisierungsserver findet. Der Ablauf steht unter OAuth 2.1 für Anwendungen.
• Tools: search und account, beschrieben unter Tools. Keine Ressourcen, keine Prompts, und die Liste ändert sich zwischen Aufrufen nicht.
• Ohne Token beschreibt die Server Card den Server: Name, Adresse, Protokollversionen und Links. Sie ist in https://publicwww.com/.well-known/ai-catalog.json aufgeführt. Die Tool-Liste ist nicht Teil der Card; sie kommt über tools/list, sobald der Client ein Token hat.

Aufruf mit curl

Der Server speichert zwischen Aufrufen keinen Zustand, daher lässt sich ein Tool direkt aufrufen, ohne Handshake:

curl https://api.publicwww.com/mcp \
     -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
          "params":{"name":"search","arguments":{"query":"\"angular.min.js\"","rows":3}}}'

Die Liste der Tools mit ihren Eingabeschemata:

curl https://api.publicwww.com/mcp \
     -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Diese Aufrufe und eine Kontoprüfung als ein Skript: mcp-curl.sh.

Für ein Skript, das nur Suchergebnisse braucht, ist die REST-API der einfachere Weg: dieselbe Suche und dasselbe Token, dazu CSV, NDJSON und die anderen Formate.