---
title: "Badges and Embeds | mcp.tc"
description: "Add a badge, a card or an iframe for any MCP server listed on mcp.tc to your README or website, or read its listing as JSON. No cookies, no tracking."
url: "https://mcp.tc/embed"
markdown: "https://mcp.tc/embed.md"
lang: "en"
---

# Badges and Embeds

Show your server where people already look: a README badge, a website card with one-click setup, or an iframe. Free, no cookies, no tracking.

## README badge

A small image with the mcp.tc mark and the server’s name, plus the checkmark when the listing is verified. Wrap it in a link to the listing:

`Markdown`:

```
[![DeepWiki on mcp.tc](https://mcp.tc/i/deepwiki/badge.svg)](https://mcp.tc/i/deepwiki)
```

`HTML`:

```
<a href="https://mcp.tc/i/deepwiki"><img src="https://mcp.tc/i/deepwiki/badge.svg" alt="DeepWiki on mcp.tc" height="20"></a>
```

![Badge preview, light](https://mcp.tc/i/deepwiki/badge.svg?theme=light&v=747f8726)![Badge preview, dark](https://mcp.tc/i/deepwiki/badge.svg?theme=dark&v=747f8726)

![Compact badge preview, light](https://mcp.tc/i/deepwiki/badge.svg?theme=light&style=compact&v=747f8726)![Compact badge preview, dark](https://mcp.tc/i/deepwiki/badge.svg?theme=dark&style=compact&v=747f8726)

- `?theme=auto` (the default) follows the reader’s light or dark mode; `?theme=light` and `?theme=dark` fix it.
- `?style=compact` shows the mark without the word “mcp.tc” (second row above).

It’s a plain SVG under 2 KB with nothing else to load, so it works in GitHub READMEs and anywhere images do. It has no language setting: it shows only the mark and the name.

## Card for your website

Paste one tag where the card should appear:

`HTML`:

```
<script src="https://mcp.tc/w/deepwiki.js" async></script>
```

Or put a placeholder wherever you like and load the script once, anywhere on the page. Every placeholder for that server gets a card. Whatever you put inside a placeholder shows until the card replaces it, and stays for visitors without JavaScript:

`HTML`:

```
<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` (the default, follows the visitor’s light or dark mode), `light` or `dark`.
- `data-size`: `full` (the default, with the tagline) or `compact`.
- The card is up to 520 px wide (420 px compact) and fills narrower spaces. Set the CSS variable `--mcptc-max-width` on the placeholder or a parent to change that.

It shows the icon, name and checkmark, what the server needs (sign-in, a key, a local install), the server’s own URL or install command with a Copy button, one-click “Add to” buttons for Claude Code, Cursor, VS Code and claude.ai (for the clients that can use it), and a link to the listing.

## iframe

For pages that don’t allow scripts, such as site builders and wikis, the compact card also comes as a page of its own:

`HTML`:

```
<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>
```

- It’s 200 px tall at any width from 320 px. Long names and URLs end with an ellipsis, and the “Add to” buttons scroll sideways when they don’t fit.
- `?theme=light` or `?theme=dark` fixes the colors; without it the card follows the visitor’s mode.
- `allow="clipboard-write"` lets its Copy buttons work. It’s the only mcp.tc page other sites may frame, and search engines don’t index it.

## Listing data as JSON

Every listing is also available as JSON, for your own pages and tools:

```
https://mcp.tc/i/deepwiki.json
```

Every field, error and caching rule is in the [API docs](https://mcp.tc/docs/api#listing-json).

## Languages

The card, the iframe and the JSON are in English unless you ask for another language. Add `?lang=` with `it`, `fr`, `de` or `es` to their address (`en` is the default):

```
<script src="https://mcp.tc/w/deepwiki.js?lang=it" async></script>
https://mcp.tc/embed/deepwiki?lang=de&theme=dark
https://mcp.tc/i/deepwiki.json?lang=fr
```

- Labels, buttons and the access state switch to that language. The listing’s own text (the tagline, and in the JSON the description and tool summaries) switches too when the listing has an up-to-date translation. Until then it stays in English.
- Links go to the listing page in that language once that page is translated, otherwise to the English page.
- Each language has its own address, so it is cached on its own. An unknown value gives English.
- The badge has no language: it shows the mark and the server’s name. Write its alt text in your page’s language.
- On each listing, the **Embed** section has a language menu that fills these addresses in, and an AI prompt that tells a coding assistant how to add the card.

## Privacy and use

- Embeds set no cookies, track no one and load nothing else. Requests for them aren’t written to our access log. The [Privacy Policy](https://mcp.tc/privacy) has the details.
- You can use them for any listed server, on any site, for free. The badge says a server is listed on mcp.tc, and the checkmark says who runs it. Neither one is a security review.

How they behave on your page and how long copies are cached: [API docs](https://mcp.tc/docs/api#embeds).

---
Source: https://mcp.tc/embed. Markdown version for AI agents (ask for `text/markdown` or add `.md` to the address). Site overview: https://mcp.tc/llms.txt
