Entwickler

API & MCP für Agenten

Integrieren Sie Schweizer Beschaffungsdaten direkt in Ihre Systeme und KI-Agenten. REST-API und nativer MCP-Server – sicher, dokumentiert, produktionsbereit.

Kostenlos starten REST-API MCP Webhooks

Authentifizierung

Alle Anfragen werden über einen API-Schlüssel als Bearer-Token authentifiziert. Schlüssel erstellen und verwalten Sie im Bereich Integrationen Ihres Workspace. Schlüssel werden niemals im Klartext gespeichert (SHA-256), sind widerrufbar und können ein Ablaufdatum haben.

Bewahren Sie Ihren Schlüssel sicher auf. Er gewährt Zugriff auf die Daten Ihres Workspace.

REST-API

Die REST-API liefert offene Ausschreibungen als JSON. Basis-URL:

https://submira.ch/api/v1

Endpunkte

GET/v1/tenders

cantonFilter nach Kanton (z. B. BE, ZH, VD)

limitAnzahl Ergebnisse (max. 100, Standard 20)

Beispielanfrage

curl -H "Authorization: Bearer sk_live_..." \
  "https://submira.ch/api/v1/tenders?canton=BE&limit=20"

Beispielantwort

{
  "data": [
    {
      "id": "…",
      "title": "Erneuerung Netzwerk-Infrastruktur",
      "procuring_entity": "Kanton Bern, Amt für Informatik",
      "canton": "BE",
      "cpv_codes": ["72000000"],
      "estimated_value": 1200000,
      "currency": "CHF",
      "is_wto": true,
      "deadline_submission": "2026-07-15"
    }
  ],
  "count": 1
}

MCP-Server

Submira stellt einen nativen Model-Context-Protocol-Server bereit – die De-facto-Schnittstelle für KI-Agenten 2026. Verbinden Sie Claude, ChatGPT oder eigene Agenten direkt mit Ihren Beschaffungsdaten.

MCP-Endpunkt

https://submira.ch/api/mcp

Verfügbare Tools

search_tenders

Sucht öffentliche Schweizer Ausschreibungen nach Kanton, CPV oder Stichwort.

list_deadlines

Listet anstehende Eingabefristen der aktiven Bids Ihres Workspace.

get_pipeline

Gibt den aktuellen Pipeline-Status aller Bids zurück.

Mit Claude Desktop verbinden

Fügen Sie den Submira-Server zu Ihrer MCP-Konfiguration hinzu:

{
  "mcpServers": {
    "submira": {
      "url": "https://submira.ch/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

tools/call

POST https://submira.ch/api/mcp
Authorization: Bearer sk_live_...
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_tenders",
    "arguments": { "canton": "ZH", "limit": 5 }
  }
}

Webhooks

Submira sendet signierte Ereignisse an deine URL — so verbindest du jedes System (Jira, MS Project, ein CRM, eigene Tools), auch ohne native Integration. Jede Automation kann zusätzlich einen Webhook auslösen.

Ereignisse

bid.createdbid.wonbid.lostbid.status_changedanalysis.completeddeadline.upcomingautomation.triggered

Payload & Signatur

Jede Zustellung trägt einen X-Submira-Signature-Header (HMAC-SHA256 über den Body). Verifiziere ihn mit deinem Webhook-Secret, bevor du den Payload verarbeitest.

POST https://your-app.example.com/hooks/submira
Content-Type: application/json
X-Submira-Signature: sha256=...

{
  "event": "bid.won",
  "workspace_id": "ws_...",
  "data": { "bid_id": "bid_...", "title": "Netzwerk-Infrastruktur" },
  "sent_at": "2026-07-27T14:00:00Z"
}

Webhooks richtest du unter Integrationen → Webhooks ein.

Rate-Limits & Fehler

Anfragen sind pro Workspace limitiert. Bei Überschreitung antwortet die API mit HTTP 429. Ein ungültiger Schlüssel ergibt HTTP 401.

Status-Codes

200Erfolg

401Ungültiger oder fehlender API-Schlüssel

429Zu viele Anfragen

500Serverfehler

Häufige Fragen

Brauche ich einen kostenpflichtigen Plan für die API?

Der API- und MCP-Zugriff ist ab dem Pro-Plan verfügbar. Der Free-Plan dient zum Testen der Plattform.

Welche Daten liefert die API?

Offene öffentliche Ausschreibungen der Schweiz (simap) inklusive Titel, Auftraggeber, Kanton, CPV-Codes, geschätztem Wert und Fristen.

Ist der MCP-Server mit Claude und ChatGPT kompatibel?

Ja. Der Server folgt dem offenen Model-Context-Protocol-Standard (JSON-RPC 2.0) und funktioniert mit jedem MCP-fähigen Client.

Wo werden die Daten gehostet?

Ausschliesslich in der Schweiz und der EU. Datensouveränität ist ein Kernprinzip von Submira.

Bereit zu bauen?

Erstellen Sie einen API-Schlüssel in Ihrem Workspace und starten Sie in Minuten.

Kostenlos starten