Sviluppatori

API & MCP per agenti

Integra i dati degli appalti pubblici svizzeri direttamente nei tuoi sistemi e agenti IA. API REST e server MCP nativo – sicuro, documentato, pronto per la produzione.

Inizia gratis REST-API MCP

Autenticazione

Tutte le richieste sono autenticate tramite una chiave API come token Bearer. Crea e gestisci le chiavi nella sezione Integrazioni del tuo spazio. Le chiavi non sono mai memorizzate in chiaro (SHA-256), sono revocabili e possono avere una data di scadenza.

Conserva la tua chiave in modo sicuro. Dà accesso ai dati del tuo spazio.

API REST

L'API REST fornisce gli appalti aperti in formato JSON. URL di base:

https://submira.ch/api/v1

Endpoint

GET/v1/tenders

cantonFiltra per cantone (es. BE, ZH, VD)

limitNumero di risultati (max. 100, predefinito 20)

Esempio di richiesta

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

Esempio di risposta

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

Server MCP

Submira fornisce un server Model Context Protocol nativo – l'interfaccia di riferimento per gli agenti IA nel 2026. Collega Claude, ChatGPT o i tuoi agenti direttamente ai tuoi dati di appalto.

Endpoint MCP

https://submira.ch/api/mcp

Strumenti disponibili

search_tenders

Cerca gli appalti pubblici svizzeri per cantone, CPV o parola chiave.

list_deadlines

Elenca le scadenze di presentazione imminenti delle offerte attive del tuo spazio.

get_pipeline

Restituisce lo stato attuale della pipeline di tutte le offerte.

Connessione con Claude Desktop

Aggiungi il server Submira alla tua configurazione 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 }
  }
}

Limiti di frequenza & errori

Le richieste sono limitate per spazio. In caso di superamento, l'API risponde con HTTP 429. Una chiave non valida restituisce HTTP 401.

Codici di stato

200Successo

401Chiave API non valida o mancante

429Troppe richieste

500Errore del server

Domande frequenti

Ho bisogno di un piano a pagamento per l'API?

L'accesso API e MCP è disponibile a partire dal piano Pro. Il piano Free serve per testare la piattaforma.

Quali dati fornisce l'API?

Gli appalti pubblici aperti della Svizzera (simap) con titolo, committente, cantone, codici CPV, valore stimato e scadenze.

Il server MCP è compatibile con Claude e ChatGPT?

Sì. Il server segue lo standard aperto Model Context Protocol (JSON-RPC 2.0) e funziona con qualsiasi client compatibile MCP.

Dove sono ospitati i dati?

Esclusivamente in Svizzera e nell'UE. La sovranità dei dati è un principio fondamentale di Submira.

Pronto a costruire?

Crea una chiave API nel tuo spazio e inizia in pochi minuti.

Inizia gratis