> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Skyfire

> Skyfire enables AI agents to autonomously transact and pay for services, creating a seamless payment infrastructure for AI applications.

![Skyfire logo](https://mintcdn.com/composio-preview/B09iGux45A5cYDuO/images/toolkits/skyfire.svg?fit=max\&auto=format\&n=B09iGux45A5cYDuO\&q=85\&s=0bb4047812f0e06931c098b6eaecb20c)

* **Category:** ai agents
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 16
* **Triggers:** 0
* **Slug:** `SKYFIRE`
* **Version:** 20261101\_00

## Tools

> [accordion] Charge Skyfire Token
>
> **Slug:** `SKYFIRE_CHARGE_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
>
> #### Input Parameters
>
> **token** `string` *required*
>
> The JWT token string the buyer sent you (not the tokenId)
>
> **chargeAmount** `string` *required*
>
> Amount to charge (must be \<= token's max amount)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Skyfire KYA+PAY Token
>
> **Slug:** `SKYFIRE_CREATE_KYA_PAY_TOKEN`
>
> Issue a Skyfire KYA+PAY token (POST /api/v1/tokens with type=kya+pay).
>
> #### Input Parameters
>
> **buyerTag** `string`
>
> Optional tag for buyer-side tracking
>
> **expiresAt** `integer` *required*
>
> Unix timestamp (seconds) when token expires
>
> **tokenAmount** `string` *required*
>
> Maximum amount the seller may charge (as decimal string)
>
> **sellerServiceId** `string` *required*
>
> UUID of the seller service to call
>
> **identityPermissions** `array`
>
> Optional list of identity permission scopes required by seller (e.g., \['email', 'name'])
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Skyfire KYA Token
>
> **Slug:** `SKYFIRE_CREATE_KYA_TOKEN`
>
> Issue a Skyfire KYA token (POST /api/v1/tokens with type=kya).
>
> #### Input Parameters
>
> **buyerTag** `string`
>
> Optional tag for buyer-side tracking
>
> **expiresAt** `integer` *required*
>
> Unix timestamp (seconds) when token expires
>
> **sellerServiceId** `string` *required*
>
> UUID of the seller service to call
>
> **identityPermissions** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Skyfire PAY Token
>
> **Slug:** `SKYFIRE_CREATE_PAY_TOKEN`
>
> Issue a Skyfire PAY token (POST /api/v1/tokens with type=pay).
>
> #### Input Parameters
>
> **buyerTag** `string`
>
> Your internal reference for tracking - appears in transaction history. Use for matching tokens to your workflows
>
> **expiresAt** `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
>
> **tokenAmount** `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
>
> **sellerServiceId** `string` *required*
>
> The service ID you got from ListDirectoryServices - this binds the payment to a specific seller service
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get All Service Tags
>
> **Slug:** `SKYFIRE_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').
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Skyfire Buyer Wallet Balance
>
> **Slug:** `SKYFIRE_GET_BUYER_WALLET_BALANCE`
>
> Retrieve buyer wallet balance. Chain before token creation to prevent declines.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Directory Service By ID
>
> **Slug:** `SKYFIRE_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.
>
> #### Input Parameters
>
> **serviceId** `string` *required*
>
> ID of the service to retrieve. Must be a valid UUID format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Skyfire Service Details
>
> **Slug:** `SKYFIRE_GET_SERVICE`
>
> Get 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
>
> **serviceId** `string` *required*
>
> Seller service ID (get from ListDirectoryServices)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Services by Agent
>
> **Slug:** `SKYFIRE_GET_SERVICES_BY_AGENT`
>
> Browse 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
>
> **limit** `integer`
>
> Max services to return
>
> **agentId** `string` *required*
>
> Seller agent ID (get this from service listings or previous transactions)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Services by Tags
>
> **Slug:** `SKYFIRE_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.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Max services to return
>
> **commaDelimitedTags** `string` *required*
>
> Comma-separated tags to filter services. Use GetAllServiceTags to discover available tags.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Skyfire Token Charges
>
> **Slug:** `SKYFIRE_GET_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?"
>
> #### Input Parameters
>
> **tokenId** `string` *required*
>
> Token ID to check charges for (get from ListBuyerTokens)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Introspect Skyfire Token
>
> **Slug:** `SKYFIRE_INTROSPECT_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.
>
> #### Input Parameters
>
> **token** `string` *required*
>
> The JWT token string to validate (get this from CreatePayToken/CreateKyaToken/CreateKyaPayToken)
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Agent Seller Services
>
> **Slug:** `SKYFIRE_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.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Skyfire Buyer Tokens
>
> **Slug:** `SKYFIRE_LIST_BUYER_TOKENS`
>
> List 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
>
> **limit** `integer`
>
> Number of tokens per page (1-100, default: 20)
>
> **cursor** `string`
>
> Pagination cursor from previous response's next\_cursor field
>
> **status** `string`
>
> Filter by token status: VALUE\_RESERVED (active payment tokens), INFORMATIONAL (identity-only tokens), CONSUMED, EXPIRED
>
> **createdAfter** `string`
>
> ISO 8601 timestamp for earliest tokens to return (default: 7 days ago). Example: 2026-01-20T00:00:00Z
>
> **createdBefore** `string`
>
> ISO 8601 timestamp for latest tokens to return (default: now). Example: 2026-01-27T23:59:59Z
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Skyfire Directory Services
>
> **Slug:** `SKYFIRE_LIST_DIRECTORY_SERVICES`
>
> Browse Skyfire's service directory to obtain `sellerServiceId` for token creation. Chain this with CreatePayToken or CreateKyaPayToken.
>
> #### Input Parameters
>
> **tags** `string`
>
> Filter by service tags like 'ai,llm' or 'productivity'. Comma-separated, no spaces
>
> **limit** `integer`
>
> How many services to fetch per page. Start with 20, increase if you need to browse more
>
> **query** `string`
>
> Search for services by name or description. Try 'chat', 'image', 'analysis' etc
>
> **cursor** `string`
>
> Got more results? Pass the next\_cursor from previous response to get the next page
>
> **category** `string`
>
> Browse by category like 'AI', 'Data', 'Communication'. Check directory for available categories
>
> **minPrice** `string`
>
> Only show services costing at least this much per call. Useful to find premium services
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set Agent Source IP Addresses
>
> **Slug:** `SKYFIRE_SET_AGENT_SOURCE_IPS`
>
> Register IP addresses as sources for Agent requests (PUT /api/v1/agents/source-ips). Use before creating tokens to whitelist agent IPs.
>
> #### Input Parameters
>
> **source\_ips** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
