Skip to main content
Glama
MCP-RQuest
by xxxbrian

mcp-rquest

PyPI Version Python Versions GitHub Stars License

A Model Context Protocol (MCP) server that provides advanced HTTP request capabilities for Claude and other LLMs. Built on rquest, this server enables realistic browser emulation with accurate TLS/JA3/JA4 fingerprints, allowing models to interact with websites more naturally and bypass common anti-bot measures. It also supports converting PDF and HTML documents to Markdown for easier processing by LLMs.

Features

  • Complete HTTP Methods: Support for GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS, and TRACE

  • Browser Fingerprinting: Accurate TLS, JA3/JA4, and HTTP/2 browser fingerprints

  • Content Handling:

    • Automatic handling of large responses with token counting

    • HTML to Markdown conversion for better LLM processing

    • PDF to Markdown conversion using the Marker library

    • Secure storage of responses in system temporary directories

  • Authentication Support: Basic, Bearer, and custom authentication methods

  • Request Customization:

    • Headers, cookies, redirects

    • Form data, JSON payloads, multipart/form-data

    • Query parameters

  • SSL Security: Uses BoringSSL for secure connections with realistic browser fingerprints

Related MCP server: URL Fetch MCP

Available Tools

  • HTTP Request Tools:

    • http_get - Perform GET requests with optional parameters

    • http_post - Submit data via POST requests

    • http_put - Update resources with PUT requests

    • http_delete - Remove resources with DELETE requests

    • http_patch - Partially update resources

    • http_head - Retrieve only headers from a resource

    • http_options - Retrieve options for a resource

    • http_trace - Diagnostic request tracing

  • Response Handling Tools:

    • get_stored_response - Retrieve stored large responses, optionally by line range

    • get_stored_response_with_markdown - Convert HTML or PDF responses to Markdown format for better LLM processing

    • get_model_state - Get the current state of the PDF models loading process

    • restart_model_loading - Restart the PDF models loading process if it failed or got stuck

PDF Support

mcp-rquest now supports PDF to Markdown conversion, allowing you to download PDF files and convert them to Markdown format that's easy for LLMs to process:

  1. Automatic PDF Detection: PDF files are automatically detected based on content type

  2. Seamless Conversion: The same get_stored_response_with_markdown tool works for both HTML and PDF files

  3. High-Quality Conversion: Uses the Marker library for accurate PDF to Markdown transformation

  4. Optimized Performance: Models are pre-downloaded during package installation to avoid delays during request processing

Installation

When using uv no specific installation is needed. We will use uvx to directly run mcp-rquest.

Using pip

Alternatively you can install mcp-rquest via pip:

pip install mcp-rquest

After installation, you can run it as a script using:

python -m mcp_rquest

Configuration

Configure for Claude.app

Add to your Claude settings:

Using uvx:

{
  "mcpServers": {
    "http-rquest": {
      "command": "uvx",
      "args": ["mcp-rquest"]
    }
  }
}

Using pip:

{
  "mcpServers": {
    "http-rquest": {
      "command": "python",
      "args": ["-m", "mcp_rquest"]
    }
  }
}

Using pipx:

{
  "mcpServers": {
    "http-rquest": {
      "command": "pipx",
      "args": ["run", "mcp-rquest"]
    }
  }
}

Browser Emulation

mcp-rquest leverages rquest's powerful browser emulation capabilities to provide realistic browser fingerprints, which helps bypass bot detection and access content normally available only to standard browsers. Supported browser fingerprints include:

  • Chrome (multiple versions)

  • Firefox

  • Safari (including iOS and iPad versions)

  • Edge

  • OkHttp

This ensures that requests sent through mcp-rquest appear as legitimate browser traffic rather than bot requests.

Development

Setting up a Development Environment

  1. Clone the repository

  2. Create a virtual environment using uv:

    uv venv
  3. Activate the virtual environment:

    # Unix/macOS
    source .venv/bin/activate
    # Windows
    .venv\Scripts\activate
  4. Install development dependencies:

    uv pip install -e ".[dev]"

Acknowledgements

  • This project is built on top of rquest, which provides the advanced HTTP client with browser fingerprinting capabilities.

  • rquest is based on a fork of reqwest.

Available Tools

12 tools
get_model_stateB

Get the current state of the PDF models(used by get_stored_response_with_markdown) loading process

Inputs: no named parameters.

get_stored_responseC

Retrieve a stored HTTP response by its ID

Inputs: response_id (required), end_line, start_line.

get_stored_response_with_markdownA

Retrieve a stored HTTP response by its ID and convert it to Markdown format. Supports HTML and PDF content types. (Converting large PDF to Markdown may cause timeout, just wait and try again.)

Inputs: response_id (required).

http_deleteC

Make an HTTP DELETE request to the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_getC

Make an HTTP GET request to the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_headC

Make an HTTP HEAD request to retrieve only headers from the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_optionsC

Make an HTTP OPTIONS request to retrieve options for the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

http_patchA

Make an HTTP PATCH request to the specified URL

Inputs: url (required), auth, body, form, +11 more.

http_postC

Make an HTTP POST request to the specified URL

Inputs: url (required), auth, body, form, +11 more.

http_putC

Make an HTTP PUT request to the specified URL

Inputs: url (required), auth, body, form, +11 more.

http_traceA

Make an HTTP TRACE request for diagnostic tracing of the specified URL

Inputs: url (required), auth, proxy, query, +7 more.

restart_model_loadingA

Restart the PDF models(used by get_stored_response_with_markdown) loading process if it failed or got stuck

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 12 tools

    Disambiguation4/5

    The HTTP method tools are clearly distinct, and the two stored response tools are differentiated by markdown conversion. However, get_stored_response and get_stored_response_with_markdown could be confused by an agent without careful reading, but descriptions mitigate ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern, with http_ prefix for HTTP methods and clear action words like get, restart, and retrieve. The naming is highly predictable and uniform.

    Tool Count5/5

    12 tools is well-scoped for an HTTP client with model management and stored response retrieval. Each tool has a clear purpose, and the count is neither sparse nor overwhelming.

    Completeness4/5

    The HTTP methods cover all standard request types, and stored response handling is present. Minor gaps include no tool to clear or list stored responses, and model state tools are limited to get and restart, but core functionality is complete.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server that provides browser automation capabilities using BrowserCat's cloud browser service. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment without needing to install browsers locally.
      7
      6
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that enables Claude or other LLMs to fetch content from URLs, supporting HTML, JSON, text, and images with configurable request parameters.
      3
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides enhanced browser automation capabilities using Puppeteer-Extra with Stealth Plugin, enabling LLMs to interact with web pages in a way that better emulates human behavior and avoids detection as automation.
      3
      MIT