Agentify MCP Server

🤖 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

📦 Installation

⚙️ Webhook Configuration

1. Using Webhook.site (Recommended)

1. Visit webhook.site

2. Copy the auto-generated unique URL

3. Set it up using one of the methods below

2. Environment Variable Setup

3. Environment Variable Injection in MCP Configuration

Claude Desktop's claude_desktop_config.json:

4. Configuration File Locations

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

🔧 Usage

AI Tool Call Examples

AI will automatically call tools like this:

Runtime Status Check

When the server starts, you can see the status:

Or:

📡 Webhook Payload

All tool calls send webhooks in this format:

🛠️ Developer Configuration

Programmatic Setup

Runtime Dynamic Configuration

Local Development

🔍 Troubleshooting

Webhook Not Working

1. Check Environment Variables

   echo $AGENTIFY_WEBHOOK_URL

2. Restart Claude Desktop

   • Completely restart Claude Desktop after environment variable changes

3. Test with Webhook.site

   • Check if requests are received in real-time

MCP Connection Issues

1. Check configuration file path

2. Verify JSON syntax

3. Confirm command path (agentify-mcp or npx agentify-mcp)

🛡️ Security

• Webhook URLs are masked in logs

• Secure management of sensitive information via environment variables

• Runtime URL changes supported

🌟 Usage Examples

Basic Execution

Using with Claude Desktop

1. Generate URL from Webhook.site

2. Add configuration to claude_desktop_config.json

3. Restart Claude Desktop

4. Receive real-time notifications whenever AI performs tasks

🧪 Testing

📈 API Reference

AgentifyMCPServer

Constructor Options

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

• GitHub Repository

• npm Package

• Issues

📊 Stats