skyfire

When to use

Use this skill when:

• 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