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:

1m-handshake install

The addon uses organization metadata supplied by a compatible agent host when it is available. Otherwise, it asks the owner for the organization's public domain, then first tries a configured enterprise agent identity. If that is unavailable, it guides the owner through one-time work-email or DNS-TXT domain verification.

By default, setup also installs a visible 1M Handshake skill in the agent workspace. It gives the agent a voluntary capability to consider a claim after its own meaningful A2A interactions; it is not a listener, does not observe traffic, and never modifies AGENTS.md, CLAUDE.md, or other broad instructions. Run setup from the workspace root, or specify it directly:

1m-handshake install --workspace /path/to/agent-workspace

Use --no-agent-skill only when you want verification without capability installation.

The default endpoint is the public Freshstart testing service. During this testing phase, use --backend-url only when you have been given a different environment URL.

Staging payment test

This optional, resettable test uses a local disposable Base Sepolia wallet. It never uses real money, requires owner approval by default, and is not a production approval or permanent public record.

1m-handshake staging-status
1m-handshake staging-claim counterparty.example

staging-claim makes a real A2A call only after confirmation, then performs a one-cent test settlement and records the result in staging. The addon keeps only privacy-safe local pilot milestones (for example, “funding ready” or “record redeemed”); it never logs wallet keys, prompts, agent messages, or call contents.

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.