Badge Integration

Fidensa badges are live SVGs served from the attestation infrastructure. They reflect current certification status in real time. If a certification is suspended, revoked, or expired, the badge updates automatically.

Badge URL

Replace YOUR-CAPABILITY-ID with the capability ID from the certifications catalog.

Latest version

https://fidensa.com/badges/YOUR-CAPABILITY-ID.svg

Pinned to a specific version

https://fidensa.com/badges/YOUR-CAPABILITY-ID/1.0.0.svg

Live examples

playwright-mcp

docx-skill

claude-guardrails

Markdown (GitHub README)

[![Fidensa Certified](https://fidensa.com/badges/YOUR-CAPABILITY-ID.svg)](https://fidensa.com/certifications/YOUR-CAPABILITY-ID)

HTML (website or docs)

<a href="https://fidensa.com/certifications/YOUR-CAPABILITY-ID">
  <img
    src="https://fidensa.com/badges/YOUR-CAPABILITY-ID.svg"
    alt="Fidensa Certified"
  />
</a>

Style variants

Append a style query parameter. Fidensa badges support the same styles as shields.io.

Parameter	Description
?style=flat	Default. Standard shield shape.
?style=flat-square	Square corners.
?style=for-the-badge	Large, bold style.
?compact=true	Shorter badge without maturity dots.

Machine-readable metadata

Add a certification block to your package.json, MCP server manifest, or plugin manifest. This lets AI agents and tooling discover and verify certification status automatically.

package.json

{
  "certification": {
    "authority": "fidensa.com",
    "capability_id": "YOUR-CAPABILITY-ID",
    "version": "1.0.0",
    "status_url": "https://fidensa.com/v1/attestation/YOUR-CAPABILITY-ID",
    "record_url": "https://fidensa.com/certifications/YOUR-CAPABILITY-ID",
    "artifact_url": "https://fidensa.com/v1/artifacts/YOUR-CAPABILITY-ID",
    "badge_url": "https://fidensa.com/badges/YOUR-CAPABILITY-ID.svg"
  }
}

CI/CD verification

Use the Fidensa GitHub Action to verify certification status in your CI pipeline. No API key required.

GitHub Actions workflow step

- uses: fidensa/check-certification@v1
  with:
    capabilities: YOUR-CAPABILITY-ID
    min-score: 75

Programmatic access

The @fidensa/mcp-server npm package gives AI agents direct access to certification checks, contract retrieval, artifact verification, and experience reporting. See the API documentation for the full endpoint reference.

For the full integration guide including maturity indicators and attestation API details, see the fidensa-badges repository.