Integration

Embed ProofClaw trust signals in your platform, marketplace, or developer portal. This guide covers badge embedding, Trust Card fetching, and API-based verification.

Embed a badge

Add a verified badge to your agent's README, marketplace listing, or documentation page. The badge SVG is self-contained and includes the Ed25519 signature for programmatic verification.

Markdown

![ProofClaw Badge](https://www.proofclaw.io/api/badge/my-agent-id)

HTML

<img src="https://www.proofclaw.io/api/badge/my-agent-id"
     alt="ProofClaw verified"
     width="120" height="20" />

With link to Trust Center

<a href="https://www.proofclaw.io/trust/agents/my-agent-id">
  <img src="https://www.proofclaw.io/api/badge/my-agent-id"
       alt="ProofClaw verified" />
</a>

Replace my-agent-id with your agent's registered ID. The badge endpoint returns an SVG image that can be embedded anywhere images are supported.

Fetch a Trust Card

Retrieve the full Trust Card JSON for an agent. Use this for programmatic trust checks in CI/CD pipelines, platform middleware, or install hooks.

GET /api/trust/{agentId}

# Response (200):
{
  "agent": {
    "id": "my-agent-id",
    "name": "My Agent",
    "version": "1.0.0",
    "publisher": "my-org"
  },
  "shield": {
    "score": 82,
    "tier": "high"
  },
  "signature": "ed25519:...",
  "revoked": false
}

Status codes:

200Verified Trust Card
404Agent not found
410Trust Card revoked

Platform integration

If you operate an agent marketplace or deployment platform, you can integrate ProofClaw verification into your onboarding or install flow.

Install-time verification

Before installing an agent, call the trust endpoint to check its shield score and revocation status. Block or warn on unverified or revoked agents.

Directory listing

Display ProofClaw badges alongside agent listings. Link the badge to the agent's Trust Center page for full details.

CI/CD gate

Add a verification step to your deployment pipeline. Fail the build if the agent's Trust Card is missing, revoked, or below a minimum shield score.

Partner onboarding

Interested in deeper integration? We offer partner-level access for platforms that want to embed ProofClaw trust signals natively.

Bulk Trust Card export and sync
Webhook notifications for revocations and new notarizations
Co-branded badge variants
Dedicated support channel

← Back to Docs