Trigger on event
- Listen for a new event
- Parse and validate the payload
- Take an action with the linked tool
16 tools available
Skyfire enables AI agents to autonomously transact and pay for services, creating a seamless payment infrastructure for AI applications.
Connect Skyfire to Definable to automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas call Skyfire's 16 tools directly from chat or scheduled flows. You can wire it into any persona to read, write, and react when an event fires.
Every Skyfire action below is a callable tool any Definable persona can invoke.
Charge a buyer's token (seller-side operation). REQUIRES SELLER API KEY: This action requires your seller agent API key, not the buyer's key. The buyer creates and sends you a pay/kya+pay token JWT, you provide the service, then call this endpoint to collect payment. Flow: Buyer creates token → Buyer calls your service with token → You validate token → You provide service → You call this to charge. Common errors: - 401: Invalid/expired token OR wrong API key (must use seller key) - 402: Charge amount exceeds token value
Issue a Skyfire KYA+PAY token (POST /api/v1/tokens with type=kya+pay).
Issue a Skyfire KYA token (POST /api/v1/tokens with type=kya).
Issue a Skyfire PAY token (POST /api/v1/tokens with type=pay).
Fetch all service tags to discover filtering options. Chain with ListDirectoryServices using tags parameter to find specific types of services (e.g., 'ai', 'mcp', 'scraping').
Retrieve buyer wallet balance. Chain before token creation to prevent declines.
Tool to get full details for a specific service in the Skyfire directory by its ID. Use when you need complete information about a service including pricing, requirements, and seller details.
Get full details for one service. More detailed than ListDirectoryServices - shows terms of service, API specs, and integration URLs. Use before creating expensive tokens.
Browse all services from one seller agent. Useful when you trust a seller and want to see their full catalog, or when tracking down who provides a specific type of service.
Filter services by tags to find exactly what you need. More efficient than browsing all services when you know the category. Chain: GetAllServiceTags → GetServicesByTags → CreatePayToken.
Audit charges for a specific token. Shows exactly what sellers charged against your token and when. Use for reconciliation: "I authorized $5 max, what did they actually charge?"
Check if a token is still valid before calling a seller service. Prevents wasted API calls with expired tokens. Use after creating tokens if there's a delay before calling the seller, or when debugging payment issues.
List all services registered by the authenticated seller agent. Use when you need to view or manage your own services as a seller.
Inspect buyer tokens for observability. Chain with transactions to audit usage.
Browse Skyfire's service directory to obtain `sellerServiceId` for token creation. Chain this with CreatePayToken or CreateKyaPayToken.
Register IP addresses as sources for Agent requests (PUT /api/v1/agents/source-ips). Use before creating tokens to whitelist agent IPs.
Anything Skyfire exposes through its API. Common ai agents workflows on Definable include automate repetitive tasks, sync data with the rest of your stack, trigger on real-world events. Personas can call any of the 16 Skyfire tools directly, then chain the result into another integration without you writing code.
Skyfire uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Yes — every Definable plan, including Starter, includes access to all 16 Skyfire tools. You only need a separate Skyfire subscription if Skyfire itself charges per seat or per API call.
Every call from a persona to Skyfire is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
Sign up for Definable, open the integrations page, find Skyfire, and connect via OAuth or API key. You can immediately attach Skyfire to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
Definable exposes all 16 Skyfire actions as callable tools — including `Charge Skyfire Token`, `Create Skyfire KYA+PAY Token`, `Create Skyfire KYA Token`, plus 13 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Wire it up in minutes. No coding required.