Skip to main content
Skyfire logo
  • Category: ai agents
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 16
  • Triggers: 0
  • Slug: SKYFIRE
  • Version: 20261101_00

Tools

Slug: SKYFIRE_CHARGE_TOKENCharge 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

Input Parameters

string
required
The JWT token string the buyer sent you (not the tokenId)
string
required
Amount to charge (must be <= token’s max amount)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_CREATE_KYA_PAY_TOKENIssue a Skyfire KYA+PAY token (POST /api/v1/tokens with type=kya+pay).

Input Parameters

string
Optional tag for buyer-side tracking
integer
required
Unix timestamp (seconds) when token expires
string
required
Maximum amount the seller may charge (as decimal string)
string
required
UUID of the seller service to call
array
Optional list of identity permission scopes required by seller (e.g., [‘email’, ‘name’])

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_CREATE_KYA_TOKENIssue a Skyfire KYA token (POST /api/v1/tokens with type=kya).

Input Parameters

string
Optional tag for buyer-side tracking
integer
required
Unix timestamp (seconds) when token expires
string
required
UUID of the seller service to call
array
Optional list of identity permission scopes if required by seller (e.g., [‘email’, ‘name’]). Check service’s buyerIdentityRequirement to see what permissions may be needed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_CREATE_PAY_TOKENIssue a Skyfire PAY token (POST /api/v1/tokens with type=pay).

Input Parameters

string
Your internal reference for tracking - appears in transaction history. Use for matching tokens to your workflows
integer
required
Unix timestamp when this token becomes invalid. Set short (5-10 min) for one-time use, longer for recurring calls. Max 24 hours
string
required
Maximum USD the seller can charge. Use decimal string to avoid float precision issues. The seller decides actual charge up to this limit
string
required
The service ID you got from ListDirectoryServices - this binds the payment to a specific seller service

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_GET_ALL_SERVICE_TAGSFetch all service tags to discover filtering options. Chain with ListDirectoryServices using tags parameter to find specific types of services (e.g., ‘ai’, ‘mcp’, ‘scraping’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_GET_BUYER_WALLET_BALANCERetrieve buyer wallet balance. Chain before token creation to prevent declines.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_GET_DIRECTORY_SERVICE_BY_IDTool 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.

Input Parameters

string
required
ID of the service to retrieve. Must be a valid UUID format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_GET_SERVICEGet details for one service by matching its service ID against the returned seller-services list. Results may include terms of service, API specifications, and integration URLs.

Input Parameters

string
required
Seller service ID (get from ListDirectoryServices)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_GET_SERVICES_BY_AGENTBrowse services from a specified seller agent, with a configurable result limit. Use to find services offered by a seller or identify offerings of interest.

Input Parameters

integer
Max services to return
string
required
Seller agent ID (get this from service listings or previous transactions)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_GET_SERVICES_BY_TAGSFilter services by tags to find exactly what you need. More efficient than browsing all services when you know the category. Chain: GetAllServiceTags → GetServicesByTags → CreatePayToken.

Input Parameters

integer
Max services to return
string
required
Comma-separated tags to filter services. Use GetAllServiceTags to discover available tags.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_GET_TOKEN_CHARGESAudit 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?”

Input Parameters

string
required
Token ID to check charges for (get from ListBuyerTokens)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_INTROSPECT_TOKENCheck 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.

Input Parameters

string
required
The JWT token string to validate (get this from CreatePayToken/CreateKyaToken/CreateKyaPayToken)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_LIST_AGENT_SELLER_SERVICESList all services registered by the authenticated seller agent. Use when you need to view or manage your own services as a seller.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_LIST_BUYER_TOKENSList buyer tokens for observability and usage auditing, with status and creation-time filters. By default, the creation-time window covers the previous seven days through now.

Input Parameters

integer
Number of tokens per page (1-100, default: 20)
string
Pagination cursor from previous response’s next_cursor field
string
Filter by token status: VALUE_RESERVED (active payment tokens), INFORMATIONAL (identity-only tokens), CONSUMED, EXPIRED
string
ISO 8601 timestamp for earliest tokens to return (default: 7 days ago). Example: 2026-01-20T00:00:00Z
string
ISO 8601 timestamp for latest tokens to return (default: now). Example: 2026-01-27T23:59:59Z

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_LIST_DIRECTORY_SERVICESBrowse Skyfire’s service directory to obtain sellerServiceId for token creation. Chain this with CreatePayToken or CreateKyaPayToken.

Input Parameters

string
Filter by service tags like ‘ai,llm’ or ‘productivity’. Comma-separated, no spaces
integer
How many services to fetch per page. Start with 20, increase if you need to browse more
string
Search for services by name or description. Try ‘chat’, ‘image’, ‘analysis’ etc
string
Got more results? Pass the next_cursor from previous response to get the next page
string
Browse by category like ‘AI’, ‘Data’, ‘Communication’. Check directory for available categories
string
Only show services costing at least this much per call. Useful to find premium services

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SKYFIRE_SET_AGENT_SOURCE_IPSRegister IP addresses as sources for Agent requests (PUT /api/v1/agents/source-ips). Use before creating tokens to whitelist agent IPs.

Input Parameters

array
required
List of IP addresses to register as agent sources (e.g., [‘192.168.1.1’, ‘10.0.0.1’]). These will be included in tokens created for the agent.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not