agents.suedeai.ai

{
  "name": "find_services",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search Suede's shelf of published AI services by the job you need done. Returns matching services with their per-call price and whether each one can be previewed free or bought right now. Start here, then call get_service for the full contract before spending anything.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "required": [
      "need"
    ],
    "properties": {
      "need": {
        "type": "string",
        "description": "The job to be done, in plain language. Example: review a vendor contract for renewal risk."
      },
      "limit": {
        "type": "number",
        "description": "How many services to return. Defaults to 5, capped at 10."
      }
    }
  },
  "page": "/agents"
}

{
  "name": "get_service",
  "kind": "answer",
  "impl": "imperative",
  "description": "Read the full contract for one service before spending: exact per-call price, the input fields it requires, what it returns, whether a human reviews the result, and how it handles your data. Call this after find_services and before preview_service or buy_service.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "required": [
      "slug"
    ],
    "properties": {
      "slug": {
        "type": "string",
        "description": "Exact service slug from find_services. Not a name or a title."
      }
    }
  },
  "page": "/agents"
}

{
  "name": "preview_service",
  "kind": "act",
  "impl": "imperative",
  "description": "Run a service in free dry-run mode to check it fits before paying. Returns the shape of a real result without charging and without calling any model. Not every service offers a preview; get_service reports which do. This records a run on your workspace, so it is not a read-only call.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "required": [
      "slug",
      "input"
    ],
    "properties": {
      "slug": {
        "type": "string",
        "description": "Exact service slug from find_services. Not a name or a title."
      },
      "input": {
        "type": "object",
        "additionalProperties": true,
        "description": "Fields matching the service's input contract, exactly as get_service reports it."
      }
    }
  },
  "page": "/agents"
}

{
  "name": "buy_service",
  "kind": "transact",
  "impl": "imperative",
  "description": "Buy one real call of a service. SPENDS prepaid credit from the signed-in workspace and returns the finished result. Echo the price you agreed to in confirmedPriceUsdc; if it no longer matches the listed price the call is refused rather than charged. Fails when the balance is short — top up at /pricing. Preview first if you have not.",
  "inputSchema": {
    "type": "object",
    "additionalProperties": false,
    "required": [
      "slug",
      "input",
      "confirmedPriceUsdc"
    ],
    "properties": {
      "slug": {
        "type": "string",
        "description": "Exact service slug from find_services. Not a name or a title."
      },
      "input": {
        "type": "object",
        "additionalProperties": true,
        "description": "Fields matching the service's input contract, exactly as get_service reports it."
      },
      "confirmedPriceUsdc": {
        "type": "number",
        "description": "The exact per-call price you agreed to. A mismatch refuses the call instead of charging."
      }
    }
  },
  "page": "/agents"
}