opc-agent 4.1.0 → 4.1.2

package/src/tools/integrations/translator.ts

@@ -1,48 +1,48 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-
-export const TranslatorTool: MCPTool = {
-  name: 'translator',
-  description: 'Translate text between languages using an LLM. Requires OPENAI_API_KEY or LLM_API_URL env var.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      text: { type: 'string', description: 'Text to translate' },
-      from: { type: 'string', description: 'Source language (auto-detect if omitted)' },
-      to: { type: 'string', description: 'Target language (required)' },
-    },
-    required: ['text', 'to'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const text = String(input.text ?? '');
-    const to = String(input.to ?? '');
-    if (!text || !to) return { content: 'Error: text and to are required', isError: true };
-
-    const from = input.from ? ` from ${input.from}` : '';
-    const prompt = `Translate the following text${from} to ${to}. Return only the translation, no explanations:\n\n${text.slice(0, 10000)}`;
-
-    try {
-      const apiKey = process.env.OPENAI_API_KEY;
-      const apiUrl = process.env.LLM_API_URL || 'https://api.openai.com/v1/chat/completions';
-      if (!apiKey && apiUrl === 'https://api.openai.com/v1/chat/completions') {
-        return { content: 'Error: OPENAI_API_KEY or LLM_API_URL required', isError: true };
-      }
-
-      const headers: Record<string, string> = { 'Content-Type': 'application/json' };
-      if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;
-
-      const res = await fetch(apiUrl, {
-        method: 'POST', headers,
-        body: JSON.stringify({
-          model: process.env.LLM_MODEL || 'gpt-4o-mini',
-          messages: [{ role: 'user', content: prompt }],
-        }),
-      });
-      const data = await res.json() as { choices?: Array<{ message: { content: string } }> };
-      const translation = data.choices?.[0]?.message?.content ?? 'No translation generated';
-      return { content: translation };
-    } catch (err) {
-      return { content: `Translation error: ${(err as Error).message}`, isError: true };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+
+export const TranslatorTool: MCPTool = {
+  name: 'translator',
+  description: 'Translate text between languages using an LLM. Requires OPENAI_API_KEY or LLM_API_URL env var.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      text: { type: 'string', description: 'Text to translate' },
+      from: { type: 'string', description: 'Source language (auto-detect if omitted)' },
+      to: { type: 'string', description: 'Target language (required)' },
+    },
+    required: ['text', 'to'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const text = String(input.text ?? '');
+    const to = String(input.to ?? '');
+    if (!text || !to) return { content: 'Error: text and to are required', isError: true };
+
+    const from = input.from ? ` from ${input.from}` : '';
+    const prompt = `Translate the following text${from} to ${to}. Return only the translation, no explanations:\n\n${text.slice(0, 10000)}`;
+
+    try {
+      const apiKey = process.env.OPENAI_API_KEY;
+      const apiUrl = process.env.LLM_API_URL || 'https://api.openai.com/v1/chat/completions';
+      if (!apiKey && apiUrl === 'https://api.openai.com/v1/chat/completions') {
+        return { content: 'Error: OPENAI_API_KEY or LLM_API_URL required', isError: true };
+      }
+
+      const headers: Record<string, string> = { 'Content-Type': 'application/json' };
+      if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;
+
+      const res = await fetch(apiUrl, {
+        method: 'POST', headers,
+        body: JSON.stringify({
+          model: process.env.LLM_MODEL || 'gpt-4o-mini',
+          messages: [{ role: 'user', content: prompt }],
+        }),
+      });
+      const data = await res.json() as { choices?: Array<{ message: { content: string } }> };
+      const translation = data.choices?.[0]?.message?.content ?? 'No translation generated';
+      return { content: translation };
+    } catch (err) {
+      return { content: `Translation error: ${(err as Error).message}`, isError: true };
+    }
+  },
+};

package/src/tools/integrations/trello.ts

@@ -1,60 +1,60 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-
-export const TrelloTool: MCPTool = {
-  name: 'trello',
-  description: 'Interact with Trello: create cards, move cards, list boards. Requires TRELLO_API_KEY, TRELLO_TOKEN env vars.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      action: { type: 'string', enum: ['create_card', 'move_card', 'list_boards'], description: 'Action' },
-      list_id: { type: 'string', description: 'List ID (for create_card/move_card)' },
-      card_id: { type: 'string', description: 'Card ID (for move_card)' },
-      name: { type: 'string', description: 'Card name' },
-      description: { type: 'string', description: 'Card description' },
-    },
-    required: ['action'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const key = process.env.TRELLO_API_KEY;
-    const token = process.env.TRELLO_TOKEN;
-    if (!key || !token) return { content: 'Error: TRELLO_API_KEY, TRELLO_TOKEN required', isError: true };
-
-    const auth = `key=${key}&token=${token}`;
-    const action = String(input.action ?? '');
-
-    try {
-      if (action === 'create_card') {
-        if (!input.list_id || !input.name) return { content: 'Error: list_id, name required', isError: true };
-        const res = await fetch(`https://api.trello.com/1/cards?${auth}`, {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ idList: input.list_id, name: input.name, desc: input.description ?? '' }),
-        });
-        const data = await res.json() as Record<string, unknown>;
-        return { content: `Card created: ${data.shortUrl ?? data.id}` };
-      }
-
-      if (action === 'move_card') {
-        if (!input.card_id || !input.list_id) return { content: 'Error: card_id, list_id required', isError: true };
-        await fetch(`https://api.trello.com/1/cards/${input.card_id}?${auth}`, {
-          method: 'PUT',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ idList: input.list_id }),
-        });
-        return { content: `Card ${input.card_id} moved to list ${input.list_id}` };
-      }
-
-      if (action === 'list_boards') {
-        const res = await fetch(`https://api.trello.com/1/members/me/boards?${auth}`);
-        const data = await res.json() as Array<Record<string, unknown>>;
-        const summary = Array.isArray(data) ? data.map((b) => `${b.name} (${b.id})`).join('\n') : JSON.stringify(data);
-        return { content: summary };
-      }
-
-      return { content: `Unknown action: ${action}`, isError: true };
-    } catch (err) {
-      return { content: `Trello error: ${(err as Error).message}`, isError: true };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+
+export const TrelloTool: MCPTool = {
+  name: 'trello',
+  description: 'Interact with Trello: create cards, move cards, list boards. Requires TRELLO_API_KEY, TRELLO_TOKEN env vars.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      action: { type: 'string', enum: ['create_card', 'move_card', 'list_boards'], description: 'Action' },
+      list_id: { type: 'string', description: 'List ID (for create_card/move_card)' },
+      card_id: { type: 'string', description: 'Card ID (for move_card)' },
+      name: { type: 'string', description: 'Card name' },
+      description: { type: 'string', description: 'Card description' },
+    },
+    required: ['action'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const key = process.env.TRELLO_API_KEY;
+    const token = process.env.TRELLO_TOKEN;
+    if (!key || !token) return { content: 'Error: TRELLO_API_KEY, TRELLO_TOKEN required', isError: true };
+
+    const auth = `key=${key}&token=${token}`;
+    const action = String(input.action ?? '');
+
+    try {
+      if (action === 'create_card') {
+        if (!input.list_id || !input.name) return { content: 'Error: list_id, name required', isError: true };
+        const res = await fetch(`https://api.trello.com/1/cards?${auth}`, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ idList: input.list_id, name: input.name, desc: input.description ?? '' }),
+        });
+        const data = await res.json() as Record<string, unknown>;
+        return { content: `Card created: ${data.shortUrl ?? data.id}` };
+      }
+
+      if (action === 'move_card') {
+        if (!input.card_id || !input.list_id) return { content: 'Error: card_id, list_id required', isError: true };
+        await fetch(`https://api.trello.com/1/cards/${input.card_id}?${auth}`, {
+          method: 'PUT',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ idList: input.list_id }),
+        });
+        return { content: `Card ${input.card_id} moved to list ${input.list_id}` };
+      }
+
+      if (action === 'list_boards') {
+        const res = await fetch(`https://api.trello.com/1/members/me/boards?${auth}`);
+        const data = await res.json() as Array<Record<string, unknown>>;
+        const summary = Array.isArray(data) ? data.map((b) => `${b.name} (${b.id})`).join('\n') : JSON.stringify(data);
+        return { content: summary };
+      }
+
+      return { content: `Unknown action: ${action}`, isError: true };
+    } catch (err) {
+      return { content: `Trello error: ${(err as Error).message}`, isError: true };
+    }
+  },
+};

