{
  "markdown": "# @provenonce/mcp\n\n**Provenonce Skill** — Give any AI agent cryptographic identity in under 60 seconds.\n\nAdd this skill to your agent and it gets:\n- A permanent cryptographic hash (identity)\n- A SIGIL (verified identity class + tier)\n- A signed Passport (verifiable offline by any third party)\n- Heartbeat (continuous liveness proof)\n- Beats proofs (evidence of computational work)\n- Lineage (full ancestry chain)\n\n## Quick Start\n\n### Claude Desktop / Claude Code\n\nAdd to `~/.claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"provenonce\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@provenonce/mcp\"]\n    }\n  }\n}\n```\n\nThat's it. On first use, your agent calls `provenonce_register` and gets a permanent identity.\n\n### With pre-existing credentials\n\n```json\n{\n  \"mcpServers\": {\n    \"provenonce\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@provenonce/mcp\"],\n      \"env\": {\n        \"PROVENONCE_API_KEY\": \"pvn_...\",\n        \"PROVENONCE_AGENT_HASH\": \"0x...\"\n      }\n    }\n  }\n}\n```\n\n### As a skill developer (earn rev share)\n\nIf you're a developer embedding this skill in your framework, include your partner ref token:\n\n```json\n{\n  \"env\": {\n    \"PROVENONCE_SKILL_REF\": \"your16hextoken\"\n  }\n}\n```\n\nYou earn 30% of every SIGIL purchased by agents you deploy. Register at `POST /api/v1/skill/register`.\n\n## The 11 Tools\n\n| Tool | What it does | Auth needed |\n|------|-------------|-------------|\n| `provenonce_register` | Auto-register agent, get hash + API key | None |\n| `provenonce_status` | Full current state (SIGIL, balance, hints) | Yes |\n| `provenonce_purchase_sigil` | Buy SIGIL, unlock heartbeat + passport | Yes + SOL tx |\n| `provenonce_heartbeat` | Submit liveness proof | Yes + SOL tx |\n| `provenonce_batch_heartbeat` | Heartbeat multiple children in one call | Yes + SOL tx |\n| `provenonce_get_passport` | Get signed identity document | Yes |\n| `provenonce_beats_proof` | Compute work proof, get receipt (for spawn/resync) | None |\n| `provenonce_submit_beats` | Compute VDF beats and credit lifetime beat count | Yes |\n| `provenonce_verify_agent` | Check another agent's identity | None |\n| `provenonce_spawn` | Spawn a child agent | Yes |\n| `provenonce_get_lineage` | Get full ancestry chain | None |\n\n## Usage Examples\n\n### Example 1: Register and check status\n\n**User prompt:** \"Register with Provenonce and show me my identity.\"\n\n**Expected behavior:**\n- Agent calls `provenonce_register` with an optional name\n- Receives a permanent cryptographic hash (e.g. `0xabcd...`) and API key\n- Credentials are saved to `~/.provenonce/config.json`\n- Agent calls `provenonce_status` to display identity, balance, and next steps\n- Status response includes a `_hint` suggesting the agent purchase a SIGIL\n\n### Example 2: Verify another agent before trusting it\n\n**User prompt:** \"Check if agent 0xf7dad8f4...b6fd is legitimate.\"\n\n**Expected behavior:**\n- Agent calls `provenonce_verify_agent` with the target hash\n- Returns the agent's SIGIL, identity class, tier, registration date, and liveness score\n- Agent reports whether the target has an active SIGIL and recent heartbeats\n- No authentication needed — this is a public verification endpoint\n\n### Example 3: Full lifecycle — SIGIL, heartbeat, and passport\n\n**User prompt:** \"Get me a SIGIL, send a heartbeat, and export my passport.\"\n\n**Expected behavior:**\n- Agent calls `provenonce_purchase_sigil` without `payment_tx` to get fee instructions (amount in SOL + ops wallet address)\n- User sends the SOL payment and provides the transaction signature\n- Agent calls `provenonce_purchase_sigil` again with the `payment_tx` to complete the purchase\n- Agent calls `provenonce_heartbeat` (same payment flow) to prove liveness\n- Agent calls `provenonce_get_passport` to receive a cryptographically signed identity document\n- Passport can be verified offline by any third party using the Provenonce authority public key\n\n## Agent Flow\n\n```\nDay 1:  provenonce_register      → hash minted, credentials saved\n        provenonce_beats_proof   → works immediately, no SIGIL needed\n        provenonce_status        → { sigil: null, _hint: \"Call provenonce_purchase_sigil...\" }\n\nDay 7:  provenonce_purchase_sigil → pay SOL, SIGIL issued\n        provenonce_heartbeat     → now unlocked\n        provenonce_get_passport  → signed identity doc, share with anyone\n        provenonce_verify_agent  → verify a counterparty before trusting them\n```\n\n## Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `PROVENONCE_API_KEY` | Agent API key (pvn_...) | Read from ~/.provenonce/config.json |\n| `PROVENONCE_AGENT_HASH` | Agent hash (0x...) | Read from ~/.provenonce/config.json |\n| `PROVENONCE_SKILL_REF` | Your partner ref token (for rev share) | None |\n| `PROVENONCE_REGISTRY_URL` | Registry URL override | https://provenonce.io |\n\n## Framework-Agnostic Usage\n\n```typescript\nimport { PROVENONCE_TOOLS } from '@provenonce/mcp/tools';\n\n// OpenAI\nconst tools = PROVENONCE_TOOLS.map(t => ({ type: 'function', function: t }));\n\n// LangChain / custom — use PROVENONCE_TOOLS for schema, implement handlers yourself\n```\n\n## Credential Storage\n\nCredentials are stored in `~/.provenonce/config.json` with `chmod 600` permissions (Unix).\n\nOn Windows, use environment variables (`PROVENONCE_API_KEY` + `PROVENONCE_AGENT_HASH`) — file permissions are not enforced.\n\n## Privacy Policy\n\nProvenonce collects the minimum data necessary to provide cryptographic identity services:\n\n- **Data collected:** Agent name (optional), cryptographic hash (generated), API key, SIGIL metadata, heartbeat timestamps, and Solana transaction signatures for payments.\n- **How data is used:** To maintain the agent identity registry, verify agent liveness, and issue signed passports. No data is sold to third parties.\n- **Storage:** Agent state is stored in Supabase (PostgreSQL). Tamper-proof timestamps are anchored on the Solana blockchain as SPL Memo transactions.\n- **Third-party sharing:** On-chain memos (registration, SIGIL) are publicly visible on Solana. No other data is shared with third parties.\n- **Retention:** Agent records persist indefinitely as part of the provenance chain. Revoked agents are marked but not deleted.\n- **Contact:** ops@provenonce.io\n\nFull privacy policy: [provenonce.dev/legal/privacy](https://provenonce.dev/legal/privacy)\n\n## Support\n\n- Documentation: [provenonce.dev](https://provenonce.dev)\n- Issues: [github.com/ProvenonceAI/provenonce-mcp/issues](https://github.com/ProvenonceAI/provenonce-mcp/issues)\n- Email: ops@provenonce.io\n\n## What's Coming\n\n- `provenonce_kyc` — KYC / identity class upgrade\n- Auto-heartbeat timer (opt-in)\n- Python SDK (`provenonce-py`)\n\n## License\n\nMIT — see [LICENSE](./LICENSE)\n\n## Links\n\n- Registry: [provenonce.io](https://provenonce.io)\n- Docs: [provenonce.dev](https://provenonce.dev)\n- API: [provenonce.io/openapi.yaml](https://provenonce.io/openapi.yaml)\n",
  "bytes": 6909,
  "sha": "45dc0f4001ceeb58b25e5bb747fe8a70efc5590c476ad13e96d932d57e892ed6",
  "repo_slug": "provenonceai/provenonce-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_provenonceai_provenonce_f553fb63/readme"
}