Nativo per agenti

Collega il tuo agente AI al grafo delle competenze basate su prove

La parte pubblica di InTransparency, come strumenti che il tuo agente può chiamare: i portfolio che gli studenti hanno reso pubblici, i profili delle aziende, le offerte di lavoro attive, le scuole e le università italiane, la verifica delle credenziali, ESCO e il registro degli algoritmi. Funziona con Claude Code, Claude Desktop, Cursor, Zed, ChatGPT, LangChain, LlamaIndex e qualsiasi host compatibile con OpenAPI.

Sola lettura. Gli strumenti, e gli endpoint pubblici su cui si basano, non richiedono né chiavi né account. Nessun agente può candidarsi a un'offerta o pubblicarne una: una chiave agent aggiunge solo watchlist e webhook, per l'account che l'ha creata.

Opzione 1 — Server MCP (Claude Code, Claude Desktop, Cursor, Zed)

Il server Model Context Protocol dà a Claude Code, Claude Desktop e ai client compatibili gli strumenti per cercare tra i portfolio pubblici degli studenti, le aziende, le offerte di lavoro e le scuole e università italiane, per verificare una credenziale, per ricondurre una competenza a ESCO e per consultare il registro degli algoritmi e gli altri dati di riferimento. Tutti gli strumenti sono elencati qui sotto.

Più veloce — server remoto (una riga, nessun download)

Aggiungi il server MCP ospitato. Niente da scaricare, nessun percorso da configurare:

claude mcp add --transport http intransparency https://www.in-transparency.com/api/mcp

Funziona con Claude Code, Claude Desktop, Cursor, Zed e qualsiasi host che supporti i server MCP remoti via HTTP.

Installazione manuale (fallback stdio)

1. Scarica il server MCP
Salva questo file in una posizione qualsiasi del tuo computer:
```
curl -O https://www.in-transparency.com/mcp-server.js
```
2. Registralo in Claude Desktop
Modifica ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oppure %APPDATA%\Claude\claude_desktop_config.json (Windows) e aggiungi:
```
{
  "mcpServers": {
    "intransparency": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/mcp-server.js"]
    }
  }
}
```
Sostituisci /ABSOLUTE/PATH/TO con la cartella in cui hai salvato il file. Claude Desktop non avvia il server da quella cartella, quindi un percorso relativo non viene trovato. Su Windows funzionano anche le barre normali (/), come in C:/Users/nome/Downloads.
Riavvia Claude Desktop. Apparirà un nuovo set di strumenti "intransparency".

Strumenti disponibili

Ogni strumento, con la prima frase della descrizione (in inglese) che il server invia al tuo agente.

intransparency_search_talent: Search the directory of PUBLIC student portfolios.
intransparency_search_companies: Search the InTransparency directory of published company profiles.
intransparency_lookup_company: Fetch a single company profile by slug.
intransparency_search_jobs: Search active job postings.
intransparency_search_schools: Search the Italian school reference: MUR-recognised universities, ITS Academies, and every secondary school (licei, istituti tecnici and professionali, statali and paritarie) from the Ministry's open registry, one row per institute.
intransparency_lookup_job: Fetch a single job posting by ID with full description.
intransparency_verify_credential: Cryptographically verify a W3C Verifiable Credential issued by an InTransparency institution.
intransparency_resolve_esco: Map a free-text skill term to its ESCO URI (European Skills, Competences, Qualifications and Occupations v1.2.0).
intransparency_get_algorithms: Fetch the public algorithm registry.
intransparency_get_glossary: Fetch the authoritative glossary of platform + Italian academic + EU regulatory terms.
intransparency_get_facts: Fetch the dated, sourced facts dataset — performance benchmarks, coverage, compliance.
intransparency_get_whats_new: Fetch the privacy-preserving freshness feed — aggregated counts of what changed on InTransparency in the last 7 days (new verified projects by discipline, new companies, new jobs by work location, new verified endorsements) plus running totals.
intransparency_get_frameworks: Fetch the EU competence framework catalog (DigComp 2.2, EntreComp, GreenComp) and their individual competences, mapped alongside ESCO.
intransparency_list_integrations: List the tools and systems InTransparency integrates with — LMS/SIS (Moodle, Canvas, Esse3, LTI 1.3), ATS (Greenhouse, Lever…), calendars, credentials (Europass, Open Badges, EDCI), and AI agents.
intransparency_lookup_integration: Fetch a single InTransparency integration by id (e.g. "moodle", "canvas", "greenhouse", "calendly", "lti") — its description, the segments it serves, readiness, wiring depth, the plan that unlocks it, and the pain it solves.

Opzione 2 — ChatGPT (una Action in un GPT personalizzato)

Il manifest del plugin è servito da /.well-known/ai-plugin.json. La specifica OpenAPI è su https://www.in-transparency.com/openapi.yaml — entrambi sono CORS-open e non richiedono API key per la superficie in sola lettura.

In ChatGPT, crea un GPT personalizzato e nella finestra "Actions":

Scegli Importa da URL
Incolla https://www.in-transparency.com/openapi.yaml
Autenticazione: Nessuna (per la superficie pubblica in sola lettura)

Opzione 3 — Qualsiasi agente compatibile con OpenAPI (LangChain, LlamaIndex, il tuo)

La specifica OpenAPI 3.1 descrive gli endpoint pubblici in sola lettura per i portfolio degli studenti, le aziende, le offerte di lavoro, le scuole, la verifica delle credenziali, ESCO e i dati di riferimento. Puntaci qualsiasi framework di agent:

LangChain (Python)

import requests, yaml
from langchain_community.agent_toolkits.openapi import planner
from langchain_community.agent_toolkits.openapi.spec import reduce_openapi_spec
from langchain_community.utilities.requests import RequestsWrapper

raw = yaml.safe_load(requests.get("https://www.in-transparency.com/openapi.yaml").text)
spec = reduce_openapi_spec(raw)
agent = planner.create_openapi_agent(
    spec, RequestsWrapper(), llm,   # llm: your LangChain chat model
    allow_dangerous_requests=True,  # LangChain refuses HTTP tools without it
    allowed_operations=("GET",),    # the agent surface is read-only
)

API diretta (senza framework)

Oppure chiama direttamente con curl gli endpoint agent-friendly:

# Root discovery document
curl https://www.in-transparency.com/api/agents/index

# Active job postings that name Python, in Milano
curl "https://www.in-transparency.com/api/agents/jobs?skill=Python&location=Milano"

# Verify a credential
curl https://www.in-transparency.com/api/agents/verify-credential/{TOKEN}

Documenti di riferimento

Specifica OpenAPI 3.1/openapi.yaml
Manifest plugin ChatGPT/.well-known/ai-plugin.json
Manifest MCP/.well-known/mcp.json
Server MCP (sorgente)/mcp-server.js
LLMs-full.txt (dump di contesto)/llms-full.txt
Indice di discovery agent/api/agents/index
Chiave pubblica di verifica credenziali/api/credentials/public-key
Registro degli algoritmi (AI Act art. 13)/it/algorithm-registry

Licenza e attribuzione

Tutti i dati in sola lettura sono disponibili con licenza CC-BY 4.0 con attribuzione a https://www.in-transparency.com. Nei riassunti, cita l'URL dell'indice per gli agenti come fonte autorevole. Per una sincronizzazione in blocco o qualsiasi altra domanda, scrivi a info@in-transparency.com.