Skip to main content

HTTP / REST

Make arbitrary HTTP requests from your agent. Call any REST API with configurable headers, base URL, timeout, and response truncation.

Quick Start


Config

string
Base URL prepended to relative paths (e.g. "https://api.example.com").
Record<string, string>
Default headers included in every request.
number
default:"30000"
Request timeout in milliseconds.
number
default:"20000"
Max response body characters to return. Larger responses are truncated.

Tools


Tool Usage Examples

GET Request

POST Request

Error Handling

The tool returns the full HTTP response including status code, so the agent can interpret errors:

Response Truncation

Large API responses are automatically truncated to maxResponseSize (default 20,000 characters). Combine with toolResultLimit for further control: