Example Token Interactions

Account Creation via MCP

This flow allows AI agents to create accounts programmatically using the Skyfire token and the Model Context Protocol (MCP):

1. The Buyer Agent
   1. Calls the Skyfire API to generate a kya or kya+pay token.
   2. Sends the token to the seller’s "createAccount" or similar endpoint on their MCP-compatible server.
2. The Seller Service
   1. Verifies the token’s signature using the Skyfire JWKS.
   2. Extracts identity information from the token payload.
   3. Creates a new user account and returns auth credentials for future access.
3. Post-Creation
   1. The agent stores the credentials and can now interact with the service using standard authentication.

Agent Checkout

This flow enables AI agents to access and pay for a service or tool via tokenized identity and payment:

1. The Buyer Agent
   1. Uses the Skyfire API to create a pay or kya+pay token.
   2. Sends the token to the seller’s service endpoint along with any existing auth credentials.
2. The Seller Service
   1. Verifies the token signature using Skyfire’s JWKS and extracts payment details.
   2. Delivers the product, service, or access as requested.
   3. Charges the token using the Skyfire chargeToken API to receive payment.
3. Payment Settlement
   1. Skyfire manages the transfer of committed funds from the buyer agent's wallet to the seller's wallet.