Skip to content

AgentPin agent pinning protocol, part of the Symbiont Agent Trust Stack

License

Notifications You must be signed in to change notification settings

ThirdKeyAI/AgentPin

Repository files navigation

AgentPin

Domain-anchored cryptographic identity for AI agents. The second layer in the ThirdKey trust stack (SchemaPin β†’ AgentPin β†’ Symbiont).

Read the Documentation β†’

What It Does

AgentPin lets organizations publish verifiable identity for their AI agents. Issue short-lived ES256 credentials, verify agent identity with a 12-step protocol, and enforce capability-scoped access β€” all anchored to your domain via .well-known discovery.

  • ES256 (ECDSA P-256) cryptographic credentials
  • Domain-anchored .well-known/agent-identity.json discovery
  • 12-step verification with TOFU key pinning
  • Delegation chains for maker-deployer models
  • Capability-scoped credentials with constraints
  • Credential revocation at credential, agent, and key level
  • Mutual authentication with challenge-response
  • Trust bundles for air-gapped and enterprise environments
  • Cross-language β€” Rust, JavaScript, and Python SDKs produce interoperable credentials

Quick Start

# Generate keys
agentpin keygen --domain example.com --kid my-key-2026 --output-dir ./keys

# Issue a credential
agentpin issue \
  --private-key ./keys/my-key-2026.private.pem \
  --kid my-key-2026 --issuer example.com \
  --agent-id "urn:agentpin:example.com:scout" \
  --capabilities "read:data,write:reports" --ttl 3600

# Verify a credential
agentpin verify --credential <jwt>

Getting Started Guide β†’

Installation

Rust

[dependencies]
agentpin = { version = "0.2", features = ["fetch"] }

JavaScript

npm install agentpin

Python

pip install agentpin

Documentation

Topic Link
Getting Started docs.agentpin.org/getting-started
Verification Flow docs.agentpin.org/verification-flow
CLI Reference docs.agentpin.org/cli-guide
Trust Bundles docs.agentpin.org/trust-bundles
Delegation Chains docs.agentpin.org/delegation-chains
Deployment docs.agentpin.org/deployment
Security docs.agentpin.org/security
Technical Specification AGENTPIN_TECHNICAL_SPECIFICATION.md

Project Structure

crates/
β”œβ”€β”€ agentpin/          # Core Rust library
β”œβ”€β”€ agentpin-cli/      # CLI binary
└── agentpin-server/   # HTTP server for .well-known endpoints
javascript/            # JavaScript/Node.js SDK
python/                # Python SDK

License

MIT β€” Jascha Wanger / ThirdKey.ai