Skyfire

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

16 actions Integration catalog

Request access

Connect Skyfire once you're in Boring.

01 · WHAT THE AGENT CAN DO

Actions

Every capability is a discrete, logged action the agent calls by name — scoped to what you authorize and recorded in the run trace.

Charge Skyfire TokenSKYFIRE_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 TokenSKYFIRE_CREATE_KYA_PAY_TOKEN

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

Create Skyfire KYA TokenSKYFIRE_CREATE_KYA_TOKEN

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

Create Skyfire PAY TokenSKYFIRE_CREATE_PAY_TOKEN

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

Get All Service TagsSKYFIRE_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 BalanceSKYFIRE_GET_BUYER_WALLET_BALANCE

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

Get Directory Service By IDSKYFIRE_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 DetailsSKYFIRE_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 AgentSKYFIRE_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 TagsSKYFIRE_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 ChargesSKYFIRE_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 TokenSKYFIRE_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 ServicesSKYFIRE_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 TokensSKYFIRE_LIST_BUYER_TOKENS

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

List Skyfire Directory ServicesSKYFIRE_LIST_DIRECTORY_SERVICES

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

Set Agent Source IP AddressesSKYFIRE_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.