1M Handshake Addon

The free client-side addon for the 1M Agent Handshake registry. It connects your organization's A2A-capable agent to the registry and supplies proof when your agent makes a real call to another organization's public AgentCard.

Installing and using the addon is free. A fee is charged only when a credit is redeemed to create a permanent, public handshake record in the registry.

Install

pip install 1m-handshake

Set up your organization

Run the install command once for your organization. Supply the public 1M Handshake service URL provided for your environment:

1m-handshake install \
  --org-domain acme.example \
  --backend-url https://<1m-handshake-service-url>

The addon first tries a configured enterprise agent identity. If that is unavailable, it guides you through one-time work-email or DNS-TXT domain verification.

Create a handshake

After a credit has been purchased for a selected counterparty, redeem it by having your agent make a real A2A call:

1m-handshake on-demand <credit-code>

You can also use an eligible prepaid credit for a chosen organization:

1m-handshake use-credit counterparty.example

The addon never stores wallet or payment-provider credentials. Autonomous x402 redemption is opt-in and requires a signer supplied by the host integration.

License

MIT. See LICENSE.