{
  "info": {
    "name": "Skyfire — mcp.ai",
    "description": "REST API for the Skyfire MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/skyfire",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "skyfire_charge_token",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/charge/token",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "charge",
            "token"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"token\": \"\",\n  \"chargeAmount\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_create_kya_pay_token",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/kya/pay/token",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "kya",
            "pay",
            "token"
          ]
        },
        "description": "Issue a Skyfire KYA+PAY token (POST /api/v1/tokens with type=kya+pay).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"buyerTag\": \"\",\n  \"expiresAt\": 0,\n  \"tokenAmount\": \"\",\n  \"sellerServiceId\": \"\",\n  \"identityPermissions\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_create_kya_token",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/kya/token",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "kya",
            "token"
          ]
        },
        "description": "Issue a Skyfire KYA token (POST /api/v1/tokens with type=kya).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"buyerTag\": \"\",\n  \"expiresAt\": 0,\n  \"sellerServiceId\": \"\",\n  \"identityPermissions\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_create_pay_token",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/pay/token",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "pay",
            "token"
          ]
        },
        "description": "Issue a Skyfire PAY token (POST /api/v1/tokens with type=pay).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"buyerTag\": \"\",\n  \"expiresAt\": 0,\n  \"tokenAmount\": \"\",\n  \"sellerServiceId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_get_all_service_tags",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/all/service/tags",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "all",
            "service",
            "tags"
          ]
        },
        "description": "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').",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_get_buyer_wallet_balance",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/buyer/wallet/balance",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "buyer",
            "wallet",
            "balance"
          ]
        },
        "description": "Retrieve buyer wallet balance. Chain before token creation to prevent declines.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_get_directory_service_by_id",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/directory/service/by/id",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "directory",
            "service",
            "by",
            "id"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"serviceId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_get_service",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/service",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "service"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"serviceId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_get_services_by_agent",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/services/by/agent",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "services",
            "by",
            "agent"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"agentId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_get_services_by_tags",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/services/by/tags",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "services",
            "by",
            "tags"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"commaDelimitedTags\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_get_token_charges",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/token/charges",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "token",
            "charges"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"tokenId\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_introspect_token",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/introspect/token",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "introspect",
            "token"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"token\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_list_agent_seller_services",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/agent/seller/services",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "agent",
            "seller",
            "services"
          ]
        },
        "description": "List all services registered by the authenticated seller agent. Use when you need to view or manage your own services as a seller.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_list_buyer_tokens",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/buyer/tokens",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "buyer",
            "tokens"
          ]
        },
        "description": "Inspect buyer tokens for observability. Chain with transactions to audit usage.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"cursor\": \"\",\n  \"status\": \"\",\n  \"createdAfter\": \"\",\n  \"createdBefore\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_list_directory_services",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/directory/services",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "directory",
            "services"
          ]
        },
        "description": "Browse Skyfire's service directory to obtain `sellerServiceId` for token creation. Chain this with CreatePayToken or CreateKyaPayToken.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tags\": \"\",\n  \"limit\": 0,\n  \"query\": \"\",\n  \"cursor\": \"\",\n  \"category\": \"\",\n  \"minPrice\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "skyfire_set_agent_source_ips",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/set/agent/source/ips",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "set",
            "agent",
            "source",
            "ips"
          ]
        },
        "description": "Register IP addresses as sources for Agent requests (PUT /api/v1/agents/source-ips). Use before creating tokens to whitelist agent IPs.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"source_ips\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}