Using the Skyfire MCP Server

Operations that can be performed with the Skyfire MCP server

Connect

  • Connect to the MCP server and retrieve an MCP session ID. You will need this for subsequent calls to the MCP server, for example
  • curl -k -v -X POST https://mcp.skyfire.xyz/mcp -d '{"jsonrpc": "2.0", "id": "101", "method": "initialize", "params": {"protocolVersion": "123", "capabilities": {}, "clientInfo": {"name": "curl", "version": "123"}}}' -H "Content-Type: application/json" -H "skyfire-api-key: <BUYER AGENT'S SKYFIRE API KEY>" -H "Accept: application/json, text/event-stream"
    
  • Extract the mcp-session-id from the response, for example
  • curl -k -v -X POST https://mcp.skyfire.xyz/mcp -d '{"jsonrpc": "2.0", "id": "102", "method": "initialize", "params": {"protocolVersion": "123", "capabilities": {}, "clientInfo": {"name": "curl", "version": "123"}}}' -H "Content-Type: application/json" -H "skyfire-api-key: <BUYER AGENT'S SKYFIRE API KEY>" -H "Accept: application/json, text/event-stream" 2>&1 | grep -i Mcp-Session-Id | awk '{print $NF}' | tr -d '\n\r'
    

List tools

  • Optionally list the available tools, for example
  • curl -k -v -X POST https://mcp.skyfire.xyz/mcp -d '{"jsonrpc": "2.0", "id": "103", "method": "tools/list", "params": {}}' -H "Content-Type: application/json" -H "skyfire-api-key: <BUYER AGENT'S SKYFIRE API KEY>" -H "Accept: application/json, text/event-stream" -H "Mcp-session-id: <BUYER AGENT'S MCP SESSION ID>"
    

Call tools

  • find-sellers, for example
  • curl -k -v -X POST https://mcp.skyfire.xyz/mcp -d '{"jsonrpc": "2.0", "id": "104", "method": "tools/call", "params": {"protocolVersion": "123", "name": "find-sellers", "arguments": {}, "capabilities": {}, "clientInfo": {"name": "curl", "version": "123"}}}' -H "Content-Type: application/json" -H "skyfire-api-key: <BUYER AGENT'S SKYFIRE API KEY>" -H "Accept: application/json, text/event-stream" -H "Mcp-session-id: <BUYER AGENT'S MCP SESSION ID>"
    
  • create-kya-token, for example
  • curl -k -v -X POST https://mcp.skyfire.xyz/mcp -d '{"jsonrpc": "2.0", "id": "105", "method": "tools/call", "params": {"protocolVersion": "123", "name": "create-kya-token", "arguments": {"buyerTag": "<BUYER'S INTERNAL TRANSACTION ID>", "sellerServiceId": "<SELLER SERVICE ID>"}, "capabilities": {}, "clientInfo": {"name": "curl", "version": "123"}}}' -H "Content-Type: application/json" -H "skyfire-api-key: <BUYER AGENT'S SKYFIRE API KEY>" -H "Accept: application/json, text/event-stream" -H "Mcp-session-id: <BUYER AGENT'S MCP SESSION ID>"
    
  • create-pay-token, for example
  • curl -k -v -X POST https://mcp.skyfire.xyz/mcp -d '{"jsonrpc": "2.0", "id": "106", "method": "tools/call", "params": {"protocolVersion": "123", "name": "create-pay-token", "arguments": {"buyerTag": "<BUYER'S INTERNAL TRANSACTION ID>", "amount": "<AMOUNT IN USD>", "sellerServiceId": "<SELLER SERVICE ID>"}, "capabilities": {}, "clientInfo": {"name": "curl", "version": "123"}}}' -H "Content-Type: application/json" -H "skyfire-api-key: <BUYER AGENT'S SKYFIRE API KEY>" -H "Accept: application/json, text/event-stream" -H "Mcp-session-id: <BUYER AGENT'S MCP SESSION ID>"
    
  • create-kya-payment-token, for example
  • curl -k -v -X POST https://mcp.skyfire.xyz/mcp -d '{"jsonrpc": "2.0", "id": "107", "method": "tools/call", "params": {"protocolVersion": "123", "name": "create-kya-payment-token", "arguments": {"buyerTag": "<BUYER'S INTERNAL TRANSACTION ID>", "amount": "<AMOUNT IN USD>", "sellerServiceId": "<SELLER SERVICE ID>"}, "capabilities": {}, "clientInfo": {"name": "curl", "version": "123"}}}' -H "Content-Type: application/json" -H "skyfire-api-key: <BUYER AGENT'S SKYFIRE API KEY>" -H "Accept: application/json, text/event-stream" -H "Mcp-session-id: <BUYER AGENT'S MCP SESSION ID>"
    

Connect to the Skyfire MCP server from Claude Desktop

  • Open claude_desktop_config.json from Settings and add the following configuration
  • {
        "mcpServers": {
            "skyfire": {
                "command": "npx",
                "args": [
                    "-y",
                    "mcp-remote",
                    "https://mcp.skyfire.xyz/mcp",
                    "--header",
                    "skyfire-api-key: <BUYER AGENT'S SKYFIRE API KEY>"
                ]
            }
        }
    }
    
  • Restart Claude Desktop