@floppydata/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Floppydata
+
+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/README.md

@@ -0,0 +1,168 @@
+# Floppydata MCP
+
+Floppydata MCP lets agents use the Floppydata Client API v2 directly from an MCP-compatible client.
+
+It is intentionally small: install it with `npx`, provide `FLOPPYDATA_API_KEY`, and the server talks to `https://api.floppydata.net`.
+
+## Setup
+
+Create a Client API key in the Floppydata dashboard:
+
+https://app.floppydata.com/api-keys
+
+Add this server to your MCP client:
+
+```json
+{
+  "mcpServers": {
+    "floppydata": {
+      "command": "npx",
+      "args": ["-y", "@floppydata/mcp"],
+      "env": {
+        "FLOPPYDATA_API_KEY": "YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+That is the whole setup. There is no hosted service, no extra CLI, and no base URL configuration.
+
+## Tools
+
+### `fetch_web_data`
+
+Fetch a public page through Web Data.
+
+Useful when an agent needs page HTML and the target site should be fetched through Floppydata infrastructure.
+
+Required input:
+
+```json
+{
+  "url": "https://example.com"
+}
+```
+
+Optional inputs: `countryCode`, `city`, `difficulty`, `cacheMaxAgeDays`.
+
+### `create_rotating_proxy_connection`
+
+Build one rotating proxy connection.
+
+The most important value in the response is:
+
+```text
+connection.connectionString
+```
+
+Example input:
+
+```json
+{
+  "type": "residential",
+  "country": "US",
+  "city": "New York",
+  "rotation": 15,
+  "protocol": "http"
+}
+```
+
+### `list_rotating_proxy_locations`
+
+List available rotating proxy countries, cities, and states for a proxy type.
+
+Example input:
+
+```json
+{
+  "type": "residential"
+}
+```
+
+### `check_proxy`
+
+Check the exit IP and location for a proxy.
+
+Example input:
+
+```json
+{
+  "connectionString": "http://USERNAME:PASSWORD@geo.g-w.info:10080"
+}
+```
+
+The response shape is:
+
+```json
+{
+  "ip": "123.45.67.89",
+  "location": {
+    "countryCode": "US",
+    "country": "United States",
+    "state": "California",
+    "city": "San Francisco"
+  }
+}
+```
+
+### `list_static_proxies`
+
+List static proxies on the account.
+
+Use `items[n].connection.connectionString` as the copy-paste proxy URL.
+
+### `get_account_balances`
+
+Check account balances across Web Data, rotating proxy traffic, and static proxies.
+
+Optional input:
+
+```json
+{
+  "product": "proxy-rotating"
+}
+```
+
+Allowed products: `web-data`, `proxy-rotating`, `proxy-static`.
+
+### `get_account_usage`
+
+Check account usage rollups.
+
+Responses include:
+
+- `yesterday`
+- `last7Days`
+- `last30Days`
+- optional `requestedRange` when `from` or `to` is provided
+- `lastUpdatedAt`
+
+Example input:
+
+```json
+{
+  "product": "proxy-rotating",
+  "from": "2026-06-01T00:00:00Z",
+  "to": "2026-06-26T23:59:59Z",
+  "countryCode": "US",
+  "proxyType": "residential"
+}
+```
+
+## Security
+
+The server reads the API key from `FLOPPYDATA_API_KEY` and sends it as `X-Api-Key`.
+
+API keys and passwords are redacted from errors and logs. Proxy passwords are still returned in successful proxy connection responses because those credentials are the output customers need to use.
+
+## Development
+
+```bash
+pnpm install
+pnpm test
+pnpm typecheck
+pnpm lint
+pnpm build
+npm pack --dry-run
+```

package/dist/api.d.ts

@@ -0,0 +1,53 @@
+import type { FetchLike, JsonObject } from "./types.js";
+type QueryValue = string | number | boolean | null | undefined;
+export declare class FloppydataApiError extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    readonly details?: unknown;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        details?: unknown;
+        cause?: unknown;
+    });
+}
+export interface FloppydataApiClientOptions {
+    apiKey: string;
+    fetcher?: FetchLike;
+    timeoutMs?: number;
+}
+export interface RequestOptions {
+    query?: Record<string, QueryValue>;
+    body?: unknown;
+}
+export declare class FloppydataApiClient {
+    private readonly apiKey;
+    private readonly fetcher;
+    private readonly timeoutMs;
+    constructor(options: FloppydataApiClientOptions);
+    fetchWebData(input: unknown): Promise<JsonObject>;
+    createRotatingProxyConnection(input: unknown): Promise<JsonObject>;
+    listRotatingProxyLocations(input: {
+        type: string;
+    }): Promise<JsonObject>;
+    checkProxy(input: unknown): Promise<JsonObject>;
+    listStaticProxies(): Promise<JsonObject>;
+    getAccountBalances(input: {
+        product?: string;
+    }): Promise<JsonObject>;
+    getAccountUsage(input: {
+        product?: string;
+        from?: string;
+        to?: string;
+        poolId?: number;
+        countryCode?: string;
+        proxyType?: string;
+    }): Promise<JsonObject>;
+    private request;
+    private toNetworkError;
+    private toApiError;
+}
+export declare function getApiKeyFromEnv(env?: NodeJS.ProcessEnv): string;
+export declare function redactSecrets(value: unknown, apiKey?: string): string;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,KAAK,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/D,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAGzB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,KAAK,CAAC,EAAE,OAAO,CAAC;KACZ;CAQT;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,0BAA0B;IAMzC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAIjD,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAIlE,0BAA0B,CAAC,KAAK,EAAE;QACtC,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,UAAU,CAAC;IAMjB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/C,iBAAiB,IAAI,OAAO,CAAC,UAAU,CAAC;IAIxC,kBAAkB,CAAC,KAAK,EAAE;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,UAAU,CAAC;IAMjB,eAAe,CAAC,KAAK,EAAE;QAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,UAAU,CAAC;YAaT,OAAO;IAkCrB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,UAAU;CAcnB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAU7E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAMrE"}

package/dist/api.js

@@ -0,0 +1,197 @@
+import { DEFAULT_TIMEOUT_MS, FLOPPYDATA_API_BASE_URL, FLOPPYDATA_API_KEY_ENV } from "./constants.js";
+export class FloppydataApiError extends Error {
+    status;
+    code;
+    details;
+    constructor(message, options = {}) {
+        super(message, { cause: options.cause });
+        this.name = "FloppydataApiError";
+        this.status = options.status;
+        this.code = options.code;
+        this.details = options.details;
+    }
+}
+export class FloppydataApiClient {
+    apiKey;
+    fetcher;
+    timeoutMs;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.fetcher = options.fetcher ?? fetch;
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    }
+    async fetchWebData(input) {
+        return this.request("POST", "/v2/web-data/fetch", { body: input });
+    }
+    async createRotatingProxyConnection(input) {
+        return this.request("POST", "/v2/proxy/rotating/connections", { body: input });
+    }
+    async listRotatingProxyLocations(input) {
+        return this.request("GET", "/v2/proxy/rotating/locations", {
+            query: { type: input.type }
+        });
+    }
+    async checkProxy(input) {
+        return this.request("POST", "/v2/proxy/check", { body: input });
+    }
+    async listStaticProxies() {
+        return this.request("GET", "/v2/proxy/static");
+    }
+    async getAccountBalances(input) {
+        return this.request("GET", "/v2/account/balances", {
+            query: { product: input.product }
+        });
+    }
+    async getAccountUsage(input) {
+        return this.request("GET", "/v2/account/usage", {
+            query: {
+                product: input.product,
+                from: input.from,
+                to: input.to,
+                poolId: input.poolId,
+                countryCode: input.countryCode,
+                proxyType: input.proxyType
+            }
+        });
+    }
+    async request(method, path, options = {}) {
+        const url = new URL(path, FLOPPYDATA_API_BASE_URL);
+        appendQuery(url, options.query);
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        let response;
+        try {
+            response = await this.fetcher(url.toString(), {
+                method,
+                headers: buildHeaders(this.apiKey, options.body !== undefined),
+                body: options.body === undefined ? undefined : JSON.stringify(options.body),
+                signal: controller.signal
+            });
+        }
+        catch (error) {
+            throw this.toNetworkError(error);
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        const payload = await parseJsonPayload(response);
+        if (!response.ok) {
+            throw this.toApiError(response.status, payload);
+        }
+        return payload ?? {};
+    }
+    toNetworkError(error) {
+        const message = error instanceof Error && error.name === "AbortError"
+            ? "Floppydata API request timed out"
+            : `Floppydata API request failed: ${errorMessage(error)}`;
+        return new FloppydataApiError(redactSecrets(message, this.apiKey), {
+            cause: error
+        });
+    }
+    toApiError(status, payload) {
+        const errorPayload = readErrorPayload(payload);
+        const message = errorPayload.message ?? `Floppydata API request failed with status ${status}`;
+        return new FloppydataApiError(redactSecrets(message, this.apiKey), {
+            status,
+            code: errorPayload.code,
+            details: errorPayload.details === undefined
+                ? undefined
+                : redactUnknown(errorPayload.details, this.apiKey)
+        });
+    }
+}
+export function getApiKeyFromEnv(env = process.env) {
+    const apiKey = env[FLOPPYDATA_API_KEY_ENV]?.trim();
+    if (!apiKey) {
+        throw new Error(`${FLOPPYDATA_API_KEY_ENV} is required. Create an API key at https://app.floppydata.com/api-keys and pass it as an environment variable.`);
+    }
+    return apiKey;
+}
+export function redactSecrets(value, apiKey) {
+    if (typeof value === "string") {
+        return redactString(value, apiKey);
+    }
+    return redactString(JSON.stringify(redactUnknown(value, apiKey)), apiKey);
+}
+function appendQuery(url, query) {
+    if (!query) {
+        return;
+    }
+    for (const [key, value] of Object.entries(query)) {
+        if (value !== undefined && value !== null) {
+            url.searchParams.set(key, String(value));
+        }
+    }
+}
+function buildHeaders(apiKey, hasBody) {
+    const headers = {
+        Accept: "application/json",
+        "X-Api-Key": apiKey
+    };
+    if (hasBody) {
+        headers["Content-Type"] = "application/json";
+    }
+    return headers;
+}
+async function parseJsonPayload(response) {
+    const text = await response.text();
+    if (!text) {
+        return null;
+    }
+    try {
+        const payload = JSON.parse(text);
+        return isRecord(payload) ? payload : null;
+    }
+    catch {
+        return null;
+    }
+}
+function readErrorPayload(payload) {
+    if (!isRecord(payload)) {
+        return {};
+    }
+    const nestedError = isRecord(payload.error) ? payload.error : undefined;
+    const source = nestedError ?? payload;
+    return {
+        message: readString(source.message),
+        code: readString(source.code),
+        details: source.details
+    };
+}
+function readString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function redactUnknown(value, apiKey) {
+    if (typeof value === "string") {
+        return redactString(value, apiKey);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => redactUnknown(item, apiKey));
+    }
+    if (!isRecord(value)) {
+        return value;
+    }
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => {
+        if (isSecretField(key)) {
+            return [key, "[REDACTED]"];
+        }
+        return [key, redactUnknown(entry, apiKey)];
+    }));
+}
+function redactString(value, apiKey) {
+    let output = value;
+    if (apiKey) {
+        output = output.split(apiKey).join("[REDACTED_API_KEY]");
+    }
+    return output.replace(/([a-z][a-z0-9+.-]*:\/\/[^:\s/@]+:)([^@\s/]+)(@)/gi, "$1[REDACTED_PASSWORD]$3");
+}
+function isSecretField(key) {
+    return /^(api[-_]?key|authorization|password|pass|token|secret)$/i.test(key);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const FLOPPYDATA_API_BASE_URL = "https://api.floppydata.net";
+export declare const FLOPPYDATA_API_KEY_ENV = "FLOPPYDATA_API_KEY";
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,+BAA+B,CAAC;AACpE,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAC3D,eAAO,MAAM,kBAAkB,QAAS,CAAC"}

package/dist/constants.js

@@ -0,0 +1,4 @@
+export const FLOPPYDATA_API_BASE_URL = "https://api.floppydata.net";
+export const FLOPPYDATA_API_KEY_ENV = "FLOPPYDATA_API_KEY";
+export const DEFAULT_TIMEOUT_MS = 30_000;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,4BAA4B,CAAC;AACpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC"}

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,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createFloppydataMcpServer } from "./server.js";
+async function main() {
+    const server = createFloppydataMcpServer();
+    await server.connect(new StdioServerTransport());
+}
+main().catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAExD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,yBAAyB,EAAE,CAAC;IAC3C,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { FetchLike, JsonObject } from "./types.js";
+export interface CreateFloppydataMcpServerOptions {
+    apiKey?: string;
+    fetcher?: FetchLike;
+    timeoutMs?: number;
+}
+export declare function createFloppydataMcpServer(options?: CreateFloppydataMcpServerOptions): McpServer;
+export declare function formatToolResult(summary: string, output: JsonObject): CallToolResult;
+export declare function toSafeToolError(error: unknown, apiKey?: string): Error;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AASzE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,gCAAgC;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,yBAAyB,CACvC,OAAO,GAAE,gCAAqC,GAC7C,SAAS,CAkCX;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,UAAU,GACjB,cAAc,CAUhB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAqBtE"}

