SubmiraSubmiraKI-Bid-Management

Développeurs

API & MCP pour agents

Intégrez les données de marchés publics suisses directement dans vos systèmes et agents IA. API REST et serveur MCP natif – sécurisé, documenté, prêt pour la production.

Commencer gratuitement REST-APIMCP

Authentification

Toutes les requêtes sont authentifiées via une clé API en tant que jeton Bearer. Créez et gérez les clés dans la section Intégrations de votre espace. Les clés ne sont jamais stockées en clair (SHA-256), sont révocables et peuvent avoir une date d'expiration.

Conservez votre clé en lieu sûr. Elle donne accès aux données de votre espace.

API REST

L'API REST fournit les appels d'offres ouverts au format JSON. URL de base :

https://submira.ch/api/v1

Points de terminaison

GET/v1/tenders
cantonFiltrer par canton (p. ex. BE, ZH, VD)
limitNombre de résultats (max. 100, défaut 20)

Exemple de requête

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

Exemple de réponse

{
  "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
}

Serveur MCP

Submira fournit un serveur Model Context Protocol natif – l'interface de référence pour les agents IA en 2026. Connectez Claude, ChatGPT ou vos propres agents directement à vos données de marchés.

Point de terminaison MCP

https://submira.ch/api/mcp

Outils disponibles

search_tenders

Recherche les appels d'offres publics suisses par canton, CPV ou mot-clé.

list_deadlines

Liste les délais de soumission à venir des offres actives de votre espace.

get_pipeline

Renvoie l'état actuel du pipeline de toutes les offres.

Connexion avec Claude Desktop

Ajoutez le serveur Submira à votre configuration MCP :

{
  "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 }
  }
}

Limites de débit & erreurs

Les requêtes sont limitées par espace. En cas de dépassement, l'API répond avec HTTP 429. Une clé invalide donne HTTP 401.

Codes de statut

200Succès
401Clé API invalide ou manquante
429Trop de requêtes
500Erreur serveur

Questions fréquentes

Ai-je besoin d'un plan payant pour l'API ?

L'accès API et MCP est disponible à partir du plan Pro. Le plan Free permet de tester la plateforme.

Quelles données l'API fournit-elle ?

Les appels d'offres publics ouverts de Suisse (simap) avec titre, adjudicateur, canton, codes CPV, valeur estimée et délais.

Le serveur MCP est-il compatible avec Claude et ChatGPT ?

Oui. Le serveur suit le standard ouvert Model Context Protocol (JSON-RPC 2.0) et fonctionne avec tout client compatible MCP.

Où les données sont-elles hébergées ?

Exclusivement en Suisse et dans l'UE. La souveraineté des données est un principe fondamental de Submira.

Prêt à construire ?

Créez une clé API dans votre espace et démarrez en quelques minutes.

Commencer gratuitement