cURL MCP Server

Execute an HTTP request using cURL with structured parameters.

This tool provides a safe, structured way to make HTTP requests with common cURL options. It handles URL encoding, header formatting, and response processing automatically.

Args:

• url (string, required): The URL to request

• method (string): HTTP method - GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS

• headers (object): HTTP headers as key-value pairs

• data (string): Request body for POST/PUT/PATCH requests

• form (object): Form data as key-value pairs (multipart/form-data)

• follow_redirects (boolean): Follow HTTP redirects (default: true)

• max_redirects (number): Maximum redirects to follow (0-50)

• insecure (boolean): Skip SSL verification (default: false)

• timeout (number): Request timeout in seconds (1-300, default: 30)

• user_agent (string): Custom User-Agent header

• basic_auth (string): Basic auth as "username:password"

• bearer_token (string): Bearer token for Authorization header

• verbose (boolean): Include verbose request/response details

• include_headers (boolean): Include response headers in output

• compressed (boolean): Request compressed response (default: true)

• include_metadata (boolean): Wrap response in JSON with metadata

Returns: The HTTP response body, or JSON with metadata if include_metadata is true: { "success": boolean, "exit_code": number, "response": string, "stderr": string (if present) }

Examples:

• Simple GET: { "url": "https://api.example.com/data" }

• POST JSON: { "url": "https://api.example.com/users", "method": "POST", "headers": {"Content-Type": "application/json"}, "data": "{"name": "John"}" }

• With auth: { "url": "https://api.example.com/secure", "bearer_token": "your-token-here" }

Error Handling:

• Returns error message if cURL fails or times out

• Exit code 0 indicates success

• Non-zero exit codes indicate various cURL errors