package/dist/server.js

@@ -0,0 +1,62 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ZodError } from "zod";
+import { FloppydataApiClient, FloppydataApiError, getApiKeyFromEnv, redactSecrets } from "./api.js";
+import { toolDefinitions } from "./tool-definitions.js";
+export function createFloppydataMcpServer(options = {}) {
+    const apiKey = options.apiKey ?? getApiKeyFromEnv();
+    const client = new FloppydataApiClient({
+        apiKey,
+        fetcher: options.fetcher,
+        timeoutMs: options.timeoutMs
+    });
+    const server = new McpServer({
+        name: "floppydata",
+        version: "0.1.0"
+    });
+    for (const definition of toolDefinitions) {
+        server.registerTool(definition.name, {
+            description: definition.description,
+            inputSchema: definition.inputShape
+        }, async (rawInput) => {
+            try {
+                const input = definition.inputSchema.parse(rawInput);
+                const output = await definition.execute(client, input);
+                const summary = definition.summarize(output);
+                return formatToolResult(summary, output);
+            }
+            catch (error) {
+                throw toSafeToolError(error, apiKey);
+            }
+        });
+    }
+    return server;
+}
+export function formatToolResult(summary, output) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${summary}\n\n${JSON.stringify(output, null, 2)}`
+            }
+        ],
+        structuredContent: output
+    };
+}
+export function toSafeToolError(error, apiKey) {
+    if (error instanceof ZodError) {
+        return new Error(`Invalid tool input: ${error.issues.map((issue) => issue.message).join("; ")}`);
+    }
+    if (error instanceof FloppydataApiError) {
+        const context = [
+            error.status ? `status ${error.status}` : undefined,
+            error.code ? `code ${error.code}` : undefined
+        ]
+            .filter(Boolean)
+            .join(", ");
+        const suffix = context ? ` (${context})` : "";
+        return new Error(`${error.message}${suffix}`);
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return new Error(redactSecrets(message, apiKey));
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AASxD,MAAM,UAAU,yBAAyB,CACvC,UAA4C,EAAE;IAE9C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,gBAAgB,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC;QACrC,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,KAAK,MAAM,UAAU,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,CAAC,YAAY,CACjB,UAAU,CAAC,IAAI,EACf;YACE,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,WAAW,EAAE,UAAU,CAAC,UAAU;SACnC,EACD,KAAK,EAAE,QAAQ,EAAE,EAAE;YACjB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACrD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACvD,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBAE7C,OAAO,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,MAAkB;IAElB,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,GAAG,OAAO,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;aACzD;SACF;QACD,iBAAiB,EAAE,MAAM;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc,EAAE,MAAe;IAC7D,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,KAAK,CACd,uBAAuB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/E,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,MAAM,OAAO,GAAG;YACd,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;YACnD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;SAC9C;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,IAAI,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/tool-definitions.d.ts

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import type { FloppydataApiClient } from "./api.js";
+import type { JsonObject } from "./types.js";
+export declare const fetchWebDataInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    countryCode: z.ZodOptional<z.ZodString>;
+    city: z.ZodOptional<z.ZodString>;
+    difficulty: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+    }>>;
+    cacheMaxAgeDays: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const rotatingConnectionInputSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        residential: "residential";
+        mobile: "mobile";
+        datacenter: "datacenter";
+    }>;
+    country: z.ZodString;
+    city: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodString>;
+    asn: z.ZodOptional<z.ZodString>;
+    rotation: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<-1>, z.ZodLiteral<0>, z.ZodLiteral<5>, z.ZodLiteral<10>, z.ZodLiteral<15>, z.ZodLiteral<20>, z.ZodLiteral<60>]>>;
+    session: z.ZodOptional<z.ZodString>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        http: "http";
+        https: "https";
+        socks5: "socks5";
+    }>>;
+}, z.core.$strict>;
+export declare const rotatingLocationsInputSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        residential: "residential";
+        mobile: "mobile";
+        datacenter: "datacenter";
+    }>;
+}, z.core.$strict>;
+export declare const checkProxyInputSchema: z.ZodObject<{
+    connectionString: z.ZodOptional<z.ZodString>;
+    host: z.ZodOptional<z.ZodString>;
+    port: z.ZodOptional<z.ZodNumber>;
+    username: z.ZodOptional<z.ZodString>;
+    password: z.ZodOptional<z.ZodString>;
+    protocol: z.ZodOptional<z.ZodEnum<{
+        http: "http";
+        https: "https";
+        socks5: "socks5";
+    }>>;
+}, z.core.$strict>;
+export declare const accountBalancesInputSchema: z.ZodObject<{
+    product: z.ZodOptional<z.ZodEnum<{
+        "web-data": "web-data";
+        "proxy-rotating": "proxy-rotating";
+        "proxy-static": "proxy-static";
+    }>>;
+}, z.core.$strict>;
+export declare const accountUsageInputSchema: z.ZodObject<{
+    product: z.ZodOptional<z.ZodEnum<{
+        "web-data": "web-data";
+        "proxy-rotating": "proxy-rotating";
+    }>>;
+    from: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodString>;
+    poolId: z.ZodOptional<z.ZodNumber>;
+    countryCode: z.ZodOptional<z.ZodString>;
+    proxyType: z.ZodOptional<z.ZodEnum<{
+        residential: "residential";
+        mobile: "mobile";
+        datacenter: "datacenter";
+    }>>;
+}, z.core.$strict>;
+export interface ToolDefinition<Input> {
+    readonly name: string;
+    readonly description: string;
+    readonly inputShape: z.ZodRawShape;
+    readonly inputSchema: z.ZodType<Input>;
+    readonly execute: (client: FloppydataApiClient, input: Input) => Promise<JsonObject>;
+    readonly summarize: (output: JsonObject) => string;
+}
+export interface RuntimeToolDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly inputShape: z.ZodRawShape;
+    readonly inputSchema: z.ZodType<unknown>;
+    readonly execute: (client: FloppydataApiClient, input: unknown) => Promise<JsonObject>;
+    readonly summarize: (output: JsonObject) => string;
+}
+export declare const toolDefinitions: RuntimeToolDefinition[];
+export type ToolName = (typeof toolDefinitions)[number]["name"];
+export declare function runFloppydataTool(client: FloppydataApiClient, name: ToolName, input: unknown): Promise<JsonObject>;
+export declare function getToolSummary(name: ToolName, output: JsonObject): string;
+//# sourceMappingURL=tool-definitions.d.ts.map

package/dist/tool-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-definitions.d.ts","sourceRoot":"","sources":["../src/tool-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiH7C,eAAO,MAAM,uBAAuB;;;;;;;;;kBAAuC,CAAC;AAC5E,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;kBAE/B,CAAC;AACZ,eAAO,MAAM,4BAA4B;;;;;;kBAE9B,CAAC;AACZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;kBAkB9B,CAAC;AACL,eAAO,MAAM,0BAA0B;;;;;;kBAA0C,CAAC;AAClF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;kBAAuC,CAAC;AAE5E,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,CAChB,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,KAAK,KACT,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,CAAC;CACpD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,CAChB,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,MAAM,CAAC;CACpD;AAYD,eAAO,MAAM,eAAe,yBAgE3B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC,CASrB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAGzE"}

package/dist/tool-definitions.js

@@ -0,0 +1,260 @@
+import { z } from "zod";
+const proxyTypeSchema = z.enum(["residential", "mobile", "datacenter"]);
+const protocolSchema = z.enum(["http", "https", "socks5"]);
+const rotationSchema = z.union([
+    z.literal(-1),
+    z.literal(0),
+    z.literal(5),
+    z.literal(10),
+    z.literal(15),
+    z.literal(20),
+    z.literal(60)
+]);
+const accountBalanceProductSchema = z.enum([
+    "web-data",
+    "proxy-rotating",
+    "proxy-static"
+]);
+const accountUsageProductSchema = z.enum(["web-data", "proxy-rotating"]);
+const fetchWebDataShape = {
+    url: z.string().url().describe("Target page URL to fetch through Web Data."),
+    countryCode: z
+        .string()
+        .regex(/^[a-zA-Z]{2}$/)
+        .optional()
+        .describe("Optional 2-letter exit country code, for example US."),
+    city: z.string().min(1).optional().describe("Optional exit city."),
+    difficulty: z
+        .enum(["low", "medium"])
+        .optional()
+        .describe("Optional access difficulty pool."),
+    cacheMaxAgeDays: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe("Optional maximum age of cached content in days.")
+};
+const rotatingConnectionShape = {
+    type: proxyTypeSchema.describe("Proxy type."),
+    country: z
+        .string()
+        .regex(/^[a-zA-Z]{2}$/)
+        .describe("2-letter country code, for example US."),
+    city: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("City from list_rotating_proxy_locations. Ignored when state is supplied."),
+    state: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("State or subdivision from list_rotating_proxy_locations. Wins over city."),
+    asn: z.string().regex(/^\d+$/).optional().describe("Optional target ASN."),
+    rotation: rotationSchema
+        .optional()
+        .describe("-1 for each request, 0 for sticky, or interval minutes."),
+    session: z
+        .string()
+        .min(1)
+        .max(128)
+        .optional()
+        .describe("Optional sticky session id."),
+    protocol: protocolSchema.optional().describe("Proxy protocol. Defaults to http.")
+};
+const rotatingLocationsShape = {
+    type: proxyTypeSchema.describe("Proxy type to list locations for.")
+};
+const checkProxyShape = {
+    connectionString: z
+        .string()
+        .url()
+        .optional()
+        .describe("Proxy URL to check, for example http://user:pass@host:10080."),
+    host: z.string().min(1).optional().describe("Proxy host."),
+    port: z.number().int().optional().describe("Proxy port."),
+    username: z.string().min(1).optional().describe("Proxy username."),
+    password: z.string().min(1).optional().describe("Proxy password."),
+    protocol: protocolSchema.optional().describe("Proxy protocol. Defaults to http.")
+};
+const accountBalancesShape = {
+    product: accountBalanceProductSchema
+        .optional()
+        .describe("Optional product filter.")
+};
+const accountUsageShape = {
+    product: accountUsageProductSchema.optional().describe("Optional product filter."),
+    from: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Optional start date or UTC date-time."),
+    to: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Optional end date or UTC date-time."),
+    poolId: z.number().int().positive().optional().describe("Optional pool id filter."),
+    countryCode: z
+        .string()
+        .regex(/^[a-zA-Z]{2}$/)
+        .optional()
+        .describe("Optional 2-letter country code filter."),
+    proxyType: proxyTypeSchema.optional().describe("Optional rotating proxy type filter.")
+};
+export const fetchWebDataInputSchema = z.object(fetchWebDataShape).strict();
+export const rotatingConnectionInputSchema = z
+    .object(rotatingConnectionShape)
+    .strict();
+export const rotatingLocationsInputSchema = z
+    .object(rotatingLocationsShape)
+    .strict();
+export const checkProxyInputSchema = z
+    .object(checkProxyShape)
+    .strict()
+    .superRefine((input, context) => {
+    if (input.connectionString) {
+        return;
+    }
+    const hasStructuredProxy = input.host && input.port !== undefined && input.username && input.password;
+    if (!hasStructuredProxy) {
+        context.addIssue({
+            code: "custom",
+            message: "Provide connectionString, or provide host, port, username, and password."
+        });
+    }
+});
+export const accountBalancesInputSchema = z.object(accountBalancesShape).strict();
+export const accountUsageInputSchema = z.object(accountUsageShape).strict();
+function defineTool(definition) {
+    return {
+        ...definition,
+        inputSchema: definition.inputSchema,
+        execute: (client, input) => definition.execute(client, input)
+    };
+}
+export const toolDefinitions = [
+    defineTool({
+        name: "fetch_web_data",
+        description: "Fetch a public web page through Floppydata Web Data. Use this when the agent needs the HTML of a URL.",
+        inputShape: fetchWebDataShape,
+        inputSchema: fetchWebDataInputSchema,
+        execute: (client, input) => client.fetchWebData(input),
+        summarize: (output) => summarizeFetchWebData(output)
+    }),
+    defineTool({
+        name: "create_rotating_proxy_connection",
+        description: "Build one copy-paste rotating proxy connection string for a country, state, city, ASN, session, and rotation.",
+        inputShape: rotatingConnectionShape,
+        inputSchema: rotatingConnectionInputSchema,
+        execute: (client, input) => client.createRotatingProxyConnection(input),
+        summarize: (output) => summarizeConnection(output)
+    }),
+    defineTool({
+        name: "list_rotating_proxy_locations",
+        description: "List countries, cities, and states available for rotating proxy connection generation.",
+        inputShape: rotatingLocationsShape,
+        inputSchema: rotatingLocationsInputSchema,
+        execute: (client, input) => client.listRotatingProxyLocations(input),
+        summarize: (output) => summarizeLocations(output)
+    }),
+    defineTool({
+        name: "check_proxy",
+        description: "Check a proxy connection and return the exit IP and location seen through that proxy.",
+        inputShape: checkProxyShape,
+        inputSchema: checkProxyInputSchema,
+        execute: (client, input) => client.checkProxy(input),
+        summarize: (output) => summarizeProxyCheck(output)
+    }),
+    defineTool({
+        name: "list_static_proxies",
+        description: "List static proxies owned by the account, including each proxy connectionString.",
+        inputShape: {},
+        inputSchema: z.object({}).strict(),
+        execute: (client) => client.listStaticProxies(),
+        summarize: (output) => summarizeStaticProxies(output)
+    }),
+    defineTool({
+        name: "get_account_balances",
+        description: "Get account balances for Web Data, rotating proxy traffic, and static proxies.",
+        inputShape: accountBalancesShape,
+        inputSchema: accountBalancesInputSchema,
+        execute: (client, input) => client.getAccountBalances(input),
+        summarize: () => "Fetched account balances."
+    }),
+    defineTool({
+        name: "get_account_usage",
+        description: "Get account usage rollups. Responses include yesterday, last7Days, last30Days, optional requestedRange, and lastUpdatedAt.",
+        inputShape: accountUsageShape,
+        inputSchema: accountUsageInputSchema,
+        execute: (client, input) => client.getAccountUsage(input),
+        summarize: () => "Fetched account usage."
+    })
+];
+export async function runFloppydataTool(client, name, input) {
+    const definition = toolDefinitions.find((tool) => tool.name === name);
+    if (!definition) {
+        throw new Error(`Unknown tool: ${name}`);
+    }
+    const parsedInput = definition.inputSchema.parse(input);
+    return definition.execute(client, parsedInput);
+}
+export function getToolSummary(name, output) {
+    const definition = toolDefinitions.find((tool) => tool.name === name);
+    return definition?.summarize(output) ?? "Floppydata tool completed.";
+}
+function summarizeFetchWebData(output) {
+    if (isRecord(output)) {
+        const sourceUrl = readString(output.sourceUrl);
+        const html = readString(output.html);
+        const fetchedAt = readString(output.fetchedAt);
+        if (sourceUrl && html && fetchedAt) {
+            return `Fetched ${sourceUrl} at ${fetchedAt}. HTML length: ${html.length} characters.`;
+        }
+    }
+    return "Fetched Web Data.";
+}
+function summarizeConnection(output) {
+    const connection = isRecord(output) && isRecord(output.connection)
+        ? output.connection
+        : undefined;
+    const connectionString = connection
+        ? readString(connection.connectionString)
+        : undefined;
+    return connectionString
+        ? `Created rotating proxy connection: ${connectionString}`
+        : "Created rotating proxy connection.";
+}
+function summarizeLocations(output) {
+    if (isRecord(output) && Array.isArray(output.items)) {
+        return `Found ${output.items.length} rotating proxy countries for ${readString(output.type) ?? "the requested type"}.`;
+    }
+    return "Fetched rotating proxy locations.";
+}
+function summarizeProxyCheck(output) {
+    if (isRecord(output)) {
+        const ip = readString(output.ip);
+        const location = isRecord(output.location) ? output.location : undefined;
+        const city = location ? readString(location.city) : undefined;
+        const countryCode = location ? readString(location.countryCode) : undefined;
+        if (ip && countryCode) {
+            return `Proxy exit IP is ${ip}${city ? ` in ${city}` : ""}, ${countryCode}.`;
+        }
+    }
+    return "Checked proxy.";
+}
+function summarizeStaticProxies(output) {
+    if (isRecord(output) && Array.isArray(output.items)) {
+        const pendingCount = typeof output.pendingCount === "number" ? output.pendingCount : 0;
+        return `Found ${output.items.length} static proxies and ${pendingCount} pending proxies.`;
+    }
+    return "Fetched static proxies.";
+}
+function readString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=tool-definitions.js.map

package/dist/tool-definitions.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+export type JsonValue = string | number | boolean | null | JsonValue[] | JsonObject;
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX,UAAU,CAAC;AAEf,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,KACf,OAAO,CAAC,QAAQ,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@floppydata/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the Floppydata Client API v2.",
+  "type": "module",
+  "packageManager": "pnpm@11.8.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Floppydata/floppydata-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Floppydata/floppydata-mcp/issues"
+  },
+  "homepage": "https://github.com/Floppydata/floppydata-mcp#readme",
+  "bin": {
+    "floppydata-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "prepack": "pnpm build"
+  },
+  "keywords": [
+    "floppydata",
+    "mcp",
+    "proxy",
+    "web-data"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/node": "^25.0.3",
+    "eslint": "^9.39.2",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.50.0",
+    "vitest": "^4.0.16"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}