@provenonce/mcp

Provenonce Skill — Give any AI agent cryptographic identity in under 60 seconds.

Add this skill to your agent and it gets:

• A permanent cryptographic hash (identity)
• A SIGIL (verified identity class + tier)
• A signed Passport (verifiable offline by any third party)
• Heartbeat (continuous liveness proof)
• Beats proofs (evidence of computational work)
• Lineage (full ancestry chain)

Quick Start

Claude Desktop / Claude Code

Add to ~/.claude/claude_desktop_config.json:

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

That's it. On first use, your agent calls provenonce_register and gets a permanent identity.

With pre-existing credentials

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

As a skill developer (earn rev share)

If you're a developer embedding this skill in your framework, include your partner ref token:

{
  "env": {
    "PROVENONCE_SKILL_REF": "your16hextoken"
  }
}

You earn 30% of every SIGIL purchased by agents you deploy. Register at POST /api/v1/skill/register.

The 9 Tools

| Tool | What it does | Auth needed | |------|-------------|-------------| | provenonce_register | Auto-register agent, get hash + API key | None | | provenonce_status | Full current state (SIGIL, balance, hints) | Yes | | provenonce_purchase_sigil | Buy SIGIL, unlock heartbeat + passport | Yes + SOL tx | | provenonce_heartbeat | Submit liveness proof | Yes + SOL tx | | provenonce_get_passport | Get signed identity document | Yes | | provenonce_beats_proof | Compute local work proof | None | | provenonce_verify_agent | Check another agent's identity | None | | provenonce_spawn | Spawn a child agent | Yes | | provenonce_get_lineage | Get full ancestry chain | None |

Agent Flow

Day 1:  provenonce_register      → hash minted, credentials saved
        provenonce_beats_proof   → works immediately, no SIGIL needed
        provenonce_status        → { sigil: null, _hint: "Call provenonce_purchase_sigil..." }

Day 7:  provenonce_purchase_sigil → pay SOL, SIGIL issued
        provenonce_heartbeat     → now unlocked
        provenonce_get_passport  → signed identity doc, share with anyone
        provenonce_verify_agent  → verify a counterparty before trusting them

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | PROVENONCE_API_KEY | Agent API key (pvn_...) | Read from ~/.provenonce/config.json | | PROVENONCE_AGENT_HASH | Agent hash (0x...) | Read from ~/.provenonce/config.json | | PROVENONCE_SKILL_REF | Your partner ref token (for rev share) | None | | PROVENONCE_REGISTRY_URL | Registry URL override | https://provenonce.io |

Framework-Agnostic Usage

import { PROVENONCE_TOOLS } from '@provenonce/mcp/tools';

// OpenAI
const tools = PROVENONCE_TOOLS.map(t => ({ type: 'function', function: t }));

// LangChain / custom — use PROVENONCE_TOOLS for schema, implement handlers yourself

Credential Storage

Credentials are stored in ~/.provenonce/config.json with chmod 600 permissions (Unix).

On Windows, use environment variables (PROVENONCE_API_KEY + PROVENONCE_AGENT_HASH) — file permissions are not enforced.

What's Coming

• provenonce_kyc — KYC / identity class upgrade
• Auto-heartbeat timer (opt-in)
• Python SDK (provenonce-mcp)

Links

• Registry: provenonce.io
• Docs: provenonce.dev
• API: provenonce.io/openapi.yaml