meppo für KI-Agenten

Integrationswege

• OpenAPI
  ChatGPT Custom GPT

  OpenAPI-Spec als Action importieren → Live-Termine in ChatGPT

• OpenAPI
  Microsoft Copilot Plugin

  Declarative Agent mit API Plugin auf Basis der OpenAPI-Spec

• MCP
  Claude / Cursor / Windsurf (MCP)

  MCP Server via npx — Tools: search_doctor_appointments, list_medical_specialties

• A2A
  Agent-Discovery (A2A)

  Google A2A Agent Card für automatische Agenten-Discovery

• llms.txt
  llms.txt

  Maschinenlesbare Kurzfassung für alle LLMs

Authentifizierung

Alle Endpunkte erfordern einen Bearer Token im Authorization Header. API-Zugänge sind kostenlos für registrierte Partner.

API-Key anfordern: api@meppo.de

Beispiel: Hausarzt in Berlin

Request

curl -X POST https://www.meppo.de/api/v1/llm/search \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{"specialty": "Hausarzt", "location": "Berlin", "max_results": 5}'

Response (gekürzt)

{
  "query": {
    "specialty": "Hausarzt",
    "resolved_city": "Berlin",
    "radius_km": 25
  },
  "results": [
    {
      "name": "Dr. med. Lisa Weber",
      "specialty": "Hausarzt",
      "address": "Musterstraße 12, 10115 Berlin",
      "next_available": "Heute",
      "available_slots": 3,
      "booking_url": "https://www.meppo.de/r/abc123",
      "provider": "doctolib",
      "appointments": [
        { "date": "Heute", "time": "14:30" },
        { "date": "Morgen", "time": "09:00" }
      ]
    }
  ],
  "meta": {
    "total_found": 12,
    "providers_searched": ["doctolib", "jameda", "samedi"],
    "search_time_ms": 1840
  }
}

MCP Server (Claude / Cursor)

Füge den meppo MCP Server in deine KI-IDE oder Claude Desktop ein:

# ~/.cursor/mcp.json  (oder Claude Desktop / Windsurf)
{
  "mcpServers": {
    "meppo": {
      "command": "npx",
      "args": ["-y", "@meppo/mcp-server"],
      "env": {
        "MEPPO_LLM_API_KEY": "<your-api-key>"
      }
    }
  }
}

Verfügbare Tools: search_doctor_appointments · list_medical_specialties · check_service_status

Maschinenlesbare Assets

• OpenAPI 3.1 Spec/api/v1/llm/openapi.yaml
• llms.txt (Kurzfassung)/llms.txt
• llms-full.txt (vollständig)/llms-full.txt
• A2A Agent Card/.well-known/agent.json