Hangfire

Hangfire MCP lets you enqueue background jobs using a dedicated MCP server that talks to Hangfire. This enables you to trigger Hangfire jobs from any MCP-capable client, such as editors or automation tools, without writing custom integration code.

How to use

You connect an MCP client to the Hangfire MCP server to enqueue jobs. Use a supported client and point it at the MCP server URL. When you enqueue a job from the client, the MCP server forwards the request to Hangfire, which schedules and runs the job according to your Hangfire configuration. You can load jobs dynamically and enqueue them using the MCP protocol, enabling flexible, script-driven job execution across your tooling.

How to install

Prerequisites: ensure you have .NET installed on your machine.

Install the Hangfire MCP server in standalone (stdio) mode. Run the following command to install the .NET global tool for Hangfire MCP.

{
  "servers": {
    "hangfire-mcp-standalone": {
      "type": "stdio",
      "command": "HangfireMCP",
      "args": [
        "--stdio"
      ],
      "env": {
        "HANGFIRE_JOBS_ASSEMBLY": "path/to/Jobs.dll",
        "HANGFIRE_JOBS_MATCH_EXPRESSION": "[?IsInterface && contains(Name, 'Job')]",
        "HANGFIRE_CONNECTION_STRING": "Host=localhost;Port=5432;Username=postgres;Password=postgres;Database=hangfire"
      }
    }
  }
}

Additional sections

Configuration examples below show how to wire an MCP client to the Hangfire MCP server using both HTTP (remote) and STDIO (local) approaches. In HTTP mode, you run or point to a server endpoint. In STDIO mode, you run a local process that speaks MCP and connects to Hangfire.

{
  "servers": {
    "hangfire-mcp": {
      "url": "http://localhost:3001"
    }
  }
}

Notes on usage and examples

The STDIO configuration loads job definitions from the specified assembly and uses a match expression to filter job types. For example, a JMESPath expression like [?IsInterface && contains(Name, 'Job')] selects interfaces whose names contain the string “Job.” You can adjust this expression to control which jobs are exposed through MCP.