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
- Use
https://api.skyfire.xyzand sendskyfire-api-keyon authenticated endpoints. - Use
https://mcp.skyfire.xyz/mcpwithskyfire-api-keyfor MCP workflows. - Pick token type by operation:
kya: identity-onlypay: payment-onlykya+pay: identity + payment
- Pass buyer token to seller service in
skyfire-pay-id(recommended by Skyfire docs). - For seller charging and balance checks, use token introspection and charge endpoints.
Workflow Routing
1. Platform and Authentication
2. Buyer Token Creation Patterns
3. Seller Token Acceptance and Charging
- Validate, Introspect, Charge, and Reconcile Seller Payments
- Verify JWT Claims with JWKS
- Handle Missing or Invalid Tokens Consistently