package/src/tools/integrations/vector-search.ts

@@ -1,42 +1,42 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-
-export const VectorSearchTool: MCPTool = {
-  name: 'vector-search',
-  description: 'Search vector embeddings via DeepBrain or compatible API. Requires DEEPBRAIN_URL and DEEPBRAIN_API_KEY env vars.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      query: { type: 'string', description: 'Search query text' },
-      collection: { type: 'string', description: 'Collection/namespace to search' },
-      top_k: { type: 'number', description: 'Number of results (default: 5)' },
-    },
-    required: ['query'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const baseUrl = process.env.DEEPBRAIN_URL;
-    const apiKey = process.env.DEEPBRAIN_API_KEY;
-    if (!baseUrl) return { content: 'Error: DEEPBRAIN_URL required', isError: true };
-
-    const query = String(input.query ?? '');
-    if (!query) return { content: 'Error: query required', isError: true };
-
-    try {
-      const headers: Record<string, string> = { 'Content-Type': 'application/json' };
-      if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;
-
-      const res = await fetch(`${baseUrl}/api/search`, {
-        method: 'POST', headers,
-        body: JSON.stringify({
-          query,
-          collection: input.collection ?? 'default',
-          top_k: Number(input.top_k ?? 5),
-        }),
-      });
-      const data = await res.json() as Record<string, unknown>;
-      return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
-    } catch (err) {
-      return { content: `Vector search error: ${(err as Error).message}`, isError: true };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+
+export const VectorSearchTool: MCPTool = {
+  name: 'vector-search',
+  description: 'Search vector embeddings via DeepBrain or compatible API. Requires DEEPBRAIN_URL and DEEPBRAIN_API_KEY env vars.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      query: { type: 'string', description: 'Search query text' },
+      collection: { type: 'string', description: 'Collection/namespace to search' },
+      top_k: { type: 'number', description: 'Number of results (default: 5)' },
+    },
+    required: ['query'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const baseUrl = process.env.DEEPBRAIN_URL;
+    const apiKey = process.env.DEEPBRAIN_API_KEY;
+    if (!baseUrl) return { content: 'Error: DEEPBRAIN_URL required', isError: true };
+
+    const query = String(input.query ?? '');
+    if (!query) return { content: 'Error: query required', isError: true };
+
+    try {
+      const headers: Record<string, string> = { 'Content-Type': 'application/json' };
+      if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;
+
+      const res = await fetch(`${baseUrl}/api/search`, {
+        method: 'POST', headers,
+        body: JSON.stringify({
+          query,
+          collection: input.collection ?? 'default',
+          top_k: Number(input.top_k ?? 5),
+        }),
+      });
+      const data = await res.json() as Record<string, unknown>;
+      return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
+    } catch (err) {
+      return { content: `Vector search error: ${(err as Error).message}`, isError: true };
+    }
+  },
+};

package/src/tools/integrations/web-scraper.ts

@@ -1,47 +1,47 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-
-export const WebScraperTool: MCPTool = {
-  name: 'web-scraper',
-  description: 'Fetch and extract readable content from a URL.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      url: { type: 'string', description: 'URL to scrape' },
-      max_length: { type: 'number', description: 'Max characters to return (default: 5000)' },
-    },
-    required: ['url'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const url = String(input.url ?? '');
-    if (!url) return { content: 'Error: url required', isError: true };
-    const maxLen = Number(input.max_length ?? 5000);
-
-    try {
-      const res = await fetch(url, {
-        headers: { 'User-Agent': 'Mozilla/5.0 (compatible; OPCAgent/1.0)' },
-      });
-      if (!res.ok) return { content: `HTTP ${res.status}: ${res.statusText}`, isError: true };
-
-      const html = await res.text();
-      // Simple HTML to text extraction
-      const text = html
-        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '')
-        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '')
-        .replace(/<[^>]+>/g, ' ')
-        .replace(/&nbsp;/g, ' ')
-        .replace(/&amp;/g, '&')
-        .replace(/&lt;/g, '<')
-        .replace(/&gt;/g, '>')
-        .replace(/&quot;/g, '"')
-        .replace(/&#39;/g, "'")
-        .replace(/\s+/g, ' ')
-        .trim();
-
-      const truncated = text.length > maxLen ? text.slice(0, maxLen) + '...(truncated)' : text;
-      return { content: truncated, metadata: { url, length: text.length } };
-    } catch (err) {
-      return { content: `Scraper error: ${(err as Error).message}`, isError: true };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+
+export const WebScraperTool: MCPTool = {
+  name: 'web-scraper',
+  description: 'Fetch and extract readable content from a URL.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      url: { type: 'string', description: 'URL to scrape' },
+      max_length: { type: 'number', description: 'Max characters to return (default: 5000)' },
+    },
+    required: ['url'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const url = String(input.url ?? '');
+    if (!url) return { content: 'Error: url required', isError: true };
+    const maxLen = Number(input.max_length ?? 5000);
+
+    try {
+      const res = await fetch(url, {
+        headers: { 'User-Agent': 'Mozilla/5.0 (compatible; OPCAgent/1.0)' },
+      });
+      if (!res.ok) return { content: `HTTP ${res.status}: ${res.statusText}`, isError: true };
+
+      const html = await res.text();
+      // Simple HTML to text extraction
+      const text = html
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '')
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\s+/g, ' ')
+        .trim();
+
+      const truncated = text.length > maxLen ? text.slice(0, maxLen) + '...(truncated)' : text;
+      return { content: truncated, metadata: { url, length: text.length } };
+    } catch (err) {
+      return { content: `Scraper error: ${(err as Error).message}`, isError: true };
+    }
+  },
+};

