Skip to main content
Glama

Qumge: Agent Capabilities & Skills

call_cap

Call a Cap on the user's behalf and return its response. Use this when you cannot make the HTTP call yourself: qumge charges the user's qumge balance and forwards the call at the same price as calling it over HTTP through Qumge. Operations and prices come from get_cap. Prefer operation + input: when the operation declares an input_schema, input is validated against it before anything is charged or forwarded. Needs the user's qumge key in the Authorization header. A 5xx from the Cap is free; a 402 means the user's balance or this Cap's monthly limit stopped it. (Older clients may still call this tool as call_app — it still works.)

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
bodyNoRequest body. An object is sent as JSON; a string is sent as-is.
pathNoThe route path from get_cap, e.g. '/api/videos'. A query string may be appended or passed separately in `query`.
slugYesThe Cap's slug, from search_caps.
inputNoArguments for the operation. Validated against its input_schema when it has one — an invalid input is refused as a tool error (isError), and nothing is charged or forwarded.
queryNoQuery string without the leading '?'.
acceptNoOptional Accept header.
methodNoHTTP method. Default GET — the routes and their methods are in get_cap.
operationNoOperation name from get_cap (a route's `name`). Use with `input`; takes precedence over `path`/`method` when both are given.
qumge_keyNoOptional: your Qumge API key, for clients that cannot set an Authorization header. Takes precedence over the header. Never echoed back.
content_typeNoOnly needed when `body` is a string and the app expects a specific type.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
bodyYes
pathYes
binaryNo
methodYes
statusYes
call_idNo
free_callNoSet when this call used one of the operation's free calls (users who have topped up).
truncatedNo
body_bytesNo
direct_urlNo
content_typeNo
charged_micro_usdNo
remaining_micro_usdNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / slug / description
      Previous value: -"The cap's slug, from search_caps."New value: +"The Cap's slug, from search_caps."
  2. Changed1 schema field changed
    • changedInput schema / properties / input / description
      Previous value: -"Arguments for the operation. Validated against its input_schema when it has one — an invalid input is refused with 422, and nothing is charged or forwarded."New value: +"Arguments for the operation. Validated against its input_schema when it has one — an invalid input is refused as a tool error (isError), and nothing is charged or forwarded."
  3. Changed1 schema field changed
    • addedOutput schema / properties / free_call
      Added value: +{
      +  "description": "Set when this call used one of the operation's free calls (users who have topped up).",
      +  "properties": {
      +    "limit": {
      +      "type": "integer"
      +    },
      +    "pending": {
      +      "type": "boolean"
      +    },
      +    "remaining": {
      +      "type": "integer"
      +    },
      +    "used": {
      +      "type": "integer"
      +    }
      +  },
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
  4. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "binary": {
      +      "type": "boolean"
      +    },
      +    "body": {
      +      "type": "string"
      +    },
      +    "body_bytes": {
      +      "type": "integer"
      +    },
      +    "call_id": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "charged_micro_usd": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "content_type": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "direct_url": {
      +      "type": "string"
      +    },
      +    "method": {
      +      "type": "string"
      +    },
      +    "path": {
      +      "type": "string"
      +    },
      +    "remaining_micro_usd": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "status": {
      +      "type": "integer"
      +    },
      +    "truncated": {
      +      "type": "boolean"
      +    }
      +  },
      +  "required": [
      +    "status",
      +    "method",
      +    "path",
      +    "body"
      +  ],
      +  "type": "object"
      +}
  5. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources