Skyfire

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.

Common workflows with Skyfire

01

Trigger on event

  1. Listen for a new event
  2. Parse and validate the payload
  3. Take an action with the linked tool
02

Daily summary

  1. Pull yesterday's activity
  2. Summarise with the model of your choice
  3. Send the digest via email or Slack
03

Cross-tool sync

  1. Read records from one app
  2. Transform with a persona
  3. Write the result back via this integration

Skyfire actions 16

Every Skyfire action below is a callable tool any Definable persona can invoke.

Charge Skyfire Token

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

Create Skyfire KYA+PAY Token

Issue a Skyfire KYA+PAY token (POST /api/v1/tokens with type=kya+pay).

Create Skyfire KYA Token

Issue a Skyfire KYA token (POST /api/v1/tokens with type=kya).

Create Skyfire PAY Token

Issue a Skyfire PAY token (POST /api/v1/tokens with type=pay).

Get All Service Tags

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').

Get Skyfire Buyer Wallet Balance

Retrieve buyer wallet balance. Chain before token creation to prevent declines.

Get Directory Service By ID

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 Skyfire Service 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.

Get Services by Agent

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.

Get Services by Tags

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.

Get Skyfire Token Charges

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?"

Introspect Skyfire Token

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 Agent Seller Services

List all services registered by the authenticated seller agent. Use when you need to view or manage your own services as a seller.

List Skyfire Buyer Tokens

Inspect buyer tokens for observability. Chain with transactions to audit usage.

List Skyfire Directory Services

Browse Skyfire's service directory to obtain `sellerServiceId` for token creation. Chain this with CreatePayToken or CreateKyaPayToken.

Set Agent Source IP Addresses

Register IP addresses as sources for Agent requests (PUT /api/v1/agents/source-ips). Use before creating tokens to whitelist agent IPs.

Frequently asked questions

What can I automate with Skyfire on Definable?

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.

How does Skyfire authentication work?

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.

Is the Skyfire integration included in my Definable plan?

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.

Is using Skyfire through Definable secure?

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.

How do I get started with Skyfire on Definable?

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.

What Skyfire actions does Definable expose?

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.

Ready to automate with Skyfire?

Wire it up in minutes. No coding required.

← All integrations