Skip to main content
Glama
HTTP MCP Server

HTTP MCP Server

by jules-tnk

HTTP MCP Server

A Model Context Protocol (MCP) server that enables AI agents to send HTTP requests to any endpoint with full control over methods, headers, query parameters, and request bodies.

Note: This MCP server only supports stdio transport.

MCP Badge from LobeHub

MCP Badge

Table of Contents

Features

  • Support for major HTTP methods (GET, POST, PUT, PATCH, DELETE, QUERY)

  • Custom headers configuration

  • Query parameter handling with proper URL encoding

  • Request body support for POST/PUT/PATCH/QUERY

  • Comprehensive error handling

  • TypeScript with strict type safety

  • Clean, modular architecture

  • STDIO transport support for seamless integration with MCP clients

Installation

Install the package globally using npm:

npm install -g @jules-tnk/ts-http-mcp

Or use npx to run it directly:

npx @jules-tnk/ts-http-mcp

Configuration

Claude Desktop

Add the following configuration to your Claude Desktop config file (claude_desktop_config.json):

Windows: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Linux: ~/.config/claude/claude_desktop_config.json

{
	"mcpServers": {
		"http-mcp": {
			"command": "npx",
			"args": ["@jules-tnk/ts-http-mcp"]
		}
	}
}

After updating the configuration, restart Claude Desktop to load the MCP server.

Related MCP server: cURL MCP Server

Other MCP Clients

For other MCP clients that support stdio transport, configure them to run:

npx @jules-tnk/ts-http-mcp

Local Development

Install

pnpm install

Build

pnpm build

Run

pnpm start

Testing

To test the MCP server locally, you can run it directly and interact with it through stdio:

pnpm start

The server will start and listen for MCP protocol messages on stdin/stdout.

Usage

Once configured with your MCP client, the HTTP MCP server provides the following capabilities:

  • GET requests: Retrieve data from any HTTP endpoint

  • QUERY requests: Send safe, idempotent requests with request bodies

  • POST requests: Send data to endpoints that accept POST requests

  • PUT/PATCH requests: Update resources on remote servers

  • DELETE requests: Remove resources from remote servers

  • Custom headers: Add authentication, content-type, and other headers

  • Query parameters: Include URL parameters with proper encoding

  • Request bodies: Send JSON, form data, or raw content for supported body-capable methods

The server handles all the HTTP communication details, error handling, and response processing, making it easy for AI agents to interact with web APIs and services.

License

MIT License - see the LICENSE.md file for details.

Available Tools

1 tool
send_http_requestB

Send an HTTP request to any endpoint with custom headers, query parameters, and body

Inputs: url (required), method (required), body, headers, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion between tools. The tool's purpose is clear and unambiguous.

    Naming Consistency5/5

    The single tool follows a clear verb_noun convention, and the name accurately describes its function. Consistency is trivially maintained.

    Tool Count4/5

    One tool is appropriate for a server dedicated solely to HTTP requests. While the count is below the typical range, it is not excessive or deficient for the narrow scope.

    Completeness5/5

    The tool supports full HTTP request customization, covering all methods and parameters. There are no obvious missing operations within the domain of making HTTP requests.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables automatic HTTP requests (GET, POST, PUT, DELETE, etc.) with JSON validation and proxy support. Supports custom headers, request bodies, and environment variable configuration for seamless API integration.
      1
      1 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables LLMs to make HTTP requests using structured cURL commands with support for multiple authentication methods, custom headers, and comprehensive request/response control.
      2
      8 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to make arbitrary HTTP API requests with any method and full control over headers, query parameters, and body.
      7 npm
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables HTTP requests and web data extraction via natural language, acting as an AI-era curl.
      GPL 3.0