# Skyfire AI integration on Definable

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

## What this connects

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

Vendor: https://skyfire.xyz

## Tools available

**16** tools available. First 12:

- `SKYFIRE_CHARGE_TOKEN` — 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
- `SKYFIRE_CREATE_KYA_PAY_TOKEN` — Create Skyfire KYA+PAY Token — Issue a Skyfire KYA+PAY token (POST /api/v1/tokens with type=kya+pay).
- `SKYFIRE_CREATE_KYA_TOKEN` — Create Skyfire KYA Token — Issue a Skyfire KYA token (POST /api/v1/tokens with type=kya).
- `SKYFIRE_CREATE_PAY_TOKEN` — Create Skyfire PAY Token — Issue a Skyfire PAY token (POST /api/v1/tokens with type=pay).
- `SKYFIRE_GET_ALL_SERVICE_TAGS` — 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').
- `SKYFIRE_GET_BUYER_WALLET_BALANCE` — Get Skyfire Buyer Wallet Balance — Retrieve buyer wallet balance. Chain before token creation to prevent declines.
- `SKYFIRE_GET_DIRECTORY_SERVICE_BY_ID` — 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.
- `SKYFIRE_GET_SERVICE` — 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.
- `SKYFIRE_GET_SERVICES_BY_AGENT` — 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.
- `SKYFIRE_GET_SERVICES_BY_TAGS` — 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.
- `SKYFIRE_GET_TOKEN_CHARGES` — 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?"
- `SKYFIRE_INTROSPECT_TOKEN` — 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.

## Auth

Auth schemes: `API_KEY`.

## How agents use Skyfire

Inside a Definable workflow, Skyfire is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Skyfire** — the Researcher (GPT-5.5) pulls context from Skyfire (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Skyfire** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Skyfire (create record, post message, draft email).
- **Designer / Engineer → Distributor → Skyfire** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Skyfire (attach file, open PR comment, post status).

The Verifier checks every Skyfire call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- ai agents — https://definable.ai/apps/category/ai-agents/
- payment processing — https://definable.ai/apps/category/payment-processing/

## Related

- HTML page: https://definable.ai/apps/skyfire/
- Same category (ai agents): https://definable.ai/apps/category/ai-agents/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt