Badge ed embed
Metti qualsiasi server MCP elencato in un README o su un sito con un badge, una scheda con la configurazione in un clic o un iframe, oppure leggi la sua scheda in JSON. Ogni embed rimanda alla pagina del server su mcp.tc e usa l’URL del server stesso.
Badge per il README
Una piccola immagine con il simbolo di mcp.tc e il nome del server, più la spunta quando la scheda è verificata. Racchiudila in un link alla scheda:
[](https://mcp.tc/i/deepwiki)<a href="https://mcp.tc/i/deepwiki"><img src="https://mcp.tc/i/deepwiki/badge.svg" alt="DeepWiki on mcp.tc" height="20"></a>
?theme=auto(il valore predefinito) segue la modalità chiara o scura di chi legge;?theme=lighte?theme=darkla fissano.?style=compactmostra il simbolo senza la scritta «mcp.tc» (seconda riga qui sopra).
È un semplice SVG sotto i 2 KB senza nient’altro da caricare, quindi funziona nei README di GitHub e ovunque funzionino le immagini. Badge, schede e iframe sono in inglese, qualunque sia la lingua della pagina che li ospita.
Scheda per il tuo sito
Incolla un solo tag dove deve comparire la scheda:
<script src="https://mcp.tc/w/deepwiki.js" async></script>Oppure metti un segnaposto dove preferisci e carica lo script una sola volta, in qualsiasi punto della pagina. Ogni segnaposto di quel server riceve una scheda. Ciò che metti dentro un segnaposto resta visibile finché la scheda non lo sostituisce, e rimane per chi visita senza JavaScript:
<div data-mcptc="deepwiki"><a href="https://mcp.tc/i/deepwiki">DeepWiki on mcp.tc</a></div>
<script src="https://mcp.tc/w/deepwiki.js" async></script>data-theme:auto(il valore predefinito, segue la modalità chiara o scura di chi visita),lightodark.data-size:full(il valore predefinito, con la descrizione breve) ocompact.- La scheda è larga al massimo 520 px (420 px in versione compatta) e si adatta agli spazi più stretti. Imposta la variabile CSS
--mcptc-max-widthsul segnaposto o su un elemento padre per cambiarla.
Mostra icona, nome e spunta, cosa serve al server (accesso, chiave, installazione locale), l’URL del server o il comando di installazione con un pulsante Copia, pulsanti «Add to» in un clic per Claude Code, Cursor, VS Code e claude.ai (per i client che possono usarlo) e un link alla scheda.
Cosa fa sulla tua pagina
- Ogni file contiene tutto: i dati della scheda, gli stili e l’icona. Non fa altre richieste e non imposta cookie né local storage, quindi non c’è nulla con cui tracciare chi visita.
- Si disegna dentro una shadow root chiusa: i tuoi stili non la raggiungono e i suoi non raggiungono la tua pagina.
- Scrive il testo solo come testo (mai come HTML) e rimanda solo a mcp.tc e alle pagine di installazione dei client, in HTTPS.
- Con una Content Security Policy, consenti
script-src https://mcp.tc. L’icona è un’immaginedata:; se la tua policy le blocca, la scheda mostra invece l’iniziale del nome. - Per uno slug non in elenco non compare nulla e la console del browser mostra un avviso.
iframe
Per le pagine che non consentono script, come i site builder e i wiki, la scheda compatta esiste anche come pagina a sé:
<iframe src="https://mcp.tc/embed/deepwiki" title="DeepWiki on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>- È alta 200 px a qualsiasi larghezza a partire da 320 px. Nomi e URL lunghi terminano con i puntini di sospensione, e i pulsanti «Add to» scorrono di lato quando non ci stanno.
?theme=lighto?theme=darkfissa i colori; senza, la scheda segue la modalità di chi visita.allow="clipboard-write"fa funzionare i suoi pulsanti Copia. È l’unica pagina di mcp.tc che altri siti possono incorniciare, e i motori di ricerca non la indicizzano.
I dati della scheda in JSON
Ogni scheda è disponibile anche in JSON, per le tue pagine e i tuoi strumenti:
https://mcp.tc/i/deepwiki.jsonQualsiasi sito può leggerla: la risposta include Access-Control-Allow-Origin: *. È in sola lettura e non richiede chiavi. Uno slug non in elenco riceve 404 e una scheda rimossa 410, con error impostato a not_found o gone. I campi senza valore sono null, mai omessi. Il testo è quello originale inglese della scheda.
| Campo | Tipo | Cos’è |
|---|---|---|
slug | stringa | Lo slug attuale della scheda. I vecchi slug e gli alias restituiscono la scheda attuale, quindi leggilo da qui. |
name | stringa | Nome del server. |
vendor | stringa o null | Chi realizza il server. |
tagline | stringa o null | Una riga, fino a 200 caratteri. |
description | stringa o null | Testo semplice, paragrafi separati da una riga vuota, fino a 2.000 caratteri. L’ha scritto un modello di AI dai metadati pubblici del server. |
link | stringa | La pagina della scheda, https://mcp.tc/i/{slug}. |
categorycategory_name | stringa o null | Slug della categoria (come in /c/{slug}) e il suo nome. |
kind | stringa | remote (ti colleghi via HTTPS) o local (gira sul tuo computer). |
transport | stringa | streamable-http, sse o stdio. |
auth | stringa | none, oauth, api_key, optional o unknown. |
access | oggetto | Come lo etichetta mcp.tc: group (ok, auth o local, il filtro Accesso dell’elenco), label (testo del badge, come «No sign-in»), text (forma estesa) e note (una frase). |
endpoint | stringa o null | L’URL del server stesso (server remoti). È quello a cui si collega un client. |
install_command | stringa o null | Il comando che avvia un server locale, come npx -y @playwright/mcp. |
package | oggetto o null | registry (npm, pypi, oci, nuget…) e identifier. |
relay | booleano | False per ogni scheda: il link di mcp.tc è una pagina, e i client si collegano all’URL del server stesso. Il campo resta perché chi già lo legge continui a funzionare. |
verifiedverified_by | booleano, stringa o null | La spunta, e cosa significa per questa scheda. |
icon | stringa o null | URL dell’icona 128 × 128 della scheda su mcp.tc. |
tools_counttools | numero, array | I tool letti dal server (fino a 150): name, summary e read_only / destructive (true, false, o null quando il server non lo dice). |
add | array | Le azioni in un clic: client (claude-code, cursor, vscode, claude-ai), label, kind e value: un comando da copiare per copy, un link di installazione per link. Usano sempre l’URL o il pacchetto del server stesso. |
homepagerepositorydocs | stringa o null | Link della scheda. |
health | stringa | Il nostro ultimo controllo: ok, auth (ha risposto e ha chiesto un accesso), down o unknown (i server locali non vengono controllati). |
last_checkedlistedupdated | stringa o null | Orari ISO 8601 in UTC: l’ultimo controllo, l’inserimento in elenco, l’ultima modifica del contenuto. |
embeds | oggetto | Gli URL di badge, widget, iframe e markdown di questa scheda. |
format | stringa | Un link a questa pagina. |
L’elenco nel suo insieme ha i suoi formati: l’indice di ricerca, l’API compatibile con il registro MCP e la lista llms.txt. Aggiungi .md al link di una scheda per il Markdown.
Cache e privacy
- La scheda e l’iframe contengono pulsanti di installazione, quindi si aggiornano in fretta. La nostra CDN (Cloudflare) conserva lo script della scheda per 15 minuti e i browser fino a 4 ore. L’iframe e il JSON arrivano da mcp.tc a ogni richiesta, e i browser li conservano per 10 minuti.
- Il badge mostra solo un nome. Cloudflare lo conserva per un giorno e i browser fino a 4 ore; mentre Cloudflare aggiorna una copia, può servire quella vecchia fino a una settimana.
- Gli embed non impostano cookie, e le richieste non vengono scritte nel nostro log di accesso. L’informativa sulla privacy ha i dettagli.
- Puoi usarli per qualsiasi server in elenco, su qualsiasi sito, gratis. Il badge dice che un server è elencato su mcp.tc, e la spunta dice chi lo gestisce. Nessuno dei due è un controllo di sicurezza.