MiguelMartinezCV/chatvolt-agent-server

Chatvolt Agent Server

This project is a Model Context Protocol (MCP) server that acts as a gateway to a set of RESTful APIs for managing AI agents, CRM scenarios, and their associated steps. It allows an AI agent to interact with and control other AI agents and their configurations through a defined set of tools.

This server is built with TypeScript and utilizes the @modelcontextprotocol/sdk to expose the underlying Chatvolt API functionalities as MCP tools.

Features

The server exposes tools to perform CRUD operations on three main resources:

• Agents: AI agents that can be created, retrieved, updated, and deleted.
• Scenarios: CRM scenarios that agents can follow.
• Steps: Individual steps within a CRM scenario.

Tools

The following tools are available to an AI agent connected to this MCP server:

• create_agent: Creates a new AI agent.
• get_agent: Retrieves an existing AI agent by its ID.
• update_agent: Updates an existing AI agent.
• delete_agent: Deletes an AI agent.
• list_scenarios: Lists all available CRM scenarios.
• create_scenario: Creates a new CRM scenario.
• update_scenario: Updates an existing CRM scenario.
• delete_scenario: Deletes a CRM scenario.
• list_steps: Lists all steps for a given CRM scenario.
• create_step: Creates a new step in a CRM scenario.
• update_step: Updates an existing step.
• delete_step: Deletes a step.

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Testing

To run the integration tests, you will need to have a CHATVOLT_API_KEY environment variable set.

npm run test:integration

Installation

To use with an MCP-compatible client (like Claude Desktop), add the server configuration. This is the recommended configuration:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "chatvolt-agent-server": {
      "command": "npx",
      "args": [
        "chatvolt-agent-server"
      ],
      "env": {
        "CHATVOLT_API_KEY": "YOUR_KEY"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.