@customable/http-mcp (1.0.5)

Published 2025-10-07 17:11:44 +02:00 by jack in customable-mcp/http-mcp

Installation

@customable:registry=
npm install @customable/http-mcp@1.0.5
"@customable/http-mcp": "1.0.5"

About this package

🌐 http-mcp

MCP Server for HTTP requests and API testing.

Features

HTTP Methods

  • 🌐 request - Generic HTTP request (GET, POST, PUT, DELETE, PATCH)
  • 📊 get_json - GET request expecting JSON
  • 📝 post_json - POST JSON data
  • 🍪 request_with_cookies - Request with custom cookies

Authentication

  • 🔐 Auth profiles (Basic, Bearer, OAuth)
  • 🔑 API key support
  • 🍪 Cookie management
  • 📋 Header templates

Advanced Features

  • 💾 Response caching
  • 🔄 Automatic retry with exponential backoff
  • ⏱️ Timeout management
  • 📊 Request/Response logging
  • 🔍 Response validation

Profiles

Save common configurations as profiles for quick access.

Installation

npm install
npm run build

Configuration

Set environment variables:

  • HTTP_TIMEOUT - Default timeout in ms (default: 30000)
  • HTTP_CACHE_TTL - Cache TTL in seconds (default: 300)

Usage

npm start

Examples

Simple GET request

{
  "url": "https://api.example.com/users",
  "method": "GET"
}

POST with authentication

{
  "url": "https://api.example.com/users",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer token123"
  },
  "body": {
    "name": "John Doe"
  }
}

License

MIT

Dependencies

Dependencies

ID Version
@modelcontextprotocol/sdk ^0.5.0
zod ^3.23.8

Development dependencies

ID Version
@types/node ^22.0.0
typescript ^5.5.0

Keywords

mcp http api rest mcp-server
Details
npm
2025-10-07 17:11:44 +02:00
1
Customable Team
MIT
10 KiB
Assets (1)
Versions (2) View all
2.0.1 2025-10-10
1.0.5 2025-10-07