Provenonce Skill

The Provenonce Skill is an MCP (Model Context Protocol) server that gives any AI agent cryptographic identity, a SIGIL, heartbeat liveness proofs, and a signed Passport — in under 60 seconds.

Instead of integrating an SDK, you add one entry to your agent’s MCP config. The skill handles everything else: registration, credential storage, API calls, and progressive access as the agent earns its SIGIL.


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

That’s it. On first tool call, the agent is registered. Credentials are stored in ~/.provenonce/config.json.

Paid operations: When the agent calls a paid tool (SIGIL purchase, heartbeat, passport) without a payment_tx, the skill returns payment instructions — fee amount and payment address. The agent handles payment using its own wallet infrastructure, then calls the tool again with the transaction signature.

What the agent gets

Service	Tool	What it proves
Identity	`provenonce_register`	Permanent cryptographic hash — who this agent is
Status	`provenonce_status`	Current state: SIGIL, balance, next steps
SIGIL	`provenonce_purchase_sigil`	Verified identity class + tier — unlocks heartbeat
Liveness	`provenonce_heartbeat`	On-chain proof this agent is still running
Batch liveness	`provenonce_batch_heartbeat`	Heartbeat multiple children in one payment
Passport	`provenonce_get_passport`	Signed document verifiable offline by anyone
Work proof	`provenonce_beats_proof`	Compute beats + get signed receipt from Beats service
Submit beats	`provenonce_submit_beats`	Extend beat chain — credits lifetime beats in Registry
Trust check	`provenonce_verify_agent`	Check another agent’s identity before trusting them
Lineage	`provenonce_spawn`	Spawn a child agent that inherits your lineage
History	`provenonce_get_lineage`	Full tamper-evident event chain

Agent lifecycle


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

Later — Full Provenance
  provenonce_purchase_sigil → agent pays SOL, SIGIL issued
  provenonce_heartbeat      → liveness proofs unlocked
  provenonce_get_passport   → signed identity doc, share with anyone

Ongoing — Trust & Lineage
  provenonce_verify_agent   → verify a counterparty before trusting them
  provenonce_spawn          → create child agents with inherited lineage
  provenonce_get_lineage    → audit full history

The agent can register on Day 1 and buy a SIGIL a week later. There’s no expiry on the identity — only on the Passport (which renews with each heartbeat).

How it relates to the SDK

	`@provenonce/sdk`	`@provenonce/mcp`
For	Developers building agents	Agents themselves
Integration	`npm install` → code	One line in MCP config
Credentials	Developer manages keys	Skill handles storage
Best for	Full programmatic control	Agent-native, autonomous

Both use the same provenonce.io APIs. They are complementary — use the SDK when you want full control, use the skill when you want the agent to manage its own identity.

Framework support

The skill ships as two artefacts from the same package:

MCP server (primary):


npx @provenonce/mcp

Works with Claude Desktop, Claude Code, and any MCP-compatible host.

Framework-agnostic tool bundle (for OpenAI, LangChain, custom):


import { PROVENONCE_TOOLS } from '@provenonce/mcp/tools';
 
// OpenAI function calling
const tools = PROVENONCE_TOOLS.map(t => ({ type: 'function', function: t }));

Quickstart — Add the skill to your agent in 60 seconds
Tool Reference — All 11 tools, inputs, outputs, examples
Earn Rev Share — Deploy the skill in your framework and earn 30%

Provenonce Skill

What the agent gets

Agent lifecycle

How it relates to the SDK

Framework support

Next