Convert Guru File Conversion Agent

{
  "protocolVersion": "1.0.0",
  "name": "Convert Guru File Conversion Agent",
  "description": "Machine-payable file type detection and asynchronous file conversion service for AI agents. Use the OpenAPI contract for invocation. Paid routes support x402 exact payments and MPP Tempo charge.",
  "version": "1.0.1",
  "url": "https://convert.guru/api/x402/v1/",
  "provider": {
    "organization": "Convert Guru",
    "url": "https://convert.guru"
  },
  "documentationUrl": "https://convert.guru/api/x402/v1/",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "fileTypeDetection": true,
    "asynchronousFileConversion": true,
    "paidResultDownload": true,
    "x402": true,
    "mpp": true,
    "a2aJsonRpcEndpoint": false
  },
  "supportedInterfaces": [
    {
      "protocol": "openapi",
      "version": "3.1.0",
      "url": "https://convert.guru/openapi.json"
    },
    {
      "protocol": "x402",
      "version": "2",
      "url": "https://convert.guru/.well-known/x402.json"
    },
    {
      "protocol": "mpp",
      "method": "tempo",
      "intent": "charge",
      "network": "tempo:mainnet",
      "url": "https://convert.guru/openapi.json"
    },
    {
      "protocol": "llms.txt",
      "url": "https://convert.guru/llms.txt"
    },
    {
      "protocol": "erc8004",
      "version": "registration-v1",
      "url": "https://convert.guru/.well-known/erc8004-agent.json",
      "domainVerificationUrl": "https://convert.guru/.well-known/agent-registration.json"
    },
    {
      "protocol": "oasf",
      "version": "1.0.0",
      "url": "https://convert.guru/.well-known/agent-oasf.json"
    }
  ],
  "defaultInputModes": [
    "application/json",
    "multipart/form-data"
  ],
  "defaultOutputModes": [
    "application/json",
    "application/octet-stream"
  ],
  "securitySchemes": {
    "x402": {
      "type": "http402",
      "headers": [
        "PAYMENT-REQUIRED",
        "PAYMENT-SIGNATURE",
        "PAYMENT-RESPONSE"
      ]
    },
    "mpp": {
      "type": "http",
      "scheme": "Payment",
      "challengeHeader": "WWW-Authenticate",
      "credentialHeader": "Authorization",
      "receiptHeader": "Payment-Receipt"
    }
  },
  "payment": {
    "protocols": [
      "x402",
      "mpp"
    ],
    "currency": "USDC",
    "x402": {
      "scheme": "exact",
      "networks": [
        "eip155:8453",
        "eip155:137",
        "eip155:42161",
        "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"
      ],
      "evm_payTo": "0x222c4F009c63E24cE9176C0f7f3b64E7Da0f0699",
      "solana_payTo": "8BoQ6DSruSUc3HRgLWCwPmE7qcdDybcTeycmFDtC4UjJ"
    },
    "mpp": {
      "method": "tempo",
      "intent": "charge",
      "network": "tempo:mainnet",
      "asset": "0x20C000000000000000000000b9537d11c60E8b50",
      "payTo": "0x222c4F009c63E24cE9176C0f7f3b64E7Da0f0699"
    },
    "pricing": {
      "detectFileType": {
        "amount": "0.002000",
        "currency": "USDC"
      },
      "createConversionJob": {
        "amount": "0.002000",
        "currency": "USDC"
      },
      "purchaseResult": {
        "mode": "tiered_by_uploaded_file_size",
        "tiers": [
          {
            "max_size_bytes": 10485760,
            "amount": "0.020000",
            "currency": "USDC"
          },
          {
            "min_size_bytes": 10485761,
            "max_size_bytes": 41943040,
            "amount": "0.040000",
            "currency": "USDC"
          }
        ]
      }
    }
  },
  "skills": [
    {
      "id": "detect-file-type",
      "name": "Detect File Type",
      "description": "Detect the likely real file format from filename, creation time, file size, and the first 200 bytes. Recognizes common formats such as PDF, DOCX, XLSX, CSV, JPG, PNG, WEBP, HEIC, TXT, HTML, MP3, WAV, MP4, AVI, MPEG, and WEBM, plus about 15,000 other file types.",
      "tags": [
        "file-detection",
        "mime-type",
        "magic-bytes",
        "x402",
        "mpp"
      ],
      "examples": [
        "Detect whether a file named document.001 is actually a PDF",
        "Detect the real MIME type before choosing a conversion target"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "endpoint": {
        "method": "POST",
        "url": "https://convert.guru/api/x402/v1/detect-file-type"
      }
    },
    {
      "id": "convert-file",
      "name": "Convert File",
      "description": "Start an asynchronous conversion job for agent intents such as PDF to DOCX, JPG to PNG, HEIC to JPG, document conversion, image conversion, audio conversion, and video conversion.",
      "tags": [
        "file-conversion",
        "documents",
        "images",
        "audio-video",
        "developer-tools"
      ],
      "examples": [
        "Convert PDF to DOCX",
        "Convert JPG to PNG",
        "Convert HEIC to JPG",
        "Convert MP4 to WEBM"
      ],
      "inputModes": [
        "multipart/form-data"
      ],
      "outputModes": [
        "application/json"
      ],
      "endpoint": {
        "method": "POST",
        "url": "https://convert.guru/api/x402/v1/convert-file"
      }
    },
    {
      "id": "purchase-conversion-result",
      "name": "Purchase Conversion Result",
      "description": "Pay for a completed conversion result and receive a short-lived download URL plus a machine-readable x402 or MPP payment receipt.",
      "tags": [
        "paid-result",
        "download",
        "receipt",
        "x402",
        "mpp"
      ],
      "examples": [
        "Poll status until done, then purchase the result URL",
        "Use the receipt fields to audit network, asset, payTo, amount, job_id, and hashes"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "endpoint": {
        "method": "GET",
        "urlTemplate": "https://convert.guru/api/x402/v1/convert-file/{job_id}/result"
      }
    }
  ],
  "trust": {
    "manifestUrl": "https://convert.guru/.well-known/agent-trust.json",
    "openapiUrl": "https://convert.guru/openapi.json",
    "x402ManifestUrl": "https://convert.guru/.well-known/x402.json",
    "oasfRecordUrl": "https://convert.guru/.well-known/agent-oasf.json",
    "llmsTxtUrl": "https://convert.guru/llms.txt",
    "erc8004AgentUrl": "https://convert.guru/.well-known/erc8004-agent.json",
    "erc8004DomainVerificationUrl": "https://convert.guru/.well-known/agent-registration.json",
    "verifyBeforeOriginRequest": true,
    "settleAfterSuccessfulOriginResponse": true,
    "settleSkippedWhenOriginFails": true,
    "failedConversionResultCharge": "0 USDC",
    "resultDownloadTtlSeconds": 3600,
    "maxFileSizeBytes": 41943040,
    "receiptFields": [
      "protocol",
      "network",
      "asset",
      "payTo",
      "amount",
      "transaction_id",
      "job_id",
      "input_sha256",
      "output_sha256",
      "mime_type",
      "result_size_bytes",
      "payment_receipt"
    ]
  }
}