# HTTP Request Runner

> HTTP Request Runner is a paid MCP server for developer tools. Apify-hosted MCP server that sends many HTTP requests with retries and parsed JSON. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web
- **Website:** https://apify.com/prometheus-maker/http-request-runner
- **Repository:** https://github.com/prometheus-maker/apify-tools-examples
- **MCP Registry name:** io.github.prometheus-maker/http-request-runner
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Instead of one tool call per API request, this server takes a list of requests (a bare URL, or an object with url, method, headers, params, json or body) and returns one result row per request with status code, headers and the body, parsed as JSON when it is JSON. A lookupKey you set, such as a row ID, comes back on each row so results can be joined to your data.

Requests run in parallel, 20 at a time and at most 5 per host by default. Retries cover 408, 429, 5xx and connection errors, waiting for Retry-After up to 30 seconds; other 4xx responses are not retried. Long bodies can be truncated, and an optional callbackUrl receives each row as a webhook as soon as it is ready.

The page positions it for Clay, n8n, Make and Zapier workflows as well as agents. It is billed at $1 per 1,000 requests ($0.70 on Gold plans); requests that get no response are free.

## Features

- **Any HTTP method:** GET, POST, PUT, PATCH, DELETE and HEAD with headers, params and JSON or text bodies.
- **Lookup keys:** Your own key returns on every row for easy joins.
- **Smart retries:** Retries 408, 429, 5xx and connection errors honouring Retry-After.
- **Parallel execution:** 20 concurrent requests by default, 5 per host, both adjustable.
- **Webhook callback:** Optionally POST each row to your URL as it completes.
- **Body truncation:** Cap response size and mark truncated results.

## Good for

- Call an API for hundreds of IDs in one run
- Add an HTTP step to a Clay or n8n workflow
- Smoke-test a batch of endpoints
- Replay a set of webhook calls

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http http-request-runner 'https://mcp.apify.com/?tools=prometheus-maker/http-request-runner'
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.apify.com/?tools=prometheus-maker/http-request-runner
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "http-request-runner": {
      "url": "https://mcp.apify.com/?tools=prometheus-maker/http-request-runner"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "http-request-runner": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=prometheus-maker/http-request-runner"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "http-request-runner": {
      "serverUrl": "https://mcp.apify.com/?tools=prometheus-maker/http-request-runner"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "http-request-runner": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=prometheus-maker/http-request-runner"
    }
  }
}
```

## FAQ

### What does it cost?

$1 per 1,000 requests, $0.70 on Gold plans; requests with no response are free.

### Which errors are retried?

408, 429, 5xx and connection errors; other 4xx responses are treated as a wrong request and not retried.

### How do I match results to my data?

Put your row ID in lookupKey and it is returned on each result row.

### Can I pass an API key to the target?

Yes, defaultHeaders are added to every request and stored as a secret.

### Is HTTP Request Runner free?

No. HTTP Request Runner is a paid product.

### How do I add HTTP Request Runner to Claude Code?

Run this command in your terminal: claude mcp add --transport http http-request-runner 'https://mcp.apify.com/?tools=prometheus-maker/http-request-runner'

### What are the best alternatives to HTTP Request Runner?

The closest alternatives to HTTP Request Runner are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/http-request-runner
