skyfire

When to use

• Building agent workflows that require identity and/or payment tokens
• Creating buyer tokens (

  kya

  ,

  pay

  ,

  kya+pay

  ) via REST or Skyfire MCP
• Accepting tokens on seller APIs and charging payment-capable tokens
• Defining or updating seller service metadata and token requirements
• Discovering services and tags from Skyfire service directory APIs
• Managing enterprise users and agent settings via admin endpoints

Quick Start

1. Use

   https://api.skyfire.xyz

   and send

   skyfire-api-key

   on authenticated endpoints.
2. Use

   https://mcp.skyfire.xyz/mcp

   with

   skyfire-api-key

   for MCP workflows.
3. Pick token type by operation:

   • kya

     : identity-only

   • pay

     : payment-only

   • kya+pay

     : identity + payment
4. Pass buyer token to seller service in

   skyfire-pay-id

   (recommended by Skyfire docs).
5. For seller charging and balance checks, use token introspection and charge endpoints.

Workflow Routing

1. Platform and Authentication

• Set Up API Keys and Environment

2. Buyer Token Creation Patterns

• Choose the Right Token Type
• Create Buyer Tokens Correctly
• Enforce Token Creation Constraints

3. Seller Token Acceptance and Charging

• Validate, Introspect, Charge, and Reconcile Seller Payments
• Verify JWT Claims with JWKS
• Handle Missing or Invalid Tokens Consistently

4. Seller Service Management

• Manage Seller Service Lifecycle (CRUD)

5. Discovery and Agent Operations

• Discover Services and Tags
• Use Wallet, Source IP, and Token Version APIs

6. MCP Integration Patterns

• Integrate Skyfire MCP in Agent Workflows

7. Enterprise Operations

• Manage Enterprise Users and Personal Data

8. Security and Reliability Patterns

• Apply Skyfire Security Best Practices

References

• Skyfire Developer Portal
• Developer Docs Overview
• Welcome / Environments
• API Authentication
• Create Token
• Introspect Token
• Charge Token
• Verify and Extract Data from Tokens
• Integrating Tokens into Seller Services