Skip to content
Integrations · Badges

Show your trust score.

Drop-in badges for your README. Auto-refresh, color-coded, link to live report. One line of Markdown — green, amber, or red.

01 · Live preview

A real badge — re-fetched just now.

Live · pulled from /badge endpoint
MCPAmpel trust score Re-checks every 6h on push · 24h otherwise
Endpoint
{{origin}}/badge//.svg

Type any owner/repo above the snippets below to point the embed at your own project. The badge endpoint serves a static SVG with caching headers — your README just links to it.

02 · Embed code

Paste your repo. Copy the snippet.

owner repo
Markdown.md

        
      

      

        
HTML.html

        

        
      

      

        
reStructuredText.rst

        

        
      

    

  






  

    

      03 · Customize
      
Query options.

    

    

      

        ?style=
        Visual treatment. Defaults to flat. Match the rest of your README's badge stack.
        flat · plastic · square
      

      

        ?label=
        Override the left-hand label text. Useful if "mcpampel" is too long for your row.
        trust · safety · score
      

      

        ?cache=
        Re-fetch frequency in seconds. Capped at 6h on free tier, anytime on monitored repos.
        3600 · 21600 · 86400
      

      

        ?compact=1
        Shorter form: just the score, no label. Pairs nicely with shields.io rows.
        9.2/10 → 9.2
      

    

  






  

    

      04 · Behavior
      
When the badge updates — and when it doesn't.

    

    

      

        Score change
        
Updates within 6h on push

        
When a new commit lands, the watcher re-scans within 6 hours and the badge picks up the new score on its next cache fill. Color shifts immediately if the band changes.

      

      

        Stale
        
Greys out after 30 days

        
If we haven't been able to scan a repo for 30 days — gone private, deleted, network-blocked — the badge greys and the right side reads stale. Click through for the last known score.

      

      

        Free tier
        
Public scans, public badge

        
Any public repo can have a free badge. We refresh on a best-effort schedule. No account required to embed — only to monitor.

      

      

        Monitored
        
Refresh anytime, alert on drop

        
Add a repo to your watchlist (free account) to force-refresh, get email alerts on score drops, and remove the 6h floor. Same badge URL — just smarter.

      

    

  






  

    

      

        Try it
        Scan a repo, then embed the badge.
      

      Scan now →