package/src/tools/integrations/web-search.ts

@@ -1,58 +1,58 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-
-export const WebSearchTool: MCPTool = {
-  name: 'web-search',
-  description: 'Search the web using SerpAPI, Tavily, or Brave Search. Requires SERPAPI_KEY, TAVILY_API_KEY, or BRAVE_SEARCH_KEY env var.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      query: { type: 'string', description: 'Search query' },
-      provider: { type: 'string', enum: ['serpapi', 'tavily', 'brave'], description: 'Search provider (auto-detects from env)' },
-      count: { type: 'number', description: 'Number of results (default: 5)' },
-    },
-    required: ['query'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const query = String(input.query ?? '');
-    if (!query) return { content: 'Error: query required', isError: true };
-    const count = Number(input.count ?? 5);
-
-    try {
-      const provider = String(input.provider ?? '');
-      if (provider === 'tavily' || process.env.TAVILY_API_KEY) {
-        const key = process.env.TAVILY_API_KEY;
-        if (!key) return { content: 'Error: TAVILY_API_KEY required', isError: true };
-        const res = await fetch('https://api.tavily.com/search', {
-          method: 'POST',
-          headers: { 'Content-Type': 'application/json' },
-          body: JSON.stringify({ api_key: key, query, max_results: count }),
-        });
-        const data = await res.json() as Record<string, unknown>;
-        return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
-      }
-
-      if (provider === 'brave' || process.env.BRAVE_SEARCH_KEY) {
-        const key = process.env.BRAVE_SEARCH_KEY;
-        if (!key) return { content: 'Error: BRAVE_SEARCH_KEY required', isError: true };
-        const res = await fetch(`https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(query)}&count=${count}`, {
-          headers: { 'X-Subscription-Token': key, 'Accept': 'application/json' },
-        });
-        const data = await res.json() as Record<string, unknown>;
-        return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
-      }
-
-      if (provider === 'serpapi' || process.env.SERPAPI_KEY) {
-        const key = process.env.SERPAPI_KEY;
-        if (!key) return { content: 'Error: SERPAPI_KEY required', isError: true };
-        const res = await fetch(`https://serpapi.com/search.json?q=${encodeURIComponent(query)}&num=${count}&api_key=${key}`);
-        const data = await res.json() as Record<string, unknown>;
-        return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
-      }
-
-      return { content: 'Error: No search API key configured (TAVILY_API_KEY, BRAVE_SEARCH_KEY, or SERPAPI_KEY)', isError: true };
-    } catch (err) {
-      return { content: `Search error: ${(err as Error).message}`, isError: true };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+
+export const WebSearchTool: MCPTool = {
+  name: 'web-search',
+  description: 'Search the web using SerpAPI, Tavily, or Brave Search. Requires SERPAPI_KEY, TAVILY_API_KEY, or BRAVE_SEARCH_KEY env var.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      query: { type: 'string', description: 'Search query' },
+      provider: { type: 'string', enum: ['serpapi', 'tavily', 'brave'], description: 'Search provider (auto-detects from env)' },
+      count: { type: 'number', description: 'Number of results (default: 5)' },
+    },
+    required: ['query'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const query = String(input.query ?? '');
+    if (!query) return { content: 'Error: query required', isError: true };
+    const count = Number(input.count ?? 5);
+
+    try {
+      const provider = String(input.provider ?? '');
+      if (provider === 'tavily' || process.env.TAVILY_API_KEY) {
+        const key = process.env.TAVILY_API_KEY;
+        if (!key) return { content: 'Error: TAVILY_API_KEY required', isError: true };
+        const res = await fetch('https://api.tavily.com/search', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ api_key: key, query, max_results: count }),
+        });
+        const data = await res.json() as Record<string, unknown>;
+        return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
+      }
+
+      if (provider === 'brave' || process.env.BRAVE_SEARCH_KEY) {
+        const key = process.env.BRAVE_SEARCH_KEY;
+        if (!key) return { content: 'Error: BRAVE_SEARCH_KEY required', isError: true };
+        const res = await fetch(`https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(query)}&count=${count}`, {
+          headers: { 'X-Subscription-Token': key, 'Accept': 'application/json' },
+        });
+        const data = await res.json() as Record<string, unknown>;
+        return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
+      }
+
+      if (provider === 'serpapi' || process.env.SERPAPI_KEY) {
+        const key = process.env.SERPAPI_KEY;
+        if (!key) return { content: 'Error: SERPAPI_KEY required', isError: true };
+        const res = await fetch(`https://serpapi.com/search.json?q=${encodeURIComponent(query)}&num=${count}&api_key=${key}`);
+        const data = await res.json() as Record<string, unknown>;
+        return { content: JSON.stringify(data, null, 2).slice(0, 4000) };
+      }
+
+      return { content: 'Error: No search API key configured (TAVILY_API_KEY, BRAVE_SEARCH_KEY, or SERPAPI_KEY)', isError: true };
+    } catch (err) {
+      return { content: `Search error: ${(err as Error).message}`, isError: true };
+    }
+  },
+};

