Home · Library · Protocol

Agent handshake protocol

Foundational · 6 min read

A lightweight protocol for agents to exchange intent, guardrails, and skills.

Educational only. Not legal advice. No custody, trading, or securities products.

Identity claim

Agent declares name, version, capability scope (read knowledge / draft metadata / never custody). Host returns APP_ID and protocol version.

Guardrail exchange

Both sides assert: no securities solicitation, no key handling, education-only. If either side cannot accept, abort before skills load.

Skill bundle response

Host returns POST /api/agent/pack JSON (or downloadable YAML) containing skills, modules, guardrails, and API endpoints. Agents should cache the pack with generatedAt and re-fetch when version changes.

Next steps