dump-mcp 0.1.0

package/README.md

@@ -0,0 +1,162 @@
+# dump-mcp
+
+[![npm version](https://badge.fury.io/js/dump-mcp.svg)](https://www.npmjs.com/package/dump-mcp)
+
+MCP (Model Context Protocol) server for [dump.xoozoo.com](https://dump.xoozoo.com) - a webhook capture and inspection service.
+
+This server allows AI assistants like Claude to create webhook endpoints, view captured requests, and replay them to local development servers.
+
+## Features
+
+- **Endpoint Management**: Create, list, and delete webhook capture endpoints
+- **Request Viewing**: List and inspect captured webhook requests with full headers and body
+- **Request Replay**: Replay captured requests to target URLs with optional modifications
+
+## Installation
+
+```bash
+npm install -g dump-mcp
+```
+
+Or use directly with npx (no install needed):
+
+```bash
+npx dump-mcp
+```
+
+## Configuration
+
+### 1. Create an Agent Token
+
+1. Log in to [dump.xoozoo.com](https://dump.xoozoo.com)
+2. Click your avatar → **Agent Tokens**
+3. Create a new token and copy it (you'll only see it once)
+
+### 2. Configure Your MCP Client
+
+#### Claude Desktop
+
+Add to your Claude Desktop config file:
+
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "dump": {
+      "command": "npx",
+      "args": ["-y", "dump-mcp"],
+      "env": {
+        "DUMP_API_TOKEN": "dmp_your_token_here"
+      }
+    }
+  }
+}
+```
+
+Or if installed globally:
+
+```json
+{
+  "mcpServers": {
+    "dump": {
+      "command": "dump-mcp",
+      "env": {
+        "DUMP_API_TOKEN": "dmp_your_token_here"
+      }
+    }
+  }
+}
+```
+
+#### Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `DUMP_API_TOKEN` | Yes | Your agent token from dump.xoozoo.com |
+| `DUMP_API_URL` | No | API URL (default: `https://dump.xoozoo.com`) |
+
+## Available Tools
+
+### Endpoint Management
+
+| Tool | Description |
+|------|-------------|
+| `dump_list_teams` | List your teams |
+| `dump_list_endpoints` | List endpoints in a team |
+| `dump_create_endpoint` | Create a new webhook capture endpoint |
+| `dump_get_endpoint` | Get endpoint details and capture URL |
+| `dump_delete_endpoint` | Delete an endpoint |
+
+### Request Viewing
+
+| Tool | Description |
+|------|-------------|
+| `dump_list_requests` | List captured requests (with filtering) |
+| `dump_get_request` | Get full request details (headers, body) |
+
+### Request Replay
+
+| Tool | Description |
+|------|-------------|
+| `dump_replay_request` | Replay a request to a target URL |
+| `dump_get_replay_result` | Get the replay response |
+| `dump_list_replays` | List recent replays |
+
+## Usage Examples
+
+### Create a Webhook Endpoint
+
+> "Create a new webhook endpoint called github-hooks in my team"
+
+The assistant will:
+1. List your teams to find the team ID
+2. Create the endpoint
+3. Return the capture URL to configure in GitHub
+
+### View Captured Requests
+
+> "Show me the last 5 requests to my github-hooks endpoint"
+
+The assistant will list recent requests with method, path, and timestamp.
+
+### Inspect a Request
+
+> "Show me the full details of that POST request"
+
+The assistant will show headers, body, and other details.
+
+### Replay to Local Server
+
+> "Replay that webhook to http://localhost:3000/webhook"
+
+The assistant will replay the captured request to your local development server and show the response.
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/xoozoo/dump.git
+cd dump/dump-mcp
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+DUMP_API_TOKEN=dmp_xxx node dist/index.js
+```
+
+## Security
+
+- Agent tokens have full access to your account's endpoints and requests
+- Tokens are hashed before storage; the raw token is only shown once
+- Revoke tokens immediately if compromised
+- Use separate tokens for different environments
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,66 @@
+/**
+ * HTTP client for communicating with the dump API
+ */
+import { PaginatedResponse, Team, Endpoint, CreateEndpointParams, CapturedRequest, RequestDetails, ListRequestsParams, Replay, ReplayRequestParams, TokenValidationResponse } from './types.js';
+export declare class DumpApiClient {
+    private baseUrl;
+    private token;
+    constructor(baseUrl: string, token: string);
+    /**
+     * Make an authenticated request to the API
+     */
+    private request;
+    /**
+     * Validate the token and get user info
+     */
+    validateToken(): Promise<TokenValidationResponse>;
+    /**
+     * List all teams the user has access to
+     */
+    listTeams(): Promise<Team[]>;
+    /**
+     * Get a specific team
+     */
+    getTeam(teamId: string): Promise<Team>;
+    /**
+     * List endpoints in a team
+     */
+    listEndpoints(teamId: string): Promise<Endpoint[]>;
+    /**
+     * Create a new endpoint
+     */
+    createEndpoint(teamId: string, params: CreateEndpointParams): Promise<Endpoint>;
+    /**
+     * Get endpoint details
+     */
+    getEndpoint(teamId: string, endpointId: string): Promise<Endpoint>;
+    /**
+     * Delete an endpoint
+     */
+    deleteEndpoint(teamId: string, endpointId: string): Promise<void>;
+    /**
+     * List captured requests for an endpoint
+     */
+    listRequests(teamId: string, endpointId: string, params?: ListRequestsParams): Promise<PaginatedResponse<CapturedRequest>>;
+    /**
+     * Get a specific request's details
+     */
+    getRequest(teamId: string, endpointId: string, requestId: string): Promise<RequestDetails>;
+    /**
+     * Get a request's full payload/body
+     */
+    getRequestPayload(teamId: string, endpointId: string, requestId: string): Promise<string>;
+    /**
+     * Replay a captured request to a target URL
+     */
+    replayRequest(teamId: string, endpointId: string, requestId: string, params: ReplayRequestParams): Promise<Replay>;
+    /**
+     * List replays for a team
+     */
+    listReplays(teamId: string): Promise<Replay[]>;
+    /**
+     * Get a specific replay's details
+     */
+    getReplay(teamId: string, replayId: string): Promise<Replay>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,iBAAiB,EACjB,IAAI,EACJ,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,MAAM,EACN,mBAAmB,EACnB,uBAAuB,EAExB,MAAM,YAAY,CAAC;AAEpB,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;gBAEV,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAM1C;;OAEG;YACW,OAAO;IAoCrB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,uBAAuB,CAAC;IA2BvD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAKlC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAQxD;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC;IASrF;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQxE;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvE;;OAEG;IACG,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;IAe9C;;OAEG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC;IAQ1B;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC;IAUlB;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,MAAM,CAAC;IASlB;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQpD;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAOnE"}

package/dist/api-client.js

@@ -0,0 +1,160 @@
+/**
+ * HTTP client for communicating with the dump API
+ */
+import { DumpApiError, } from './types.js';
+export class DumpApiClient {
+    baseUrl;
+    token;
+    constructor(baseUrl, token) {
+        // Remove trailing slash if present
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+        this.token = token;
+    }
+    /**
+     * Make an authenticated request to the API
+     */
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Authorization': `Bearer ${this.token}`,
+            'Content-Type': 'application/json',
+            'Accept': 'application/json',
+        };
+        const options = {
+            method,
+            headers,
+        };
+        if (body !== undefined) {
+            options.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, options);
+        const data = await response.json();
+        if (!response.ok || data.error) {
+            throw new DumpApiError(data.message || `HTTP ${response.status}`, response.status, data.code);
+        }
+        // Return the data field if present, otherwise return the whole response
+        return (data.data ?? data);
+    }
+    /**
+     * Validate the token and get user info
+     */
+    async validateToken() {
+        // This endpoint doesn't use auth header, it validates the token in body
+        const url = `${this.baseUrl}/api/agent/validate`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+            },
+            body: JSON.stringify({ token: this.token }),
+        });
+        const data = await response.json();
+        if (!response.ok || data.error) {
+            throw new DumpApiError(data.message || 'Invalid token', response.status, data.code);
+        }
+        return data.data;
+    }
+    // ============ Team Methods ============
+    /**
+     * List all teams the user has access to
+     */
+    async listTeams() {
+        const result = await this.request('GET', '/api/v1/teams');
+        return result.teams;
+    }
+    /**
+     * Get a specific team
+     */
+    async getTeam(teamId) {
+        const result = await this.request('GET', `/api/v1/teams/${teamId}`);
+        return result.team;
+    }
+    // ============ Endpoint Methods ============
+    /**
+     * List endpoints in a team
+     */
+    async listEndpoints(teamId) {
+        const result = await this.request('GET', `/api/v1/teams/${teamId}/endpoints`);
+        return result.endpoints;
+    }
+    /**
+     * Create a new endpoint
+     */
+    async createEndpoint(teamId, params) {
+        const result = await this.request('POST', `/api/v1/teams/${teamId}/endpoints`, params);
+        return result.endpoint;
+    }
+    /**
+     * Get endpoint details
+     */
+    async getEndpoint(teamId, endpointId) {
+        const result = await this.request('GET', `/api/v1/teams/${teamId}/endpoints/${endpointId}`);
+        return result.endpoint;
+    }
+    /**
+     * Delete an endpoint
+     */
+    async deleteEndpoint(teamId, endpointId) {
+        await this.request('DELETE', `/api/v1/teams/${teamId}/endpoints/${endpointId}`);
+    }
+    // ============ Request Methods ============
+    /**
+     * List captured requests for an endpoint
+     */
+    async listRequests(teamId, endpointId, params = {}) {
+        const queryParams = new URLSearchParams();
+        if (params.page)
+            queryParams.set('page', params.page.toString());
+        if (params.per_page)
+            queryParams.set('per_page', params.per_page.toString());
+        if (params.method)
+            queryParams.set('method', params.method);
+        if (params.search)
+            queryParams.set('search', params.search);
+        if (params.since)
+            queryParams.set('since', params.since);
+        if (params.until)
+            queryParams.set('until', params.until);
+        const queryString = queryParams.toString();
+        const path = `/api/v1/teams/${teamId}/endpoints/${endpointId}/requests${queryString ? `?${queryString}` : ''}`;
+        return this.request('GET', path);
+    }
+    /**
+     * Get a specific request's details
+     */
+    async getRequest(teamId, endpointId, requestId) {
+        const result = await this.request('GET', `/api/v1/teams/${teamId}/endpoints/${endpointId}/requests/${requestId}`);
+        return result.request;
+    }
+    /**
+     * Get a request's full payload/body
+     */
+    async getRequestPayload(teamId, endpointId, requestId) {
+        const result = await this.request('GET', `/api/v1/teams/${teamId}/endpoints/${endpointId}/requests/${requestId}/payload`);
+        return result.payload;
+    }
+    // ============ Replay Methods ============
+    /**
+     * Replay a captured request to a target URL
+     */
+    async replayRequest(teamId, endpointId, requestId, params) {
+        const result = await this.request('POST', `/api/v1/teams/${teamId}/endpoints/${endpointId}/requests/${requestId}/replay`, params);
+        return result.replay;
+    }
+    /**
+     * List replays for a team
+     */
+    async listReplays(teamId) {
+        const result = await this.request('GET', `/api/v1/teams/${teamId}/replays`);
+        return result.replays;
+    }
+    /**
+     * Get a specific replay's details
+     */
+    async getReplay(teamId, replayId) {
+        const result = await this.request('GET', `/api/v1/teams/${teamId}/replays/${replayId}`);
+        return result.replay;
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Entry point for dump-mcp server
+ *
+ * Usage:
+ *   DUMP_API_TOKEN=dmp_xxx node dist/index.js
+ *
+ * Environment variables:
+ *   DUMP_API_TOKEN - Required. Your dump.xoozoo.com agent token
+ *   DUMP_API_URL   - Optional. API URL (default: https://dump.xoozoo.com)
+ */
+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":";AAEA;;;;;;;;;GASG"}

package/dist/index.js

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * Entry point for dump-mcp server
+ *
+ * Usage:
+ *   DUMP_API_TOKEN=dmp_xxx node dist/index.js
+ *
+ * Environment variables:
+ *   DUMP_API_TOKEN - Required. Your dump.xoozoo.com agent token
+ *   DUMP_API_URL   - Optional. API URL (default: https://dump.xoozoo.com)
+ */
+import { createServer } from './server.js';
+async function main() {
+    const { server, transport } = await createServer();
+    // Connect server to transport
+    await server.connect(transport);
+    // Log to stderr (stdout is used for MCP protocol)
+    console.error('dump-mcp server running');
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    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":";AAEA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,YAAY,EAAE,CAAC;IAEnD,8BAA8B;IAC9B,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,kDAAkD;IAClD,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC3C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+/**
+ * MCP Server setup for dump.xoozoo.com
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+export declare function createServer(): Promise<{
+    server: Server;
+    transport: StdioServerTransport;
+}>;
+//# 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;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAWjF,wBAAsB,YAAY,IAAI,OAAO,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,oBAAoB,CAAC;CACjC,CAAC,CA6FD"}

package/dist/server.js

@@ -0,0 +1,96 @@
+/**
+ * MCP Server setup for dump.xoozoo.com
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { DumpApiClient } from './api-client.js';
+import { registerEndpointTools, handleEndpointTool } from './tools/endpoints.js';
+import { registerRequestTools, handleRequestTool } from './tools/requests.js';
+import { registerReplayTools, handleReplayTool } from './tools/replay.js';
+export async function createServer() {
+    // Get configuration from environment
+    const apiToken = process.env.DUMP_API_TOKEN;
+    const apiUrl = process.env.DUMP_API_URL || 'https://dump.xoozoo.com';
+    if (!apiToken) {
+        console.error('Error: DUMP_API_TOKEN environment variable is required');
+        process.exit(1);
+    }
+    // Create API client
+    const client = new DumpApiClient(apiUrl, apiToken);
+    // Validate token on startup
+    try {
+        const validation = await client.validateToken();
+        console.error(`Authenticated as: ${validation.user.email} (token: ${validation.token.name})`);
+    }
+    catch (error) {
+        console.error('Error: Failed to validate API token:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+    // Create MCP server
+    const server = new Server({
+        name: 'dump-mcp',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Collect all tools
+    const allTools = [
+        ...registerEndpointTools(),
+        ...registerRequestTools(),
+        ...registerReplayTools(),
+    ];
+    // Handle list_tools request
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        return { tools: allTools };
+    });
+    // Handle call_tool request
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            // Route to appropriate handler
+            let result;
+            if (name.startsWith('dump_') && name.includes('endpoint')) {
+                result = await handleEndpointTool(client, name, args || {});
+            }
+            else if (name.startsWith('dump_') && name.includes('request')) {
+                result = await handleRequestTool(client, name, args || {});
+            }
+            else if (name.startsWith('dump_') && name.includes('replay')) {
+                result = await handleReplayTool(client, name, args || {});
+            }
+            else if (name === 'dump_list_teams') {
+                result = await handleEndpointTool(client, name, args || {});
+            }
+            else {
+                throw new Error(`Unknown tool: ${name}`);
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: typeof result === 'string' ? result : JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Create transport
+    const transport = new StdioServerTransport();
+    return { server, transport };
+}
+//# 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;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAEvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,MAAM,CAAC,KAAK,UAAU,YAAY;IAIhC,qCAAqC;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,yBAAyB,CAAC;IAErE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACxE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAEnD,4BAA4B;IAC5B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;QAChD,OAAO,CAAC,KAAK,CAAC,qBAAqB,UAAU,CAAC,IAAI,CAAC,KAAK,YAAY,UAAU,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IAChG,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACtG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,oBAAoB;IACpB,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB;QACE,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,oBAAoB;IACpB,MAAM,QAAQ,GAAW;QACvB,GAAG,qBAAqB,EAAE;QAC1B,GAAG,oBAAoB,EAAE;QACzB,GAAG,mBAAmB,EAAE;KACzB,CAAC;IAEF,4BAA4B;IAC5B,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;QAC1D,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,2BAA2B;IAC3B,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjD,IAAI,CAAC;YACH,+BAA+B;YAC/B,IAAI,MAAe,CAAC;YAEpB,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC1D,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAC9D,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChE,MAAM,GAAG,MAAM,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAC7D,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/D,MAAM,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAC5D,CAAC;iBAAM,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;gBACtC,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC;YAED,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC5E;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,UAAU,YAAY,EAAE;qBAC/B;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,mBAAmB;IACnB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC"}

package/dist/tools/endpoints.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Endpoint management tools for dump-mcp
+ */
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import { DumpApiClient } from '../api-client.js';
+/**
+ * Register endpoint-related tools
+ */
+export declare function registerEndpointTools(): Tool[];
+/**
+ * Handle endpoint tool calls
+ */
+export declare function handleEndpointTool(client: DumpApiClient, name: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=endpoints.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../src/tools/endpoints.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,EAAE,CA4F9C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CA6FlB"}