@paretools/http 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dave London
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerAllTools } from "./tools/index.js";
+const server = new McpServer({ name: "@paretools/http", version: "0.7.0" }, {
+    instructions: "Structured HTTP request operations via curl (request, get, post, head). Use instead of running curl commands via bash. Returns typed JSON with status, headers, body, timing, and size.",
+});
+registerAllTools(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC7C;IACE,YAAY,EACV,yLAAyL;CAC5L,CACF,CAAC;AAEF,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAEzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/lib/curl-runner.d.ts

@@ -0,0 +1,7 @@
+import { type RunResult } from "@paretools/shared";
+/**
+ * Executes a curl command with the given arguments.
+ * Uses a generous timeout since HTTP requests can be slow.
+ */
+export declare function curlCmd(args: string[], cwd?: string): Promise<RunResult>;
+//# sourceMappingURL=curl-runner.d.ts.map

package/dist/lib/curl-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curl-runner.d.ts","sourceRoot":"","sources":["../../src/lib/curl-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;GAGG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAE9E"}

package/dist/lib/curl-runner.js

@@ -0,0 +1,9 @@
+import { run } from "@paretools/shared";
+/**
+ * Executes a curl command with the given arguments.
+ * Uses a generous timeout since HTTP requests can be slow.
+ */
+export async function curlCmd(args, cwd) {
+    return run("curl", args, { cwd, timeout: 120_000 });
+}
+//# sourceMappingURL=curl-runner.js.map

package/dist/lib/curl-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curl-runner.js","sourceRoot":"","sources":["../../src/lib/curl-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAkB,MAAM,mBAAmB,CAAC;AAExD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc,EAAE,GAAY;IACxD,OAAO,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/dist/lib/formatters.d.ts

@@ -0,0 +1,14 @@
+import type { HttpResponse, HttpHeadResponse, HttpResponseCompact, HttpHeadResponseCompact } from "../schemas/index.js";
+/** Formats a full HTTP response into human-readable text. */
+export declare function formatHttpResponse(data: HttpResponse): string;
+/** Formats a HEAD response into human-readable text. */
+export declare function formatHttpHeadResponse(data: HttpHeadResponse): string;
+/** Maps full HTTP response to compact form (drop headers and body). */
+export declare function compactResponseMap(data: HttpResponse): HttpResponseCompact;
+/** Formats compact HTTP response. */
+export declare function formatResponseCompact(data: HttpResponseCompact): string;
+/** Maps full HEAD response to compact form (drop headers). */
+export declare function compactHeadResponseMap(data: HttpHeadResponse): HttpHeadResponseCompact;
+/** Formats compact HEAD response. */
+export declare function formatHeadResponseCompact(data: HttpHeadResponseCompact): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/lib/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/lib/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAE7B,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAyB7D;AAED,wDAAwD;AACxD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAmBrE;AAID,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,CAQ1E;AAED,qCAAqC;AACrC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAGvE;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,GAAG,uBAAuB,CAOtF;AAED,qCAAqC;AACrC,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAG/E"}

package/dist/lib/formatters.js

@@ -0,0 +1,66 @@
+/** Formats a full HTTP response into human-readable text. */
+export function formatHttpResponse(data) {
+    const lines = [];
+    lines.push(`HTTP ${data.status} ${data.statusText}`);
+    if (data.contentType) {
+        lines.push(`Content-Type: ${data.contentType}`);
+    }
+    lines.push(`Size: ${data.size} bytes | Time: ${data.timing.total.toFixed(3)}s`);
+    const headerCount = Object.keys(data.headers).length;
+    lines.push(`Headers: ${headerCount}`);
+    for (const [key, value] of Object.entries(data.headers)) {
+        lines.push(`  ${key}: ${value}`);
+    }
+    if (data.body) {
+        const bodyPreview = data.body.length > 500 ? data.body.substring(0, 500) + "..." : data.body;
+        lines.push("");
+        lines.push(bodyPreview);
+    }
+    return lines.join("\n");
+}
+/** Formats a HEAD response into human-readable text. */
+export function formatHttpHeadResponse(data) {
+    const lines = [];
+    lines.push(`HTTP ${data.status} ${data.statusText}`);
+    if (data.contentType) {
+        lines.push(`Content-Type: ${data.contentType}`);
+    }
+    lines.push(`Time: ${data.timing.total.toFixed(3)}s`);
+    const headerCount = Object.keys(data.headers).length;
+    lines.push(`Headers: ${headerCount}`);
+    for (const [key, value] of Object.entries(data.headers)) {
+        lines.push(`  ${key}: ${value}`);
+    }
+    return lines.join("\n");
+}
+// ── Compact types, mappers, and formatters ───────────────────────────
+/** Maps full HTTP response to compact form (drop headers and body). */
+export function compactResponseMap(data) {
+    return {
+        status: data.status,
+        statusText: data.statusText,
+        contentType: data.contentType,
+        size: data.size,
+        timing: data.timing,
+    };
+}
+/** Formats compact HTTP response. */
+export function formatResponseCompact(data) {
+    const ct = data.contentType ? ` (${data.contentType})` : "";
+    return `HTTP ${data.status} ${data.statusText}${ct} | ${data.size} bytes | ${data.timing.total.toFixed(3)}s`;
+}
+/** Maps full HEAD response to compact form (drop headers). */
+export function compactHeadResponseMap(data) {
+    return {
+        status: data.status,
+        statusText: data.statusText,
+        contentType: data.contentType,
+        timing: data.timing,
+    };
+}
+/** Formats compact HEAD response. */
+export function formatHeadResponseCompact(data) {
+    const ct = data.contentType ? ` (${data.contentType})` : "";
+    return `HTTP ${data.status} ${data.statusText}${ct} | ${data.timing.total.toFixed(3)}s`;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/lib/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../src/lib/formatters.ts"],"names":[],"mappings":"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"}

package/dist/lib/parsers.d.ts

@@ -0,0 +1,38 @@
+import type { HttpResponse, HttpHeadResponse } from "../schemas/index.js";
+/** Sentinel appended via curl -w to separate body from metadata. */
+export declare const PARE_META_SEPARATOR = "---PARE_HTTP_META---";
+/**
+ * Parses the combined output from `curl -s -S -i -w '...' URL`.
+ *
+ * The output format is:
+ *   HTTP/x.y STATUS STATUS_TEXT\r\n
+ *   Header: value\r\n
+ *   ...
+ *   \r\n
+ *   <body>
+ *   \n---PARE_HTTP_META---\n
+ *   <time_total> <size_download>
+ *
+ * When following redirects, multiple status+header blocks may appear.
+ * We parse the LAST one (the final response).
+ */
+export declare function parseCurlOutput(stdout: string, _stderr: string, _exitCode: number): HttpResponse;
+/**
+ * Parses curl output for HEAD requests (no body expected).
+ */
+export declare function parseCurlHeadOutput(stdout: string, stderr: string, exitCode: number): HttpHeadResponse;
+/**
+ * Splits raw curl `-i` output into separate HTTP response blocks.
+ * Each block starts with `HTTP/` (status line).
+ */
+export declare function splitHttpBlocks(raw: string): string[];
+/**
+ * Parses a single HTTP response block into status, headers, and body.
+ */
+export declare function parseHttpBlock(block: string): {
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    body: string;
+};
+//# sourceMappingURL=parsers.d.ts.map

package/dist/lib/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/lib/parsers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE1E,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAU1D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CA+BhG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAUlB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd,CA0CA"}

package/dist/lib/parsers.js

@@ -0,0 +1,131 @@
+/** Sentinel appended via curl -w to separate body from metadata. */
+export const PARE_META_SEPARATOR = "---PARE_HTTP_META---";
+/**
+ * Parses the combined output from `curl -s -S -i -w '...' URL`.
+ *
+ * The output format is:
+ *   HTTP/x.y STATUS STATUS_TEXT\r\n
+ *   Header: value\r\n
+ *   ...
+ *   \r\n
+ *   <body>
+ *   \n---PARE_HTTP_META---\n
+ *   <time_total> <size_download>
+ *
+ * When following redirects, multiple status+header blocks may appear.
+ * We parse the LAST one (the final response).
+ */
+export function parseCurlOutput(stdout, _stderr, _exitCode) {
+    // Split off the meta section appended by -w
+    const metaSepIdx = stdout.lastIndexOf(PARE_META_SEPARATOR);
+    let metaSection = "";
+    let responsePart = stdout;
+    if (metaSepIdx !== -1) {
+        responsePart = stdout.substring(0, metaSepIdx);
+        metaSection = stdout.substring(metaSepIdx + PARE_META_SEPARATOR.length).trim();
+    }
+    const meta = parseMetaSection(metaSection);
+    // When following redirects, curl with -i outputs multiple response blocks.
+    // Each block starts with HTTP/. We want the LAST one.
+    const blocks = splitHttpBlocks(responsePart);
+    const lastBlock = blocks.length > 0 ? blocks[blocks.length - 1] : responsePart;
+    const { status, statusText, headers, body } = parseHttpBlock(lastBlock);
+    const contentType = headers["content-type"];
+    return {
+        status,
+        statusText,
+        headers,
+        body: body || undefined,
+        timing: { total: meta.time_total },
+        size: meta.size_download,
+        contentType,
+    };
+}
+/**
+ * Parses curl output for HEAD requests (no body expected).
+ */
+export function parseCurlHeadOutput(stdout, stderr, exitCode) {
+    const full = parseCurlOutput(stdout, stderr, exitCode);
+    return {
+        status: full.status,
+        statusText: full.statusText,
+        headers: full.headers,
+        timing: full.timing,
+        contentType: full.contentType,
+    };
+}
+/**
+ * Splits raw curl `-i` output into separate HTTP response blocks.
+ * Each block starts with `HTTP/` (status line).
+ */
+export function splitHttpBlocks(raw) {
+    const blocks = [];
+    // Match HTTP/ at the start of a line
+    const regex = /^HTTP\//gm;
+    const indices = [];
+    let match;
+    while ((match = regex.exec(raw)) !== null) {
+        indices.push(match.index);
+    }
+    if (indices.length === 0) {
+        return [raw];
+    }
+    for (let i = 0; i < indices.length; i++) {
+        const start = indices[i];
+        const end = i + 1 < indices.length ? indices[i + 1] : raw.length;
+        blocks.push(raw.substring(start, end));
+    }
+    return blocks;
+}
+/**
+ * Parses a single HTTP response block into status, headers, and body.
+ */
+export function parseHttpBlock(block) {
+    // Normalize line endings: \r\n -> \n
+    const normalized = block.replace(/\r\n/g, "\n");
+    // Split on first double-newline to separate headers from body
+    const headerBodySplit = normalized.indexOf("\n\n");
+    let headerSection;
+    let body;
+    if (headerBodySplit !== -1) {
+        headerSection = normalized.substring(0, headerBodySplit);
+        body = normalized.substring(headerBodySplit + 2);
+    }
+    else {
+        // No body (e.g. HEAD request or empty response)
+        headerSection = normalized;
+        body = "";
+    }
+    const lines = headerSection.split("\n");
+    const statusLine = lines[0] || "";
+    // Parse status line: HTTP/1.1 200 OK
+    const statusMatch = statusLine.match(/^HTTP\/[\d.]+\s+(\d+)\s*(.*)/);
+    const status = statusMatch ? parseInt(statusMatch[1], 10) : 0;
+    const statusText = statusMatch ? statusMatch[2].trim() : "";
+    // Parse headers
+    const headers = {};
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        const colonIdx = line.indexOf(":");
+        if (colonIdx > 0) {
+            const key = line.substring(0, colonIdx).trim().toLowerCase();
+            const value = line.substring(colonIdx + 1).trim();
+            headers[key] = value;
+        }
+    }
+    // Trim trailing whitespace from body
+    body = body.replace(/\n$/, "");
+    return { status, statusText, headers, body };
+}
+/**
+ * Parses the metadata section appended by curl's -w format string.
+ * Format: "<time_total> <size_download>"
+ */
+function parseMetaSection(meta) {
+    const parts = meta.trim().split(/\s+/);
+    return {
+        time_total: parts[0] ? parseFloat(parts[0]) : 0,
+        size_download: parts[1] ? parseFloat(parts[1]) : 0,
+    };
+}
+//# sourceMappingURL=parsers.js.map

package/dist/lib/parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../../src/lib/parsers.ts"],"names":[],"mappings":"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"}

package/dist/lib/url-validation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Validates that a URL uses only http:// or https:// schemes.
+ * Blocks dangerous schemes like file://, ftp://, gopher://, dict://, data:, javascript:, etc.
+ */
+export declare function assertSafeUrl(url: string): void;
+/**
+ * Validates that a header key or value does not contain newlines or control characters
+ * that could be used for header injection attacks.
+ */
+export declare function assertSafeHeader(key: string, value: string): void;
+//# sourceMappingURL=url-validation.d.ts.map

package/dist/lib/url-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-validation.d.ts","sourceRoot":"","sources":["../../src/lib/url-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAY/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAcjE"}

package/dist/lib/url-validation.js

@@ -0,0 +1,28 @@
+/**
+ * Validates that a URL uses only http:// or https:// schemes.
+ * Blocks dangerous schemes like file://, ftp://, gopher://, dict://, data:, javascript:, etc.
+ */
+export function assertSafeUrl(url) {
+    const trimmed = url.trim();
+    if (!trimmed) {
+        throw new Error("URL must not be empty.");
+    }
+    const lower = trimmed.toLowerCase();
+    if (!lower.startsWith("http://") && !lower.startsWith("https://")) {
+        throw new Error(`Unsafe URL scheme. Only http:// and https:// are allowed. Got: "${url}"`);
+    }
+}
+/**
+ * Validates that a header key or value does not contain newlines or control characters
+ * that could be used for header injection attacks.
+ */
+export function assertSafeHeader(key, value) {
+    const UNSAFE_RE = /[\r\n\x00]/;
+    if (UNSAFE_RE.test(key)) {
+        throw new Error(`Invalid header key: "${key}". Header keys must not contain newlines or null bytes.`);
+    }
+    if (UNSAFE_RE.test(value)) {
+        throw new Error(`Invalid header value for "${key}". Header values must not contain newlines or null bytes.`);
+    }
+}
+//# sourceMappingURL=url-validation.js.map

package/dist/lib/url-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-validation.js","sourceRoot":"","sources":["../../src/lib/url-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEpC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,mEAAmE,GAAG,GAAG,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,KAAa;IACzD,MAAM,SAAS,GAAG,YAAY,CAAC;IAE/B,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,wBAAwB,GAAG,yDAAyD,CACrF,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,6BAA6B,GAAG,2DAA2D,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+/** Zod schema for a single HTTP header key-value pair as a record. */
+export declare const HttpHeadersSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+/** Zod schema for HTTP timing information. */
+export declare const HttpTimingSchema: z.ZodObject<{
+    total: z.ZodNumber;
+}, z.core.$strip>;
+/** Zod schema for the full HTTP response result (used by request, get, post). */
+export declare const HttpResponseSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    statusText: z.ZodString;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    timing: z.ZodObject<{
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+    size: z.ZodNumber;
+    contentType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HttpResponse = z.infer<typeof HttpResponseSchema>;
+/** Zod schema for the HEAD-only HTTP response result (no body). */
+export declare const HttpHeadResponseSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    statusText: z.ZodString;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+    timing: z.ZodObject<{
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+    contentType: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HttpHeadResponse = z.infer<typeof HttpHeadResponseSchema>;
+/** Compact response: status, timing, size. Drop headers and body. */
+export declare const HttpResponseCompactSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    statusText: z.ZodString;
+    contentType: z.ZodOptional<z.ZodString>;
+    size: z.ZodNumber;
+    timing: z.ZodObject<{
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type HttpResponseCompact = z.infer<typeof HttpResponseCompactSchema>;
+/** Compact HEAD response: status and timing only. Drop headers. */
+export declare const HttpHeadResponseCompactSchema: z.ZodObject<{
+    status: z.ZodNumber;
+    statusText: z.ZodString;
+    contentType: z.ZodOptional<z.ZodString>;
+    timing: z.ZodObject<{
+        total: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type HttpHeadResponseCompact = z.infer<typeof HttpHeadResponseCompactSchema>;
+//# sourceMappingURL=index.d.ts.map

package/dist/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,uCAAmC,CAAC;AAElE,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC;AAEH,iFAAiF;AACjF,eAAO,MAAM,kBAAkB;;;;;;;;;;iBAQ7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,mEAAmE;AACnE,eAAO,MAAM,sBAAsB;;;;;;;;iBAMjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,qEAAqE;AACrE,eAAO,MAAM,yBAAyB;;;;;;;;iBAMpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,mEAAmE;AACnE,eAAO,MAAM,6BAA6B;;;;;;;iBAKxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+/** Zod schema for a single HTTP header key-value pair as a record. */
+export const HttpHeadersSchema = z.record(z.string(), z.string());
+/** Zod schema for HTTP timing information. */
+export const HttpTimingSchema = z.object({
+    total: z.number(),
+});
+/** Zod schema for the full HTTP response result (used by request, get, post). */
+export const HttpResponseSchema = z.object({
+    status: z.number(),
+    statusText: z.string(),
+    headers: HttpHeadersSchema,
+    body: z.string().optional(),
+    timing: HttpTimingSchema,
+    size: z.number(),
+    contentType: z.string().optional(),
+});
+/** Zod schema for the HEAD-only HTTP response result (no body). */
+export const HttpHeadResponseSchema = z.object({
+    status: z.number(),
+    statusText: z.string(),
+    headers: HttpHeadersSchema,
+    timing: HttpTimingSchema,
+    contentType: z.string().optional(),
+});
+/** Compact response: status, timing, size. Drop headers and body. */
+export const HttpResponseCompactSchema = z.object({
+    status: z.number(),
+    statusText: z.string(),
+    contentType: z.string().optional(),
+    size: z.number(),
+    timing: HttpTimingSchema,
+});
+/** Compact HEAD response: status and timing only. Drop headers. */
+export const HttpHeadResponseCompactSchema = z.object({
+    status: z.number(),
+    statusText: z.string(),
+    contentType: z.string().optional(),
+    timing: HttpTimingSchema,
+});
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAElE,8CAA8C;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,OAAO,EAAE,iBAAiB;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,gBAAgB;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH,mEAAmE;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,OAAO,EAAE,iBAAiB;IAC1B,MAAM,EAAE,gBAAgB;IACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH,qEAAqE;AACrE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,gBAAgB;CACzB,CAAC,CAAC;AAIH,mEAAmE;AACnE,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,gBAAgB;CACzB,CAAC,CAAC"}

package/dist/tools/get.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGetTool(server: McpServer): void;
+//# sourceMappingURL=get.d.ts.map

package/dist/tools/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/tools/get.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QAwEhD"}

package/dist/tools/get.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { compactDualOutput, INPUT_LIMITS } from "@paretools/shared";
+import { curlCmd } from "../lib/curl-runner.js";
+import { parseCurlOutput } from "../lib/parsers.js";
+import { formatHttpResponse, compactResponseMap, formatResponseCompact, } from "../lib/formatters.js";
+import { HttpResponseSchema } from "../schemas/index.js";
+import { assertSafeUrl } from "../lib/url-validation.js";
+import { buildCurlArgs } from "./request.js";
+export function registerGetTool(server) {
+    server.registerTool("get", {
+        title: "HTTP GET",
+        description: "Makes an HTTP GET request via curl and returns structured response data. Convenience wrapper for the request tool.",
+        inputSchema: {
+            url: z
+                .string()
+                .max(INPUT_LIMITS.STRING_MAX)
+                .describe("The URL to request (http:// or https:// only)"),
+            headers: z
+                .record(z.string().max(INPUT_LIMITS.SHORT_STRING_MAX), z.string().max(INPUT_LIMITS.STRING_MAX))
+                .optional()
+                .describe("Request headers as key-value pairs"),
+            timeout: z
+                .number()
+                .min(1)
+                .max(300)
+                .optional()
+                .default(30)
+                .describe("Request timeout in seconds (default: 30)"),
+            followRedirects: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Follow HTTP redirects (default: true)"),
+            compact: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema."),
+            path: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("Working directory (default: cwd)"),
+        },
+        outputSchema: HttpResponseSchema,
+    }, async ({ url, headers, timeout, followRedirects, compact, path }) => {
+        assertSafeUrl(url);
+        const args = buildCurlArgs({
+            url,
+            method: "GET",
+            headers,
+            timeout: timeout ?? 30,
+            followRedirects: followRedirects ?? true,
+        });
+        const cwd = path || process.cwd();
+        const result = await curlCmd(args, cwd);
+        const data = parseCurlOutput(result.stdout, result.stderr, result.exitCode);
+        const rawOutput = (result.stdout + "\n" + result.stderr).trim();
+        return compactDualOutput(data, rawOutput, formatHttpResponse, compactResponseMap, formatResponseCompact, compact === false);
+    });
+}
+//# sourceMappingURL=get.js.map

package/dist/tools/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/tools/get.ts"],"names":[],"mappings":"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"}

package/dist/tools/head.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerHeadTool(server: McpServer): void;
+//# sourceMappingURL=head.d.ts.map

package/dist/tools/head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../src/tools/head.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAwEjD"}

package/dist/tools/head.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { compactDualOutput, INPUT_LIMITS } from "@paretools/shared";
+import { curlCmd } from "../lib/curl-runner.js";
+import { parseCurlHeadOutput } from "../lib/parsers.js";
+import { formatHttpHeadResponse, compactHeadResponseMap, formatHeadResponseCompact, } from "../lib/formatters.js";
+import { HttpHeadResponseSchema } from "../schemas/index.js";
+import { assertSafeUrl } from "../lib/url-validation.js";
+import { buildCurlArgs } from "./request.js";
+export function registerHeadTool(server) {
+    server.registerTool("head", {
+        title: "HTTP HEAD",
+        description: "Makes an HTTP HEAD request via curl and returns structured response headers (no body). Use to check resource existence, content type, or cache headers.",
+        inputSchema: {
+            url: z
+                .string()
+                .max(INPUT_LIMITS.STRING_MAX)
+                .describe("The URL to request (http:// or https:// only)"),
+            headers: z
+                .record(z.string().max(INPUT_LIMITS.SHORT_STRING_MAX), z.string().max(INPUT_LIMITS.STRING_MAX))
+                .optional()
+                .describe("Request headers as key-value pairs"),
+            timeout: z
+                .number()
+                .min(1)
+                .max(300)
+                .optional()
+                .default(30)
+                .describe("Request timeout in seconds (default: 30)"),
+            followRedirects: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Follow HTTP redirects (default: true)"),
+            compact: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema."),
+            path: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("Working directory (default: cwd)"),
+        },
+        outputSchema: HttpHeadResponseSchema,
+    }, async ({ url, headers, timeout, followRedirects, compact, path }) => {
+        assertSafeUrl(url);
+        const args = buildCurlArgs({
+            url,
+            method: "HEAD",
+            headers,
+            timeout: timeout ?? 30,
+            followRedirects: followRedirects ?? true,
+        });
+        const cwd = path || process.cwd();
+        const result = await curlCmd(args, cwd);
+        const data = parseCurlHeadOutput(result.stdout, result.stderr, result.exitCode);
+        const rawOutput = (result.stdout + "\n" + result.stderr).trim();
+        return compactDualOutput(data, rawOutput, formatHttpHeadResponse, compactHeadResponseMap, formatHeadResponseCompact, compact === false);
+    });
+}
+//# sourceMappingURL=head.js.map

package/dist/tools/head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"head.js","sourceRoot":"","sources":["../../src/tools/head.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,YAAY,CACjB,MAAM,EACN;QACE,KAAK,EAAE,WAAW;QAClB,WAAW,EACT,yJAAyJ;QAC3J,WAAW,EAAE;YACX,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC;iBAC5B,QAAQ,CAAC,+CAA+C,CAAC;YAC5D,OAAO,EAAE,CAAC;iBACP,MAAM,CACL,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,gBAAgB,CAAC,EAC7C,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CACxC;iBACA,QAAQ,EAAE;iBACV,QAAQ,CAAC,oCAAoC,CAAC;YACjD,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,GAAG,CAAC;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,EAAE,CAAC;iBACX,QAAQ,CAAC,0CAA0C,CAAC;YACvD,eAAe,EAAE,CAAC;iBACf,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CAAC,uCAAuC,CAAC;YACpD,OAAO,EAAE,CAAC;iBACP,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,OAAO,CAAC,IAAI,CAAC;iBACb,QAAQ,CACP,kGAAkG,CACnG;YACH,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC;iBAC1B,QAAQ,EAAE;iBACV,QAAQ,CAAC,kCAAkC,CAAC;SAChD;QACD,YAAY,EAAE,sBAAsB;KACrC,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QAClE,aAAa,CAAC,GAAG,CAAC,CAAC;QAEnB,MAAM,IAAI,GAAG,aAAa,CAAC;YACzB,GAAG;YACH,MAAM,EAAE,MAAM;YACd,OAAO;YACP,OAAO,EAAE,OAAO,IAAI,EAAE;YACtB,eAAe,EAAE,eAAe,IAAI,IAAI;SACzC,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChF,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QAEhE,OAAO,iBAAiB,CACtB,IAAI,EACJ,SAAS,EACT,sBAAsB,EACtB,sBAAsB,EACtB,yBAAyB,EACzB,OAAO,KAAK,KAAK,CAClB,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAllTools(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAMjD"}

package/dist/tools/index.js

@@ -0,0 +1,17 @@
+import { shouldRegisterTool } from "@paretools/shared";
+import { registerRequestTool } from "./request.js";
+import { registerGetTool } from "./get.js";
+import { registerPostTool } from "./post.js";
+import { registerHeadTool } from "./head.js";
+export function registerAllTools(server) {
+    const s = (name) => shouldRegisterTool("http", name);
+    if (s("request"))
+        registerRequestTool(server);
+    if (s("get"))
+        registerGetTool(server);
+    if (s("post"))
+        registerPostTool(server);
+    if (s("head"))
+        registerHeadTool(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7D,IAAI,CAAC,CAAC,SAAS,CAAC;QAAE,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,KAAK,CAAC;QAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC,MAAM,CAAC;QAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,CAAC,MAAM,CAAC;QAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/tools/post.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPostTool(server: McpServer): void;
+//# sourceMappingURL=post.d.ts.map

package/dist/tools/post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../src/tools/post.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,QAsFjD"}

package/dist/tools/post.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { compactDualOutput, INPUT_LIMITS } from "@paretools/shared";
+import { curlCmd } from "../lib/curl-runner.js";
+import { parseCurlOutput } from "../lib/parsers.js";
+import { formatHttpResponse, compactResponseMap, formatResponseCompact, } from "../lib/formatters.js";
+import { HttpResponseSchema } from "../schemas/index.js";
+import { assertSafeUrl } from "../lib/url-validation.js";
+import { buildCurlArgs } from "./request.js";
+export function registerPostTool(server) {
+    server.registerTool("post", {
+        title: "HTTP POST",
+        description: "Makes an HTTP POST request via curl and returns structured response data. Convenience wrapper for the request tool with required body.",
+        inputSchema: {
+            url: z
+                .string()
+                .max(INPUT_LIMITS.STRING_MAX)
+                .describe("The URL to request (http:// or https:// only)"),
+            body: z.string().max(INPUT_LIMITS.STRING_MAX).describe("Request body"),
+            headers: z
+                .record(z.string().max(INPUT_LIMITS.SHORT_STRING_MAX), z.string().max(INPUT_LIMITS.STRING_MAX))
+                .optional()
+                .describe("Request headers as key-value pairs"),
+            contentType: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .optional()
+                .default("application/json")
+                .describe("Content-Type header (default: application/json)"),
+            timeout: z
+                .number()
+                .min(1)
+                .max(300)
+                .optional()
+                .default(30)
+                .describe("Request timeout in seconds (default: 30)"),
+            followRedirects: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Follow HTTP redirects (default: true)"),
+            compact: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema."),
+            path: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("Working directory (default: cwd)"),
+        },
+        outputSchema: HttpResponseSchema,
+    }, async ({ url, body, headers, contentType, timeout, followRedirects, compact, path }) => {
+        assertSafeUrl(url);
+        // Merge content-type header with user-supplied headers
+        const mergedHeaders = {
+            "Content-Type": contentType ?? "application/json",
+            ...headers,
+        };
+        const args = buildCurlArgs({
+            url,
+            method: "POST",
+            headers: mergedHeaders,
+            body,
+            timeout: timeout ?? 30,
+            followRedirects: followRedirects ?? true,
+        });
+        const cwd = path || process.cwd();
+        const result = await curlCmd(args, cwd);
+        const data = parseCurlOutput(result.stdout, result.stderr, result.exitCode);
+        const rawOutput = (result.stdout + "\n" + result.stderr).trim();
+        return compactDualOutput(data, rawOutput, formatHttpResponse, compactResponseMap, formatResponseCompact, compact === false);
+    });
+}
+//# sourceMappingURL=post.js.map

package/dist/tools/post.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.js","sourceRoot":"","sources":["../../src/tools/post.ts"],"names":[],"mappings":"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"}

package/dist/tools/request.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerRequestTool(server: McpServer): void;
+/**
+ * Builds the curl argument array from the request parameters.
+ * Exported for reuse in get/post/head tools.
+ */
+export declare function buildCurlArgs(opts: {
+    url: string;
+    method: string;
+    headers?: Record<string, string>;
+    body?: string;
+    timeout: number;
+    followRedirects: boolean;
+}): string[];
+//# sourceMappingURL=request.d.ts.map

package/dist/tools/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/tools/request.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAczE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,QA+EpD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,OAAO,CAAC;CAC1B,GAAG,MAAM,EAAE,CA2CX"}

package/dist/tools/request.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import { compactDualOutput, assertNoFlagInjection, INPUT_LIMITS } from "@paretools/shared";
+import { curlCmd } from "../lib/curl-runner.js";
+import { parseCurlOutput, PARE_META_SEPARATOR } from "../lib/parsers.js";
+import { formatHttpResponse, compactResponseMap, formatResponseCompact, } from "../lib/formatters.js";
+import { HttpResponseSchema } from "../schemas/index.js";
+import { assertSafeUrl, assertSafeHeader } from "../lib/url-validation.js";
+const METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
+export function registerRequestTool(server) {
+    server.registerTool("request", {
+        title: "HTTP Request",
+        description: "Makes an HTTP request via curl and returns structured response data (status, headers, body, timing). Use instead of running `curl` in the terminal.",
+        inputSchema: {
+            url: z
+                .string()
+                .max(INPUT_LIMITS.STRING_MAX)
+                .describe("The URL to request (http:// or https:// only)"),
+            method: z.enum(METHODS).optional().default("GET").describe("HTTP method (default: GET)"),
+            headers: z
+                .record(z.string().max(INPUT_LIMITS.SHORT_STRING_MAX), z.string().max(INPUT_LIMITS.STRING_MAX))
+                .optional()
+                .describe("Request headers as key-value pairs"),
+            body: z
+                .string()
+                .max(INPUT_LIMITS.STRING_MAX)
+                .optional()
+                .describe("Request body (for POST, PUT, PATCH)"),
+            timeout: z
+                .number()
+                .min(1)
+                .max(300)
+                .optional()
+                .default(30)
+                .describe("Request timeout in seconds (default: 30)"),
+            followRedirects: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Follow HTTP redirects (default: true)"),
+            compact: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe("Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema."),
+            path: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("Working directory (default: cwd)"),
+        },
+        outputSchema: HttpResponseSchema,
+    }, async ({ url, method, headers, body, timeout, followRedirects, compact, path }) => {
+        assertSafeUrl(url);
+        const args = buildCurlArgs({
+            url,
+            method: method ?? "GET",
+            headers,
+            body,
+            timeout: timeout ?? 30,
+            followRedirects: followRedirects ?? true,
+        });
+        const cwd = path || process.cwd();
+        const result = await curlCmd(args, cwd);
+        const data = parseCurlOutput(result.stdout, result.stderr, result.exitCode);
+        const rawOutput = (result.stdout + "\n" + result.stderr).trim();
+        return compactDualOutput(data, rawOutput, formatHttpResponse, compactResponseMap, formatResponseCompact, compact === false);
+    });
+}
+/**
+ * Builds the curl argument array from the request parameters.
+ * Exported for reuse in get/post/head tools.
+ */
+export function buildCurlArgs(opts) {
+    const args = [
+        "-s", // Silent mode (no progress)
+        "-S", // Show errors
+        "-i", // Include response headers in output
+    ];
+    // Write-out format for timing and size metadata
+    const writeOut = `\n${PARE_META_SEPARATOR}\n%{time_total} %{size_download}`;
+    args.push("-w", writeOut);
+    // HTTP method
+    args.push("-X", opts.method);
+    // Timeout
+    args.push("--max-time", String(opts.timeout));
+    // Follow redirects
+    if (opts.followRedirects) {
+        args.push("-L");
+        // Limit redirect hops to prevent infinite loops
+        args.push("--max-redirs", "10");
+    }
+    // Custom headers
+    if (opts.headers) {
+        for (const [key, value] of Object.entries(opts.headers)) {
+            assertNoFlagInjection(key, "header key");
+            assertNoFlagInjection(value, "header value");
+            assertSafeHeader(key, value);
+            args.push("-H", `${key}: ${value}`);
+        }
+    }
+    // Request body
+    if (opts.body) {
+        args.push("--data-raw", opts.body);
+    }
+    // URL must be last
+    args.push(opts.url);
+    return args;
+}
+//# sourceMappingURL=request.js.map

package/dist/tools/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/tools/request.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@paretools/http",
+  "version": "0.7.0",
+  "mcpName": "io.github.Dave-London/http",
+  "description": "MCP server for HTTP requests (curl) with structured, token-efficient output",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "structured-output",
+    "ai",
+    "ai-agent",
+    "claude",
+    "cursor",
+    "copilot",
+    "token-efficient",
+    "devtools",
+    "cli",
+    "http",
+    "curl",
+    "rest",
+    "api",
+    "request"
+  ],
+  "homepage": "https://github.com/Dave-London/Pare/tree/main/packages/server-http",
+  "engines": {
+    "node": ">=20"
+  },
+  "type": "module",
+  "bin": {
+    "pare-http": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Dave-London/Pare.git",
+    "directory": "packages/server-http"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^4.3.6",
+    "@paretools/shared": "0.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18",
+    "@paretools/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/"
+  }
+}