Assiststudio Runner MCP server

AssistStudio Runner

A Windows-only headless LLM task automation engine that executes natural language tasks on schedule and delivers results through configured channels. Built as a Model Context Protocol (MCP) server with the official MCP C# SDK.

Features

• Dual-mode operation — MCP server (serve) for task management, headless CLI (exec) for scheduled execution
• 7 MCP tools — createtask, updatetask, deletetask, listtasks, runtask, gettaskhistory, getexecution_status
• Windows Task Scheduler integration — cron expressions automatically mapped to schtasks entries
• Shared AgentLoop — LLM execution powered by Ai.Execution (same loop used by SubAgentExecutor)
• Multi-provider LLM support — Claude, OpenAI, Gemini, Ollama, Groq via Ai.Providers
• MCP server orchestration — tasks can bootstrap any MCP servers (Outbox, RAG, Filesystem, custom)
• Flexible tool control — AllowedTools null = all tools permitted; explicit list for fine-grained control; empty list = safe tools only
• Secure credentials — API keys in Windows Credential Manager (DPAPI), shared with AssistStudio
• Execution logging — DB summary + detailed JSON logs with full conversation history
• One-time scheduling — schedule_once with ISO 8601 datetime for single-execution tasks (“in 5 minutes”, “tomorrow at 9am”)
• Result delivery — send results via Outbox channels (Slack, Telegram, Email, KakaoTalk, Discord)

Installation

dotnet tool (recommended)

dotnet tool install -g FieldCure.AssistStudio.Runner

After installation, the assiststudio-runner command is available globally. The published package is Windows-only because scheduling is implemented via Windows Task Scheduler and credentials are stored in Windows Credential Manager.

From source

git clone https://github.com/fieldcure/fieldcure-assiststudio-runner.git
cd fieldcure-assiststudio-runner
dotnet build

Requirements

• .NET 8.0 Runtime or later
• Windows (required for Task Scheduler and Credential Manager)

Configuration

Auto-configuration (recommended)

When launched in serve mode with no runner.json, Runner automatically scans Windows Credential Manager for known provider API keys and generates the config file. If you use AssistStudio, API keys are already stored — no manual setup needed.

Manual Setup

# Create runner.json config template
assiststudio-runner config init

# Set API key for a provider model
assiststudio-runner config set-credential "Claude" sk-ant-api03-...

# Verify (displays masked value)
assiststudio-runner config get-credential "Claude"

The config file is created at %LOCALAPPDATA%/FieldCure/AssistStudio/Runner/runner.json:

{
  "defaultModelName": "Claude",
  "models": {
    "Claude": {
      "providerType": "Claude",
      "modelId": "claude-sonnet-4-20250514"
    }
  },
  "fallbackChannel": "runner-alerts",
  "logRetentionDays": 30
}

Claude Desktop

Add to claudedesktopconfig.json:

{
  "mcpServers": {
    "runner": {
      "command": "assiststudio-runner",
      "args": ["serve"]
    }
  }
}

VS Code (Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "runner": {
      "command": "assiststudio-runner",
      "args": ["serve"]
    }
  }
}

From source (without dotnet tool)

Shortened. The full README is on GitHub.