package/src/tools/integrations/webhook.ts

@@ -1,38 +1,38 @@
-import type { MCPTool, MCPToolResult } from '../mcp';
-
-export const WebhookTool: MCPTool = {
-  name: 'webhook',
-  description: 'Send HTTP requests to arbitrary webhook URLs. Supports POST and GET.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      url: { type: 'string', description: 'Webhook URL' },
-      method: { type: 'string', enum: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'], description: 'HTTP method (default: POST)' },
-      headers: { type: 'object', description: 'Custom headers as key-value pairs' },
-      body: { type: 'string', description: 'Request body (JSON string)' },
-    },
-    required: ['url'],
-  },
-
-  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
-    const url = String(input.url ?? '');
-    if (!url) return { content: 'Error: url is required', isError: true };
-
-    const method = String(input.method ?? 'POST').toUpperCase();
-    const customHeaders = (input.headers ?? {}) as Record<string, string>;
-    const headers: Record<string, string> = { 'Content-Type': 'application/json', ...customHeaders };
-
-    try {
-      const opts: RequestInit = { method, headers };
-      if (method !== 'GET' && method !== 'HEAD' && input.body) {
-        opts.body = String(input.body);
-      }
-      const res = await fetch(url, opts);
-      const text = await res.text();
-      const truncated = text.length > 4000 ? text.slice(0, 4000) + '...(truncated)' : text;
-      return { content: `Status: ${res.status}\n${truncated}`, metadata: { status: res.status } };
-    } catch (err) {
-      return { content: `Webhook error: ${(err as Error).message}`, isError: true };
-    }
-  },
-};
+import type { MCPTool, MCPToolResult } from '../mcp';
+
+export const WebhookTool: MCPTool = {
+  name: 'webhook',
+  description: 'Send HTTP requests to arbitrary webhook URLs. Supports POST and GET.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      url: { type: 'string', description: 'Webhook URL' },
+      method: { type: 'string', enum: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'], description: 'HTTP method (default: POST)' },
+      headers: { type: 'object', description: 'Custom headers as key-value pairs' },
+      body: { type: 'string', description: 'Request body (JSON string)' },
+    },
+    required: ['url'],
+  },
+
+  async execute(input: Record<string, unknown>): Promise<MCPToolResult> {
+    const url = String(input.url ?? '');
+    if (!url) return { content: 'Error: url is required', isError: true };
+
+    const method = String(input.method ?? 'POST').toUpperCase();
+    const customHeaders = (input.headers ?? {}) as Record<string, string>;
+    const headers: Record<string, string> = { 'Content-Type': 'application/json', ...customHeaders };
+
+    try {
+      const opts: RequestInit = { method, headers };
+      if (method !== 'GET' && method !== 'HEAD' && input.body) {
+        opts.body = String(input.body);
+      }
+      const res = await fetch(url, opts);
+      const text = await res.text();
+      const truncated = text.length > 4000 ? text.slice(0, 4000) + '...(truncated)' : text;
+      return { content: `Status: ${res.status}\n${truncated}`, metadata: { status: res.status } };
+    } catch (err) {
+      return { content: `Webhook error: ${(err as Error).message}`, isError: true };
+    }
+  },
+};