HTTP Client

Capabilities

• • Send a request with method, headers, query, and body data
• • Apply OAuth2 and bearer token flows with renewal
• • Return JSON, text, and binary response data
• • Retry a failed request with exponential backoff
• • Read an OpenAPI description for endpoint discovery
• • Encode payloads as JSON, form data, or multipart parts

Constraints

• • Do not send credentials that the user has not provided in the session.
• • Retry at most twice, on the backoff schedule of the configuration.
• • Report a truncated body with a note.
• • Cache one OpenAPI document per session for endpoint discovery.

MCP schema

{
  "name": "http_client",
  "input": {
    "type": "object",
    "required": [
      "method",
      "url"
    ],
    "properties": {
      "url": {
        "type": "string"
      },
      "auth": {
        "enum": [
          "none",
          "bearer",
          "oauth2"
        ]
      },
      "body": {},
      "query": {
        "type": "object"
      },
      "method": {
        "enum": [
          "GET",
          "POST",
          "PUT",
          "PATCH",
          "DELETE",
          "HEAD"
        ]
      },
      "headers": {
        "type": "object"
      },
      "timeout_seconds": {
        "type": "integer"
      }
    }
  },
  "output": {
    "type": "object",
    "properties": {
      "headers": {
        "type": "object"
      },
      "body_text": {
        "type": "string"
      },
      "duration_ms": {
        "type": "integer"
      },
      "status_code": {
        "type": "integer"
      },
      "status_text": {
        "type": "string"
      }
    }
  },
  "description": "Sends one HTTP request to a remote endpoint and returns status and body."
}