Which integrations are available for this server?

Enables execution of HTTP requests through a structured interface with support for multiple authentication methods, custom headers, form data, request body data, and response control options like redirects and compression.

How do I use cURL MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type `@` followed by the MCP server name and your instructions, e.g., "`@cURL MCP Server` fetch the latest posts from the Reddit API with a custom user agent" That's it! The server will respond to your query, and you can continue using it as needed. Here is a [step-by-step guide with screenshots](https://glama.ai/blog/2025-07-08-how-to-install-and-use-mcp-servers).

cURL MCP Server

An MCP (Model Context Protocol) server that enables LLMs to execute cURL commands for making HTTP requests.

Features

Structured HTTP Requests: Use curl_execute with typed parameters for safe, validated HTTP calls
Multiple Auth Methods: Basic auth, Bearer tokens, and custom headers
Response Control: Follow redirects, include headers, compressed responses
Error Handling: Clear error messages with exit codes and metadata
Built-in Documentation: MCP resources and prompts for discoverability
Dual Transport: Supports both stdio (for Claude Desktop/Code) and HTTP transports

Installation

npm install npm run build

Usage

With Claude Code

The easiest way is to install directly from GitHub using npx:

{ "mcpServers": { "curl": { "command": "npx", "args": ["-y", "github:sixees/mcp-curl"] } } }

Or with a local clone:

{ "mcpServers": { "curl": { "command": "node", "args": ["/path/to/mcp-curl/dist/index.js"] } } }

With Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "curl": { "command": "npx", "args": ["-y", "github:sixees/mcp-curl"] } } }

Standalone Usage

Stdio Transport (Default):

npm start # or node dist/index.js

HTTP Transport:

TRANSPORT=http PORT=3000 npm start

Tools

`curl_execute`

Execute HTTP requests with structured parameters. This is the only tool available, providing a safe, validated interface for HTTP requests.

Parameters:

Parameter	Type	Required	Default	Description
`url`	string	Yes	-	The URL to request
`method`	string	No	GET	HTTP method (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS)
`headers`	object	No	-	HTTP headers as key-value pairs
`data`	string	No	-	Request body data
`form`	object	No	-	Form data as key-value pairs
`follow_redirects`	boolean	No	true	Follow HTTP redirects
`max_redirects`	number	No	-	Maximum redirects to follow (0-50)
`insecure`	boolean	No	false	Skip SSL certificate verification
`timeout`	number	No	30	Request timeout in seconds (1-300)
`user_agent`	string	No	-	Custom User-Agent header
`basic_auth`	string	No	-	Basic auth as "username:password"
`bearer_token`	string	No	-	Bearer token for Authorization
`verbose`	boolean	No	false	Include verbose output
`include_headers`	boolean	No	false	Include response headers
`compressed`	boolean	No	true	Request compressed response
`include_metadata`	boolean	No	false	Wrap response in JSON metadata

Examples:

// Simple GET request { "url": "https://api.github.com/users/octocat" } // POST with JSON body { "url": "https://api.example.com/users", "method": "POST", "headers": { "Content-Type": "application/json" }, "data": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}" } // With Bearer token authentication { "url": "https://api.example.com/protected", "bearer_token": "your-access-token" } // Form submission { "url": "https://example.com/upload", "method": "POST", "form": { "field1": "value1", "field2": "value2" } }

MCP Resources

The server exposes documentation as an MCP resource:

curl://docs/api - API documentation with parameter reference and examples

MCP Prompts

Two prompts are available for common use cases:

api-test - Test an API endpoint and analyze the response
api-discovery - Explore a REST API to discover available endpoints

Security Considerations

Only structured curl_execute is available (no arbitrary command execution)
All parameters are validated using Zod schemas
Commands are executed without shell interpretation to prevent injection
Maximum response size: 1MB (stdout and stderr)
Default timeout: 30 seconds
SSL verification is enabled by default (use insecure: true only when necessary)