@abhaybabbar/retellai-mcp-server 1.0.0

package/.env.sample

@@ -0,0 +1 @@
+RETELL_API_KEY=***

package/README.md

@@ -0,0 +1,67 @@
+# RetellAI MCP Server
+
+This is a Model Context Protocol (MCP) server implementation for RetellAI, allowing AI assistants to interact with RetellAI's voice services.
+
+## Features
+
+The RetellAI MCP server provides tools for:
+
+- **Call Management**: Create and manage phone calls and web calls
+- **Agent Management**: Create and manage voice agents with different LLM configurations
+- **Phone Number Management**: Provision and configure phone numbers
+- **Voice Management**: Access and use different voice options
+
+## Setup
+
+1. Install dependencies:
+
+   ```bash
+   npm i
+   ```
+
+2. Create a `.env` file with your RetellAI API key:
+
+   ```
+   RETELL_API_KEY=your_api_key_here
+   ```
+
+3. Run the server:
+   ```bash
+   node src/retell/index.js
+   ```
+
+## Available Tools
+
+### Call Tools
+
+- `list_calls`: Lists all Retell calls
+- `create_phone_call`: Creates a new phone call
+- `create_web_call`: Creates a new web call
+- `get_call`: Gets details of a specific call
+- `delete_call`: Deletes a specific call
+
+### Agent Tools
+
+- `list_agents`: Lists all Retell agents
+- `create_agent`: Creates a new Retell agent
+- `get_agent`: Gets a Retell agent by ID
+- `update_agent`: Updates an existing Retell agent
+- `delete_agent`: Deletes a Retell agent
+- `get_agent_versions`: Gets all versions of a Retell agent
+
+### Phone Number Tools
+
+- `list_phone_numbers`: Lists all Retell phone numbers
+- `create_phone_number`: Creates a new phone number
+- `get_phone_number`: Gets details of a specific phone number
+- `update_phone_number`: Updates a phone number
+- `delete_phone_number`: Deletes a phone number
+
+### Voice Tools
+
+- `list_voices`: Lists all available Retell voices
+- `get_voice`: Gets details of a specific voice
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@abhaybabbar/retellai-mcp-server",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
+    "prepare": "npm run build",
+    "watch": "tsc --watch",
+    "inspector": "npx @modelcontextprotocol/inspector build/index.js"
+  },
+  "keywords": [],
+  "author": "abhaybabbar",
+  "license": "ISC",
+  "description": "RetellAi MCP Server",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.0",
+    "dotenv": "^16.5.0",
+    "retell-sdk": "^4.28.0"
+  },
+  "devDependencies": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/abhaybabbar/retellai-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/abhaybabbar/retellai-mcp-server/issues"
+  },
+  "homepage": "https://github.com/abhaybabbar/retellai-mcp-server#readme"
+}

package/src/client.ts

@@ -0,0 +1,10 @@
+import Retell from "retell-sdk";
+
+export const createRetellClient = (apiKey: string): Retell => {
+  if (!apiKey) {
+    throw new Error("No Retell API key available");
+  }
+  return new Retell({
+    apiKey,
+  });
+};

package/src/index.ts

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerAllTools } from "./tools/index.js";
+import { createRetellClient } from "./client.js";
+
+import dotenv from "dotenv";
+dotenv.config();
+
+function createMcpServer() {
+  const retellApiKey = process.env.RETELL_API_KEY;
+  if (!retellApiKey) {
+    throw new Error("RETELL_API_KEY environment variable is required");
+  }
+
+  const retellClient = createRetellClient(retellApiKey);
+
+  const mcpServer = new McpServer({
+    name: "Retell MCP",
+    version: "0.1.0",
+    capabilities: [],
+  });
+
+  registerAllTools(mcpServer, retellClient);
+
+  return mcpServer;
+}
+
+async function main() {
+  try {
+    const mcpServer = createMcpServer();
+
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+
+    setupShutdownHandler(mcpServer);
+  } catch (err) {
+    console.error("Error starting MCP server:", err);
+    process.exit(1);
+  }
+}
+
+function setupShutdownHandler(mcpServer: McpServer) {
+  process.on("SIGINT", async () => {
+    try {
+      await mcpServer.close();
+      process.exit(0);
+    } catch (err) {
+      console.error("Error shutting down MCP server:", err);
+      process.exit(1);
+    }
+  });
+}
+
+main();