Skill Quickstart

Get your agent a cryptographic identity in under 60 seconds.

1) Add to MCP config

Claude Desktop / Claude Code

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "provenonce": {
      "command": "npx",
      "args": ["-y", "@provenonce/mcp"]
    }
  }
}

Restart your MCP host. The skill is now available to your agent.

2) Register

The agent calls:

provenonce_register

No parameters required. The skill checks for existing credentials (PROVENONCE_API_KEY env var → ~/.provenonce/config.json). If none exist, it registers a new agent automatically.

Returns:

{
  "registered": true,
  "hash": "0xabc123...",
  "api_key": "pvn_...",
  "depth": 0,
  "message": "Agent registered. Call provenonce_status to see your full state."
}

Save the api_key. It is your agent’s permanent credential.

3) Check status

provenonce_status

Returns:

{
  "hash": "0xabc123...",
  "sigil": null,
  "identity_class": null,
  "beats_balance": 0,
  "_hint": "Call provenonce_purchase_sigil to get full provenance."
}

No SIGIL yet — the agent is registered but not fully credentialled.

4) Compute a beats proof (optional — works immediately)

provenonce_beats_proof { "count": 100 }

This runs locally — no API call, no SOL. Returns cryptographic evidence that the agent spent CPU cycles.

{
  "from_hash": "0x1a2b...",
  "to_hash": "0x9f8e...",
  "beats_computed": 100,
  "duration_ms": 12
}

5) Purchase a SIGIL

When the agent is ready for full provenance, it purchases a SIGIL. This requires a Solana payment transaction.

provenonce_purchase_sigil {
  "name": "my-agent",
  "principal": "acme",
  "identity_class": "narrow_task",
  "tier": "ind",
  "payment_tx": "5KtPn1..."
}

Identity class (pricing axis — determines fee):

Tier (trust governance axis — determines SIGIL format):

Returns:

{
  "ok": true,
  "sigil": "my-agent*acme*ind",
  "identity_class": "narrow_task",
  "tier": "ind",
  "heartbeat_unlocked": true
}

The SIGIL is permanent. Heartbeat is now unlocked.

6) Heartbeat

provenonce_heartbeat { "payment_tx": "3Xp9q..." }

Returns:

{
  "ok": true,
  "message": "Heartbeat recorded. Agent liveness confirmed."
}

Call this periodically (every anchor cycle, ~60 seconds) to maintain liveness.

7) Get Passport

provenonce_get_passport

Returns a cryptographically signed document any third party can verify offline:

{
  "passport": {
    "agent_hash": "0xabc123...",
    "identity_class": "narrow_task",
    "sigil_issued_at_beat": 14200,
    "last_heartbeat_beat": 14350,
    "lineage_chain_hash": "0xdef456...",
    "valid_until": 1740700000,
    "provenonce_signature": "ed25519:..."
  }
}

Verification: compare provenonce_signature against the Provenonce authority public key at GET https://provenonce.io/api/v1/.well-known/authority-key.

Pre-existing credentials

If the agent already has credentials, set them as environment variables to skip auto-registration:

{
  "mcpServers": {
    "provenonce": {
      "command": "npx",
      "args": ["-y", "@provenonce/mcp"],
      "env": {
        "PROVENONCE_API_KEY": "pvn_...",
        "PROVENONCE_AGENT_HASH": "0x..."
      }
    }
  }
}

Next

• Tool Reference — Full inputs/outputs for all 9 tools
• Earn Rev Share — Deploy this skill in your framework and earn 30%
• SDK Quickstart — For programmatic integration instead