Labsco
gargoyle92 logo

Agentify

★ 1

from gargoyle92

A multi-client AI agent monitoring and control system with automatic task completion detection.

🔥🔥✓ VerifiedFreeNeeds API keys
#automation#git#maps#security

Agentify MCP Server

npm version License: MIT Node.js Version

🤖 A simple MCP server for AI task tracking and webhook notifications

Track when AI starts and completes tasks, with real-time webhook notifications for all activities.

🚀 Features

  • task-started - Tool to call when starting any task
  • auto-task-tracker - Automatic tracking for long-running tasks
  • task-completed - Tool to call when completing any task
  • Webhook Notifications - Real-time webhook delivery for all tool calls
  • Environment Variable Configuration - Dynamic webhook URL management

📡 Webhook Payload

All tool calls send webhooks in this format:

{
  "timestamp": "2024-01-01T12:00:00.000Z",
  "event": "tool_called",
  "toolName": "task-started",
  "arguments": {
    "taskDescription": "Starting React component refactoring"
  }
}
{
  "timestamp": "2024-01-01T12:00:00.000Z",
  "event": "tool_completed",
  "toolName": "task-completed",
  "arguments": {
    "taskDescription": "Completed React component refactoring",
    "outcome": "success"
  },
  "result": {
    "content": [{ "type": "text", "text": "✅ Task Completed..." }]
  },
  "duration": 150
}

🛡️ Security

  • Webhook URLs are masked in logs
  • Secure management of sensitive information via environment variables
  • Runtime URL changes supported

🧪 Testing

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Generate coverage report
npm run test:coverage

📈 API Reference

AgentifyMCPServer

Constructor Options

interface ServerConfig {
  webhookUrl?: string;
  logLevel?: 'debug' | 'info' | 'warn' | 'error';
}

Methods

  • start(): Promise<void> - Start the MCP server
  • stop(): Promise<void> - Stop the MCP server
  • setWebhookUrl(url: string): void - Set or update webhook URL
  • getWebhookUrl(): string | undefined - Get current webhook URL status
  • isWebhookEnabled(): boolean - Check if webhook is enabled

Available Tools

task-started

  • Description: Call when starting any task or work
  • Parameters:
    • taskDescription (string): Brief description of what was started

auto-task-tracker

  • Description: Automatically monitors long-running task progress
  • Parameters:
    • taskThresholdSeconds (number, optional): Auto-trigger threshold in seconds (default: 30)

task-completed

  • Description: Call when finishing any task or work
  • Parameters:
    • taskDescription (string): Brief description of what was completed
    • outcome ('success' | 'partial' | 'failed'): Task completion outcome
    • details (string, optional): Additional completion details

📄 License

MIT License - see the LICENSE file for details.

🔗 Links

📊 Stats

npm downloads GitHub stars GitHub issues