AI Connect MCP Server

by aiconnect-cloud

185 downloads Not rated yet

About

An MCP (Model Context Protocol) server that allows AI agents to query and manage jobs in the Agent Jobs system of the AI Connect platform.

Explore

This MCP Server provides tools for AI agents to:

- 📋 List Jobs: Query all jobs with advanced filtering
- 🔍 Get Specific Job: Retrieve details of a specific job by ID
- ✅ Create Jobs: Create new jobs for immediate or scheduled execution
- ❌ Cancel Jobs: Cancel running or scheduled jobs
- 📊 Monitor Status: Track job status (WAITING, RUNNING, COMPLETED, FAILED, CANCELED)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name AI Connect MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

CLI Usage

The MCP server now supports CLI commands for easy management:

```bash

1. Create a new file in the src/ folder (e.g., new_tool.ts)
2. Implement the tool following the pattern of existing files
3. Register the tool in src/index.ts
4. Recompile with npm run build

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ai connect mcp server": {
            "agentjobs-mcp": {
                "command": "npx",
                "args": [
                    "@aiconnect/agentjobs-mcp",
                    "--help"
                ]
            }
        }
    }
}

McpServers

{
    "agentjobs-mcp": {
        "command": "npx",
        "args": [
            "@aiconnect/agentjobs-mcp",
            "--help"
        ]
    }
}

An MCP (Model Context Protocol) server that allows AI agents to query and manage jobs in the AI Connect platform.

About AI Connect Jobs

AI Connect Jobs is a robust asynchronous task management system on the AI Connect platform, enabling the creation, monitoring, and execution of jobs across different platforms like Slack and WhatsApp, with support for scheduled execution, automatic retries, and timeout handling. The API provides endpoints to create, list, query, and cancel jobs, allowing developers and external systems to easily integrate asynchronous processing functionalities into their applications, automating complex workflows without the need to implement the entire task management infrastructure.

Features

This MCP Server provides tools for AI agents to:

- 📋 List Jobs: Query all jobs with advanced filtering
- 🔍 Get Specific Job: Retrieve details of a specific job by ID
- ✅ Create Jobs: Create new jobs for immediate or scheduled execution
- ❌ Cancel Jobs: Cancel running or scheduled jobs
- 📊 Monitor Status: Track job status (WAITING, RUNNING, COMPLETED, FAILED, CANCELED)

Technologies

- Node.js with TypeScript
- Model Context Protocol (MCP) by Anthropic
- Zod for schema validation
- AI Connect API for integration with the Agent Jobs system

Installation

NPX (Recommended)

You can run the MCP server directly using npx without installation:

npx @aiconnect/agentjobs-mcp --help

Local Installation

1. Clone the repository:

git clone <repository-url>
cd agentjobs-mcp

2. Install dependencies:

npm install

3. Configure environment variables (Optional):

The MCP server comes with default values from .env.example, so you can run it without setting any environment variables. However, you must provide an API key for authentication.

cp .env.example .env

Edit the .env file with your credentials:

DEFAULT_ORG_ID=your-organization     # Default: aiconnect
AICONNECT_API_KEY=your-api-key # Required: Must be provided
AICONNECT_API_URL=https://api.aiconnect.cloud/api/v0 # Default

Important: If no environment variables are provided, the server will use these defaults:
- DEFAULT_ORG_ID: aiconnect
- AICONNECT_API_URL: https://api.aiconnect.cloud/api/v0
- AICONNECT_API_KEY: empty (must be provided for API calls to work)

4. Build the project:

npm run build

Usage

CLI Usage

The MCP server now supports CLI commands for easy management:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.