Agent Integration

Für KI-Agents.

Discovery-Endpoints, A2A Protocol und Public API, alles was ein KI-Agent braucht, um StudioMeyer zu finden und zu nutzen.

Discovery

So finden Agents uns

Zwei standardisierte Endpoints unter dem .well-known Pfad ermöglichen automatische Agent-Discovery.

agents.json

agents.json / Open Standard for Agent Discovery

Tools mit Parametern, Endpoints und Beschreibungen. Ermöglicht Agents, verfügbare Aktionen automatisch zu entdecken.

https://studiomeyer.io/.well-known/agents.json

get_memory_purchasebrowse_portfoliorequest_quoteget_servicesschedule_consultationget_case_studyvalidate_webmcpgenerate_agents_jsonget_api_docs

Live testen

agent-card.json

A2A Protocol 1.0 + 0.3 (Linux Foundation)

8 Skills mit Beispielen, Tags und I/O-Modi. Der Endpunkt führt genau diese aus, in A2A 1.0 und 0.3.

https://studiomeyer.io/.well-known/agent-card.json

chatget-servicesrequest-quoteschedule-consultationbrowse-portfolioget-case-studyvalidate-webmcpgenerate-agents-json

Live testen

StudioMeyer-Ressourcen überprüfen

Unser ARD-Katalog nennt die Herkunft jedes Ressourceneintrags. Signierte Einträge lassen sich mit unserem öffentlichen Schlüssel überprüfen: Die Signatur bindet den Anbieter, die Adresse und die Beschreibung zusammen. Ohne Signatur bestätigt nur HTTPS die Veröffentlichung auf unserer Domain.

Das StudioMeyer-Prüfprofil beschreibt die Domainbindung, JSON-Kanonisierung und ES256-Prüfung. Die Signatur schützt den Katalogeintrag, nicht den später abgerufenen Inhalt einer API oder eine unabhängige Zertifizierung.

ARD-Katalog Prüfprofil JWKS

A2A Protocol

Agent-to-Agent Kommunikation

JSON-RPC 2.0 Endpoint für direkte Agent-Kommunikation, in A2A 1.0 (Header A2A-Version: 1.0) und 0.3 (ohne Header) unter derselben Adresse. Freier Text geht an den Assistenten, strukturierte Skills wählst du über message.metadata.skillId. Mit der zurückgegebenen contextId geht das Gespräch weiter.

POST/api/a2a

Request

curl -X POST https://studiomeyer.io/api/a2a \
  -H "Content-Type: application/json" \
  -H "A2A-Version: 1.0" \
  -d '{
    "jsonrpc": "2.0",
    "method": "SendMessage",
    "id": "req-1",
    "params": {
      "message": {
        "messageId": "msg-1",
        "role": "ROLE_USER",
        "parts": [{ "text": "What services do you offer?" }]
      }
    }
  }'

200application/json

Antwort

{
  "jsonrpc": "2.0",
  "id": "req-1",
  "result": {
    "task": {
      "id": "task_…",
      "contextId": "ctx_…",
      "status": { "state": "TASK_STATE_COMPLETED", "timestamp": "…" },
      "artifacts": [{
        "artifactId": "art_…",
        "name": "answer",
        "parts": [{ "text": "StudioMeyer builds custom-coded websites …" }]
      }],
      "metadata": { "skillId": "chat" }
    }
  }
}

SendMessage

Nachricht senden, Task mit Ergebnis zurück (0.3: message/send)

GetTask

Einen Task erneut abfragen (0.3: tasks/get)

ListTasks

Die Tasks eines Gesprächs, per contextId

CancelTask

Einen wartenden Task abbrechen (0.3: tasks/cancel)

Public API v1

9 Tools für Agents

Diese Lese- und Anfrage-Endpoints sind öffentlich, CORS-offen und rate-limited (60 req/min pro IP) und brauchen keine Anmeldung. Nutzerbezogene Zugänge laufen getrennt davon: die MCP-Server über OAuth 2.1 mit PKCE, das Portal über Login mit Google, GitHub, Discord oder Magic-Link.

Integration

Quick Start Guide

1

Discovery

Agent ruft /.well-known/agents.json ab und entdeckt verfügbare Tools.

2

Capabilities prüfen

Agent liest agent-card.json für Skills, I/O-Modi und A2A-Endpoint.

3

API aufrufen

Agent nutzt die Tools direkt über /api/v1/ oder sendet Tasks via A2A.

4

Ergebnis verarbeiten

Strukturierte JSON-Antworten, kein Scraping, kein Parsing nötig.

Rate Limiting & CORS

Fair Use Richtlinien

Rate Limiting

-60 requests / minute per IP
-X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset Headers
-429 Too Many Requests + Retry-After Header

CORS

-Access-Control-Allow-Origin: *
-Diese Endpoints ohne Anmeldung
-Alle Antworten in JSON

AI-Ready für deine Website?

Wir machen Kunden-Websites fit für KI-Agents. WebMCP, agents.json und A2A, komplett im White-Label.

Jetzt AI-Ready werden