Skip to main content
Glama

Dispersl MCP Server

A Model Context Protocol (MCP) server implementation that integrates with Dispersl; The AI Dev Team, to give you multi-agents that work together to build software.

This MCP server can use other MCP servers as well for distributed, tool-driven workflows.

Built for modern AI-driven development, with support for multiple LLM models, multi-agent planning, and full SDLC automation.


Features

  • Multi-agent orchestration (plan, code, test, git, docs, chat)

  • Code generation, test generation, and documentation

  • Git operations and repo management

  • Conversational agentic chat

  • API key and session management

  • Connect to and manage other MCP servers (local or remote)

  • Extensible with custom tools and external agents

  • Works with Cursor, VS Code, and other MCP-compatible clients


Related MCP server: Bernstein - Multi-agent orchestration

Installation

Running with npx

env DISPERSL_API_KEY=your-api-key npx -y dispersl-mcp

Manual Installation

npm install -g dispersl-mcp

Running on Cursor

For the most up-to-date configuration instructions, see the Cursor MCP Server Configuration Guide.

Example Cursor MCP config:

{
  "mcpServers": {
    "dispersl-mcp": {
      "command": "npx",
      "args": ["-y", "dispersl-mcp"],
      "env": {
        "DISPERSL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Running Locally

export DISPERSL_API_KEY=your-api-key
npm run dev

Running with Custom Models

You can specify default models for each agent type:

export DISPERSL_PLAN_MODEL=deepseek/deepseek-chat-v3-0324:free
export DISPERSL_CODE_MODEL=anthropic/claude-sonnet-4
export DISPERSL_TEST_MODEL=anthropic/claude-sonnet-4
export DISPERSL_GIT_MODEL=meta-llama/llama-4-maverick:free
export DISPERSL_DOCS_MODEL=openai/gpt-4o-mini
export DISPERSL_CHAT_MODEL=openai/gpt-4o-mini

Configuration

MCP Config Example

To connect to local and external MCP servers, use .dispersl/mcp.json:

{
  "mcpServers": {
    "anthropic-main": {
      "command": "npx",
      "args": [
        "-y",
        "--package=@anthropic-ai/mcp-server",
        "anthropic-mcp-server"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY}"
      }
    },
    "anthropic-backup": {
      "command": "npx",
      "args": [
        "-y",
        "--package=@anthropic-ai/mcp-server",
        "anthropic-mcp-server"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "${ANTHROPIC_API_KEY_BACKUP}"
      }
    }
  }
}

Usage

Tool Reference

Tool Name

Description

list_models

List available models

dispersl_code_agent

Generate code files and codebases based on a prompt using agentic execution

dispersl_testing_agent

Generate end to end tests based on a prompt using agentic execution

dispersl_git_agent

Execute codebase versioning operations with Git based on a prompt using agentic execution

dispersl_new_docs_agent

Generate file by file technical documentation for a code repository using agentic execution

dispersl_chat_agent

Chat with the Dispersl agent to get knowledge or insights about codebases using agentic execution

dispersl_plan_agent

Multi-agent task dispersion using agentic execution (plan agent)

start_session

Start a new agentic session

end_session

End an active session

add_mcp_server

Connect to an external MCP server and save to config

remove_mcp_server

Disconnect from an MCP server and remove from config

get_models

List available AI models

get_keys

Get API keys for the authenticated user

new_key

Generate new API key

create_task

Create a new task

edit_task

Edit a task by ID

get_tasks

Get all tasks

get_task

Get a task by ID

cancel_task

Cancel a task by ID

edit_step

Edit a step by ID

get_steps

Get all steps

get_step

Get a step by ID

cancel_step

Cancel a step by ID

get_usage_stats

Get usage stats

get_language_stats

Get language usage stats

get_agent_stats

Get agent query stats

get_task_history

Get task history by ID

get_step_history

Get step history by ID

fetch_api_root

Fetch API root (utility endpoint)

health_check

Health check endpoint

Example: Chat

This agent is able to interact with the user to fetch insights, shared memories and task progress to the user.

await client.callTool({
  name: "start_session",
  arguments: { session_id: "my-session" }
});

const response = await client.callTool({
  name: "dispersl_chat_agent",
  arguments: {
    prompt: "Hello, how are you?",
    model: "meta-llama/llama-4-maverick:free"
  }
});

await client.callTool({
  name: "end_session",
  arguments: { session_id: "my-session" }
});

Example: Plan Agent

This agent is able to coordinate all the agents i.e code, test, git, documentation to execute complex tasks. Agents work in sync and handover tasks to each other once they complete their assigned role.

const response = await client.callTool({
  name: "dispersl_plan_agent",
  arguments: {
    prompt: "Plan a workflow for building and testing an ExpressJS web app using TypeScript",
    model: "meta-llama/llama-4-maverick:free",
    agents: ["code", "test", "git", "docs"]
  }
});

Example: Code Generation

This agent is able to run autonomously. It can also collaborate with the other agents i.e code, test, git, documentation to execute complex tasks. Agents work in sync and handover tasks to each other once they complete their assigned role.

const response = await client.callTool({
  name: "dispersl_code_agent",
  arguments: {
    prompt: "Create a simple hello world function",
    model: "meta-llama/llama-4-maverick:free"
  }
});

Example: Add External MCP Server

await client.callTool({
  name: "add_mcp_server",
  arguments: {
    name: "my-server",
    command: "node",
    args: ["dist/server.js"],
    env: { PORT: "8080" }
  }
});

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Run tests (requires DISPERSL_API_KEY)
npm test

# Lint
npm run lint

# Format code
npm run format

Contributing

Contributions are welcome! Please submit a Pull Request.


License

MIT License - see LICENSE file for details

Available Tools

28 tools
add_mcp_serverC

Connect to an external MCP server and save to config

Inputs: args (required), name (required), command (required), env.

cancel_stepC

Cancel a step by ID

Inputs: id (required).

cancel_taskC

Cancel a task by ID

Inputs: id (required).

create_taskC

Create a new task

Inputs: body (required).

dispersl_chat_agentC

Chat with the Dispersl agent to get knowledge or insights about codebases using agentic execution

Inputs: prompt (required), mcp, model, voice, +4 more.

dispersl_code_agentC

Generate code files and codebases based on a prompt using agentic execution

Inputs: prompt (required), mcp, model, context, +2 more.

dispersl_git_agentC

Execute codebase versioning operations with Git based on a prompt using agentic execution

Inputs: prompt (required), mcp, model, context, +2 more.

dispersl_new_docs_agentC

Generate file by file technical documentation for a code repository using agentic execution

Inputs: url (required), mcp, model, branch, +4 more.

dispersl_plan_agentC

Multi-agent task dispersion using agentic execution (plan agent). Agent choices can either be use 'code', 'test', 'git', 'docs' as the agent choices

Inputs: prompt (required), agent_choice (required), mcp, model, +4 more.

dispersl_testing_agentC

Generate end to end tests based on a prompt using agentic execution

Inputs: prompt (required), mcp, model, context, +2 more.

edit_stepC

Edit a step by ID

Inputs: id (required), body (required).

edit_taskC

Edit a task by ID

Inputs: id (required), body (required).

fetch_api_rootB

Fetch API root (utility endpoint)

Inputs: no named parameters.

get_agent_statsC

Get agent query stats

Inputs: body.

get_keysB

Get API keys for the authenticated user

Inputs: no named parameters.

get_language_statsC

Get language usage stats

Inputs: body.

get_stepC

Get a step by ID

Inputs: id (required).

get_step_historyC

Get step history by ID

Inputs: id (required), body.

get_stepsC

Get all steps

Inputs: no named parameters.

get_taskC

Get a task by ID

Inputs: id (required).

get_task_historyC

Get task history by ID

Inputs: id (required), body.

get_tasksC

Get all tasks

Inputs: no named parameters.

get_usage_statsD

Get usage stats

Inputs: body.

health_checkC

Health check endpoint

Inputs: no named parameters.

list_modelsC

List available models

Inputs: no named parameters.

new_keyB

Generate new API key

Inputs: no named parameters.

remove_mcp_serverC

Disconnect from an MCP server and remove from config

Inputs: name (required).

start_sessionC

Start a new agentic session

Inputs: session_id.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.4/5.0

    Scored across 28 tools

    Disambiguation4/5

    Most tools target distinct resources and actions, especially task/step CRUD, stats, and specialized agents. Minor ambiguity exists between the plan agent and specialized agents, and history/current getters require attention to descriptions.

    Naming Consistency4/5

    The set uses consistent snake_case and mostly follows a verb_noun pattern. Minor deviations like new_key vs create_task, fetch_api_root, and the dispersl_* agent prefixes are readable but not perfectly uniform.

    Tool Count2/5

    28 tools is heavy for a single MCP server, spanning tasks, steps, stats, agents, sessions, MCP configuration, models, and API keys. While many are distinct, the surface is large enough that consolidation or clearer grouping would improve usability.

    Completeness3/5

    Core task, step, agent, and key operations are present, but lifecycle coverage has notable gaps. There is no create_step, no delete/revoke for tasks, steps, or keys, no list MCP servers, and no session termination.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers