Badges

Badge Styles

Display your MCPSafe security grade with customizable badge styles for your README and documentation.

Badge URL Format

URL Format

https://api.mcpsafe.org/api/badge/{server-slug}?style={style}

{server-slug} - Your server's unique identifier

{style} - Badge style (optional, default: flat)

Available Styles

MCPSafeA (92)

Flat

Clean, simple flat design

style=flat

MCPSafeA (92)

Flat Square

Flat design with square corners

style=flat-square

MCPSafeA (92)

Plastic

Classic badge style with gradient

style=plastic

MCPSafeA (92)

For The Badge

Large, bold style

style=for-the-badge

MCPSafeA (92)

Social

Social media style with rounded left edge

style=social

Color Scale

Automatic Color Based on Grade

Badge colors are automatically determined by your security grade

A+ (95)

Green - Excellent#22c55e

A (85)

Light Green - Good#4ade80

B (75)

Yellow - Acceptable#facc15

C (60)

Orange - Needs Work#fb923c

D (40)

Light Red - Poor#f87171

F (20)

Red - Critical#dc2626

Query Parameters

style

Badge style

flat | flat-square | plastic | for-the-badge | social

label

Custom left side text

Default: MCPSafe

logo

Show MCPSafe logo

true | false

cache

Cache duration in seconds

Default: 3600

Example

Full URL Example

https://api.mcpsafe.org/api/badge/filesystem-server?style=for-the-badge&logo=true

MCPSafeA (92)