# Web Request MCP Server

Execute HTTP requests via MCP (Model Context Protocol)

This is a TypeScript-based MCP server that provides a flexible tool to execute HTTP requests with custom methods, headers, and body content. It enables AI assistants to interact with web APIs and endpoints seamlessly.

## Features

### `http_request`

A versatile tool for making HTTP requests with full control over all parameters.

- **Purpose**: Execute HTTP requests with custom configuration
- **Parameters**:
  - `url` (required): The target URL (e.g., "https://api.example.com/endpoint")
  - `method` (optional): HTTP method - GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS (defaults to GET)
  - `headers` (optional): Custom headers as key-value pairs
  - `body` (optional): Request body (string or object, automatically JSON stringified for objects)
  - `params` (optional): URL query parameters as key-value pairs
- **Behavior**:
  - Automatic Content-Type detection for JSON bodies
  - Response truncation for large responses (max 50,000 characters)
  - Comprehensive error handling with status codes
  - Returns full response including status, headers, and data

**Example requests:**

```javascript
// Simple GET request
{ url: "https://api.github.com/users/octocat" }

// POST with JSON body
{
  url: "https://api.example.com/data",
  method: "POST",
  headers: { "Authorization": "Bearer token123" },
  body: { name: "John", email: "john@example.com" }
}

// GET with query parameters
{
  url: "https://api.example.com/search",
  params: { q: "search term", limit: "10" }
}
```

## Development

Install dependencies:

```bash
npm install
```

Build the server:

```bash
npm run build
```

For development with auto-rebuild:

```bash
npm run watch
```

## Installation

### Using with Claude Desktop

To use with Claude Desktop, add the server config:

On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
On Windows: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "webrequest": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/webrequest-mcp-server/build/index.js"]
    }
  }
}
```

### Using with Cursor

Add to your Cursor MCP settings configuration file:

```json
{
  "mcpServers": {
    "webrequest": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/webrequest-mcp-server/build/index.js"]
    }
  }
}
```

### Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector):

```bash
npm run inspector
```

The Inspector will provide a URL to access debugging tools in your browser.

## Configuration

The server configuration:

- **Max response size**: 50,000 characters (responses larger than this are truncated)
- **Supported methods**: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS
- **Content types**: Automatic JSON handling, supports any content type via headers

## Use Cases

This MCP server is useful for:

- Testing and interacting with REST APIs
- Fetching data from web services
- Automating HTTP requests in AI workflows
- Prototyping API integrations
- Debugging web endpoints

## License

MIT License - see LICENSE file for details