Skip to content Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.
Product
Directory
Developers
Company
Dispatch Agent MCP server | PlugMCP
Skip to content From the publisher
Documentation Dispatch Agent
An intelligent MCP (Model Context Protocol) server that provides specialized filesystem operations through a React agent. Designed to enhance AI applications like Claude Code by delegating filesystem tasks to a focused sub-agent, reducing context window usage and improving response accuracy.
Dispatch Agent MCP Server
Plug any tool into any agent. MCP servers for people who do not write servers. Gateway for volume, n8n for apps.
Product
Directory
Developers
Company
Features
Specialized Filesystem Agent : Dedicated React agent for file operations using LangGraph
MCP Integration : Seamless integration with AI applications via Model Context Protocol
Multi-LLM Support : Works with both OpenAI and Anthropic language models
Concurrent Operations : Support for multiple simultaneous agent invocations
Context-Optimized : Designed for concise, direct responses to minimize token usage
Flexible Configuration : Environment-based configuration for different deployment scenarios
Installation
Prerequisites
Node.js 18.0.0 or higher
npm or yarn package manager
Install from npm npm install -g dispatch-agent
Build from Source git clone https://github.com/abhinav-mangla/dispatch-agent.git
cd dispatch-agent
npm install
npm run build
Configuration Configure the agent using environment variables:
Required Variables export API_KEY="your-api-key-here"
Optional Variables # LLM Provider (default: openai)
export LLM_PROVIDER="openai" # or "anthropic"
# Base URL (default: https://openrouter.ai/api/v1)
export BASE_URL="https://api.openai.com/v1"
# Model Name (default: openai/gpt-4o-mini)
export MODEL_NAME="gpt-4o"
# Temperature (default: 0, range: 0-2)
export TEMPERATURE="0.1"
Provider-Specific Setup
OpenAI export LLM_PROVIDER="openai"
export API_KEY="sk-..."
export BASE_URL="https://api.openai.com/v1"
export MODEL_NAME="gpt-4o"
Anthropic export LLM_PROVIDER="anthropic"
export API_KEY="sk-ant-..."
export MODEL_NAME="claude-3-5-sonnet-20241022"
OpenRouter export API_KEY="sk-or-..."
export BASE_URL="https://openrouter.ai/api/v1"
export MODEL_NAME="anthropic/claude-3.5-sonnet"
export LLM_PROVIDER="anthropic"
Usage
Basic Usage Start the MCP server with a working directory:
# If installed globally
dispatch-agent /path/to/your/project
# Or using npx (no installation required)
npx dispatch-agent /path/to/your/project
Integration with Claude Desktop Add to your Claude Desktop MCP configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"dispatch-agent": {
"command": "npx",
"args": ["dispatch-agent", "/path/to/your/project"],
"env": {
"API_KEY": "your-api-key-here",
"LLM_PROVIDER": "anthropic",
"MODEL_NAME": "claude-3-5-sonnet-20241022",
"TEMPERATURE": "0"
}
}
}
}
Or if installed globally:
{
"mcpServers": {
"dispatch-agent": {
"command": "dispatch-agent",
"args": ["/path/to/your/project"],
"env": {
"API_KEY": "your-api-key-here",
"LLM_PROVIDER": "openai",
"BASE_URL": "https://api.openai.com/v1",
"MODEL_NAME": "gpt-4o",
"TEMPERATURE": "0"
}
}
}
}
Integration with Other MCP Clients The server implements the standard MCP protocol and can be integrated with any MCP-compatible client:
import { StdioServerTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
const client = new Client({
name: "dispatch-agent-client",
version: "1.0.0"
}, {
capabilities: {}
});
const transport = new StdioServerTransport({
command: "dispatch-agent",
args: ["/path/to/working/directory"]
});
await client.connect(transport);
Performance Improvements The dispatch agent architecture provides significant performance benefits for AI applications:
🎯 Context Window Optimization
50% reduction in main agent context usage by delegating filesystem operations
32% faster inference times through specialized task handling
Eliminates need to include file contents in main conversation context
💰 Cost Reduction
46% average cost reduction through efficient context management
Caching of filesystem operation patterns and responses
Reduced token consumption in primary AI interactions
🎪 Improved Accuracy
9.1% accuracy improvement through specialized agent design
Focused training on filesystem operations reduces hallucination
Dedicated prompting for file system tasks ensures consistent outputs
⚡ Faster Results
Concurrent agent execution for multiple filesystem operations
Compressed context handling for long file contents
Direct, concise responses optimized for CLI and programmatic usage
📊 Resource Efficiency
45% reduction in main LLM API calls for filesystem tasks
Local processing of file metadata and directory structures
Intelligent caching of frequently accessed file information
API Documentation
Tool: dispatch_agent The server exposes a single tool for agent dispatch:
Input Schema {
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "The message/task for the agent to process"
}
},
"required": ["message"]
}
Example Usage {
"name": "dispatch_agent",
"arguments": {
"message": "Find all TypeScript files that import React in the src directory"
}
}
Response Format {
"content": [
{
"type": "text",
"text": "Found 5 TypeScript files importing React:\n- /abs/path/src/components/App.tsx\n- /abs/path/src/components/Button.tsx\n- /abs/path/src/hooks/useEffect.tsx\n- /abs/path/src/pages/Home.tsx\n- /abs/path/src/utils/ReactHelpers.tsx"
}
]
}
Available Filesystem Operations The dispatch agent has access to the following filesystem tools:
Read files : Text files, media files, multiple files at once
List directories : Directory contents and tree structures
Search files : Content-based file searching
File metadata : Size, modification dates, permissions
Directory traversal : Recursive directory exploration
Best Practices
When to Use Dispatch Agent
Searching for keywords across multiple files
Finding files by partial names or patterns
Complex filesystem queries ("which files contain X?")
Directory structure exploration
Multiple concurrent filesystem operations
When to Use Direct Tools
Reading specific known file paths
Simple file operations
Modifying files (agent is read-only)
Non-filesystem tasks
Optimal Usage Patterns # Good: Complex search queries
"Find all configuration files that mention database"
"List all Python files larger than 1MB in the project"
# Better with direct tools: Specific file access
"Read the content of src/config.json"
"List files in the /src directory"
Development
Building the Project
Development Mode
Project Structure dispatch-agent/
├── src/
│ ├── index.ts # CLI entry point
│ ├── server.ts # MCP server implementation
│ ├── tools/
│ │ └── dispatch-agent.ts # Core agent logic
│ ├── types/
│ │ └── index.ts # TypeScript type definitions
│ └── utils/
│ └── validation.ts # Input validation utilities
├── package.json
├── tsconfig.json
└── README.md
Contributing
Fork the repository
Create a feature branch: git checkout -b feature/new-feature
Make your changes and add tests if applicable
Ensure TypeScript compilation passes: npm run build
Commit your changes: git commit -am 'Add new feature'
Push to the branch: git push origin feature/new-feature
Submit a pull request
Development Guidelines
Follow TypeScript best practices
Maintain the existing code style
Update documentation for new features
Ensure error handling is comprehensive
Keep responses concise for CLI usage
License MIT License - see LICENSE file for details.
Author
Support For issues, questions, or contributions:
Keywords: MCP, Model Context Protocol, AI Agent, Filesystem, LangGraph, React Agent, Claude, OpenAI, Anthropic
Directory score 10/100 Listed 10 of 10
In the official MCP Registry 0 of 18
Claimed by its maintainer 0 of 8
Answers with a tool list 0 of 12
GitHub stars 4 of 16
Weekly downloads 0 of 10
Public Apis A collective list of free APIs Pipeworx Gateway Live data for AI agents. 250+ data sources, 900+ tools. Ask questions in plain English with ask_pipeworx — trade flows, SEC filings, drug safety, housing data, and more. No API keys needed. Rea Reverse engineer anything with agents, from app behavior down to native binaries. Coding Interview University A complete computer science study plan to become a software engineer. Skills Skills for Real Engineers. Straight from my .agents directory. Hermes Agent The agent that grows with you SparkForge Access a versatile collection of tools for media generation, web scraping, and cryptocurrency research. Convert between data formats, summarize long documents, and extract text from images or PDFs wit N8n Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations. Awesome Go A curated list of awesome Go frameworks, libraries and software Ohmyzsh 🙃 A delightful community-driven (with 2,500+ contributors) framework for managing your zsh configuration. Includes 300+ optional plugins (rails, git, macOS, hub, docker, homebrew, node, php, python Agency Agents A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, a The Art Of Command Line Master the command line, in one page agent-browser Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web a azure-aigateway Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: semantic caching, token limit, content safety, load balancing, AI model governance, MCP rate limiting, jailb
No tool list yet. Remote servers get one after the first health check.
How do I install Dispatch Agent? Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Dispatch Agent need an API key? No required environment variable is listed on this record.
What transport does Dispatch Agent use? Dispatch Agent runs locally over stdio.
When was Dispatch Agent last checked? Last checked 2026-10-26. Dispatch Agent MCP Server
azure-compute Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compare VM pricing, VMSS, scale set, autoscale, burstable, lightweight server, website, backend, GPU, machine l Tools have descriptions 0 of 6