API / MCP

Maschinenlesbare Schnittstelle

Mind / Machine stellt eine offene REST-API bereit, über die KI-Agenten Gäste-Bewerbungen einreichen können. Die Schnittstelle folgt dem Model Context Protocol (MCP) und ist ohne Authentifizierung nutzbar.

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der es KI-Agenten ermöglicht, strukturiert mit Webservices zu interagieren. Statt ein Formular manuell auszufüllen, kann ein KI-Agent direkt die API ansprechen und eine Bewerbung im Namen einer Person einreichen. Diese Seite dient als Einstiegspunkt für Entwickler und KI-Systeme.

POST/api/apply

Reicht eine Gäste-Bewerbung ein. Die Bewerbung wird in der Datenbank gespeichert und die Hosts werden automatisch benachrichtigt.

Request Body (JSON)

Feld	Typ	Pflicht	Beschreibung
name	string	ja	Vollständiger Name (min. 2 Zeichen)
email	string	ja	E-Mail-Adresse für Rückmeldung
topic	string	ja	Thema oder Pitch (min. 10 Zeichen)
bio	string	nein	Kurze Vorstellung der Person

Beispiel

curl -X POST https://mind-machine.at/api/apply \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Maria Muster",
    "email": "[email protected]",
    "topic": "KI im Hotelmarketing – was wirklich funktioniert",
    "bio": "Hotelmanagerin mit 10 Jahren Erfahrung"
  }'

Antwort

// Erfolg
{ "success": true, "id": 42 }

// Fehler (400)
{ "success": false, "error": "topic muss mindestens 10 Zeichen haben" }

GET/api/apply/schema

Gibt eine maschinenlesbare JSON-Beschreibung des Bewerbungsformulars zurück. KI-Agenten können diesen Endpunkt nutzen, um die verfügbaren Felder automatisch zu erkennen.

Schema ansehen →

Für KI-Berater und Entwickler

Diese API ist ein Praxisbeispiel dafür, wie KI-Agenten mit realen Webformularen interagieren können, ohne einen Browser zu benötigen. Sie eignet sich als Demonstrationsobjekt für:

→Agentic Workflows: Ein KI-Agent recherchiert potenzielle Gäste und reicht Bewerbungen automatisch ein
→Tool Use / Function Calling: Der Endpunkt kann direkt als Tool in LLM-Systemen (OpenAI, Claude, Gemini) registriert werden
→MCP-Integration: Kompatibel mit dem Anthropic Model Context Protocol für strukturierte Agent-Web-Interaktion

Fragen zur Integration? Manuela Machner berät Unternehmen und Organisationen beim Einsatz von KI-Agenten. kinet.ai