# Skyfire — how to use (mcp.ai)

Connect your Skyfire account and use 16 tools for AI agents straight from your AI agent. Connect with your own API key. Skyfire enables AI agents to autonomously transact and pay for services, creating a seamless payment infrastructure for AI applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_skyfire?ms=1787291520000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `skyfire_charge_token`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/skyfire`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/skyfire/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/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, y
  - body: { token: string, chargeAmount: string }
- `POST https://api.mcp.ai/api/skyfire/create/kya/pay/token` — Issue a Skyfire KYA+PAY token (POST /api/v1/tokens with type=kya+pay).
  - body: { buyerTag?: string, expiresAt: integer, tokenAmount: string, sellerServiceId: string, identityPermissions?: string[] }
- `POST https://api.mcp.ai/api/skyfire/create/kya/token` — Issue a Skyfire KYA token (POST /api/v1/tokens with type=kya).
  - body: { buyerTag?: string, expiresAt: integer, sellerServiceId: string, identityPermissions?: string[] }
- `POST https://api.mcp.ai/api/skyfire/create/pay/token` — Issue a Skyfire PAY token (POST /api/v1/tokens with type=pay).
  - body: { buyerTag?: string, expiresAt: integer, tokenAmount: string, sellerServiceId: string }
- `POST https://api.mcp.ai/api/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').
- `POST https://api.mcp.ai/api/skyfire/get/buyer/wallet/balance` — Retrieve buyer wallet balance. Chain before token creation to prevent declines.
- `POST https://api.mcp.ai/api/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.
  - body: { serviceId: string }
- `POST https://api.mcp.ai/api/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.
  - body: { serviceId: string }
- `POST https://api.mcp.ai/api/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.
  - body: { limit?: integer, agentId: string }
- `POST https://api.mcp.ai/api/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.
  - body: { limit?: integer, commaDelimitedTags: string }
- `POST https://api.mcp.ai/api/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?"
  - body: { tokenId: string }
- `POST https://api.mcp.ai/api/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 debuggin
  - body: { token: string }
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/skyfire/list/buyer/tokens` — Inspect buyer tokens for observability. Chain with transactions to audit usage.
  - body: { limit?: integer, cursor?: string, status?: string, createdAfter?: string, createdBefore?: string }
- `POST https://api.mcp.ai/api/skyfire/list/directory/services` — Browse Skyfire's service directory to obtain `sellerServiceId` for token creation. Chain this with CreatePayToken or CreateKyaPayToken.
  - body: { tags?: string, limit?: integer, query?: string, cursor?: string, category?: string, minPrice?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { source_ips: string[] }

## Example prompts
- "What can I do in Skyfire?"
- "Show me a summary of my Skyfire account"

## More
- Page: https://mcp.ai/skyfire
- Agent spec (llms.txt): https://mcp.ai/skyfire/llms.txt
- Postman collection: https://mcp.ai/skyfire/postman.json