# Skyfire

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

- **Category:** ai agents
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 16
- **Triggers:** 0
- **Slug:** `SKYFIRE`
- **Version:** 20260429_00

## Tools

### 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

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

### Create Skyfire KYA Token

**Slug:** `SKYFIRE_CREATE_KYA_TOKEN`

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

### Create Skyfire PAY Token

**Slug:** `SKYFIRE_CREATE_PAY_TOKEN`

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

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

### Get Skyfire Buyer Wallet Balance

**Slug:** `SKYFIRE_GET_BUYER_WALLET_BALANCE`

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

### 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.

### Get Skyfire Service Details

**Slug:** `SKYFIRE_GET_SERVICE`

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

**Slug:** `SKYFIRE_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

**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.

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

### 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.

### 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.

### List Skyfire Buyer Tokens

**Slug:** `SKYFIRE_LIST_BUYER_TOKENS`

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

### 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.

### 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.