Skip to main content
Glama
MCP API Requester

MCP API Requester

by yryuu

MCP API Requester

A Model Context Protocol (MCP) server that enables LLMs to make arbitrary HTTP API requests (GET, POST, PUT, DELETE, etc.) with custom headers and bodies. Works with Claude Desktop and other MCP-compatible AI tools.

Features

  • 🌐 HTTP Operations: Make any HTTP request (GET, POST, PUT, DELETE, PATCH, etc.)

  • πŸ”§ Custom Configuration: Full control over headers, query parameters, and request body

  • πŸ“„ JSON Support: Native handling of JSON request and response bodies

  • πŸ›  Robust Error Handling: Returns 4xx/5xx responses as structured data instead of failing, allowing the LLM to inspect errors

  • πŸ”’ Safe Execution: Useful for testing APIs, webhooks, and interacting with external services

Related MCP server: Web Request MCP Server

Installation

No installation needed! Just configure Claude Desktop to use npx:

{
  "mcpServers": {
    "api-requester": {
      "command": "npx",
      "args": [
        "-y",
        "github:yryuu/mcp-api-requester"
      ]
    }
  }
}

Local Installation

git clone <repository-url>
cd mcp-api-requester
npm install
npm run build

Configuration

Claude Desktop

Edit your Claude Desktop configuration file:

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

Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the server configuration:

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

Available Tools

make_request

Make an arbitrary HTTP request.

Parameters:

  • url (string): The full URL to make the request to.

  • method (string): HTTP method (GET, POST, PUT, DELETE, PATCH, etc.). Defaults to GET.

  • headers (object, optional): Key-value pairs of HTTP headers.

  • params (object, optional): Key-value pairs of URL query parameters.

  • cookies (object, optional): Key-value pairs of cookies to be included in the request.

  • body (object/string, optional): The request body. Content-Type header should match this body.

Example (GET):

Make a GET request to https://api.example.com/users?id=123

Example (POST):

POST to https://api.example.com/data with content-type application/json and body {"key": "value"}

Example (Cookies):

Make a GET request to https://api.example.com/profile with cookies {"session": "abc", "theme": "dark"}

Development

Setup

cd mcp-api-requester
npm install

Build

npm run build

Testing

Run the included manual test script:

npm test

Note: uses tsx to run the TypeScript test file directly.

Debugging

Use the MCP Inspector to test the server:

npx @modelcontextprotocol/inspector node dist/index.js

Security

  • Warning: This tool enables the LLM to make requests to any URL you provide or it discovers.

  • Ensure you only use this in a trusted environment.

  • Be cautious when asking the LLM to interact with sensitive APIs or internal services.

License

MIT

Author

yryuu

Available Tools

1 tool
make_requestA

Make an arbitrary HTTP request (GET, POST, PUT, DELETE, etc.) with custom headers and body. Returns the status, headers, and body of the response.

Inputs: url (required), body, method, params, +2 more.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of confusion or overlapping purposes. The single tool's purpose is clearly defined as making arbitrary HTTP requests.

    Naming Consistency5/5

    With a single tool named 'make_request', the naming follows a clear verb_noun pattern. There are no other tools to create inconsistency.

    Tool Count4/5

    The server has just one tool, which is slightly below the typical 3-15 range, but for a focused HTTP request utility this is reasonable. The tool is general-purpose and well-suited to the server's stated purpose.

    Completeness5/5

    The single tool covers the full scope of making HTTP requests: all methods, custom headers, body, and returns status, headers, and body. There are no obvious gaps in the server's intended functionality.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI assistants to make HTTP requests (GET, POST, PUT, DELETE) to external APIs through standardized MCP tools.
      4
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A TypeScript-based MCP server that enables AI assistants to execute HTTP requests with full control over methods, headers, and body content. It facilitates seamless interaction with web APIs and endpoints through a versatile tool that handles automatic JSON formatting and response truncation.
      1
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Universal HTTP client tool for LLM agents. Enables Claude and other MCP-compatible agents to perform GET, POST, PUT, DELETE, and other HTTP requests to any URL, including localhost and internal network addresses.
      2
      -