YepCode MCP Server

What is YepCode MCP Server about?

Provides an MCP server that connects AI assistants to YepCode's infrastructure, allowing real‑time execution of scripts, environment management, file storage operations, and direct invocation of YepCode processes.

How to use YepCode MCP Server?

Obtain a YepCode API token from the YepCode Cloud settings.
Run the server locally with NPX (Node 18+ required) or via Docker, or connect to the hosted remote SSE endpoint.
Configure your AI platform’s MCP client with the server details—either a URL (including the token) for remote use or an NPX command for local execution.
Call the exposed tools (run_code, set_env_var, list_files, run_ycp_<process_slug>, etc.) from the AI assistant.

Key features of YepCode MCP Server

Zero‑configuration AI integration – simply provide the API token.
Code execution – run arbitrary JavaScript (or other languages) in a secure, isolated environment.
Environment variable management – set and remove workspace variables with optional masking.
Built‑in storage API – list, upload, download, and delete files, accessible from executed code.
Process exposure – turn any YepCode Process tagged with mcp-tool into an MCP tool (run_ycp_<process_slug>).
Debugging support – built‑in MCP Inspector for visual debugging of stdio communication.
Configurable options – disable the run_code tool or keep source code after execution via YEPCODE_MCP_OPTIONS.

Use cases of YepCode MCP Server

AI‑driven automation: Let LLMs orchestrate complex workflows by invoking YepCode processes directly.
Dynamic code generation: Generate and execute code on the fly from an AI assistant, returning results instantly.
Secure secret handling: Manage sensitive environment variables without exposing them to the AI model.
File‑centric AI tasks: Upload, process, and retrieve files (e.g., data transformation, image manipulation) within AI‑generated scripts.
Enterprise workflow integration: Bridge internal YepCode automation with external AI platforms like Cursor or Claude Desktop.

FAQ from the YepCode MCP Server

Q: Do I need to install Docker if I use NPX?
A: No. NPX runs the server directly with Node.js; Docker is an alternative for containerized deployments.

Q: Which environment variable holds the API token?
A: YEPCODE_API_TOKEN (or pass it as an Authorization: Bearer <token> header for HTTP endpoints).

Q: Can I disable the run_code tool?
A: Yes, add disableRunCodeTool to YEPCODE_MCP_OPTIONS.

Q: How do I keep the executed source code for audit purposes?
A: Include runCodeCleanup in YEPCODE_MCP_OPTIONS to prevent automatic cleanup.

Q: What languages are supported for run_code?
A: JavaScript is default; other languages can be specified via the language option if supported by YepCode.

YepCode MCP Server Preview

What is YepCode MCP Server?

An MCP (Model Context Protocol) server that enables AI platforms to interact with YepCode's infrastructure. Run LLM generated scripts and turn your YepCode processes into powerful tools that AI assistants can use directly.

Why YepCode MCP Server?

Seamless AI Integration: Convert YepCode processes into AI-ready tools with zero configuration
Real-time Process Control: Enable direct interaction between AI systems and your workflows
Enterprise-Grade Security: Execute code in YepCode's isolated, production-ready environments
Universal Compatibility: Integrate with any AI platform supporting the Model Context Protocol

Integration Guide

YepCode MCP server can be integrated with AI platforms like Cursor or Claude Desktop using either a remote approach (we offer a hosted version of the MCP server) or a local approach (NPX or Docker installation is required).

For both approaches, you need to get your YepCode API credentials:

Sign up to YepCode Cloud
Visit Settings > API credentials to create a new API token.

Remote Approach using SSE Server

If your MCP Client doesn't support authentication headers, just use the SSE server URL that includes the API Token. Use a configuration similar to the following:

{
  "mcpServers": {
    "yepcode-mcp-server": {
      "url": "https://cloud.yepcode.io/mcp/sk-c2E....RD/sse"
    }
  }
}

If your MCP Client supports authentication headers, you can use the HTTP server URL that includes the API Token. Use a configuration similar to the following:

{
  "mcpServers": {
    "yepcode-mcp-server": {
      "url": "https://cloud.yepcode.io/mcp/sse",
      "headers": {
        "Authorization": "Bearer <sk-c2E....RD>"
      }
    }
  }
}

Local Approach

Using NPX

Make sure you have Node.js installed (version 18 or higher), and use a configuration similar to the following:

{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yepcode/mcp-server"],
      "env": {
        "YEPCODE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Using Docker

Build the container image:

docker build -t yepcode/mcp-server .

Use a configuration similar to the following:

{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-d",
        "-e",
        "YEPCODE_API_TOKEN=your_api_token_here",
        "yepcode/mcp-server"
      ]
    }
  }
}

Debugging

Debugging MCP servers can be tricky since they communicate over stdio. To make this easier, we recommend using the MCP Inspector, which you can run with the following command:

npm run inspector

This will start a server where you can access debugging tools directly in your browser.

YepCode MCP Tools Reference

The MCP server provides several tools to interact with YepCode's infrastructure:

Code Execution

run_code

Executes code in YepCode's secure environment.

// Input
{
  code: string;                          // The code to execute
  options?: {
    language?: string;                   // Programming language (default: 'javascript')
    comment?: string;                    // Execution context
    settings?: Record<string, unknown>;  // Runtime settings
  }
}

// Response
{
  returnValue?: unknown;                 // Execution result
  logs?: string[];                       // Console output
  error?: string;                        // Error message if execution failed
}

MCP Options

YepCode MCP server supports the following options:

Disable the run_code tool: In some cases, you may want to disable the run_code tool. For example, if you want to use the MCP server as a provider only for the existing tools in your YepCode account.
Skip the run_code cleanup: By default, run_code processes source code is removed after execution. If you want to keep it for audit purposes, you can use this option.

Options can be passed as a comma-separated list in the YEPCODE_MCP_OPTIONS environment variable or as a query parameter in the MCP server URL.

// SSE server configuration
{
  "mcpServers": {
    "yepcode-mcp-server": {
      "url": "https://cloud.yepcode.io/mcp/sk-c2E....RD/sse?mcpOptions=disableRunCodeTool,runCodeCleanup"
    }
  }
}

// NPX configuration
{
  "mcpServers": {
    "yepcode-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yepcode/mcp-server"],
      "env": {
        "YEPCODE_API_TOKEN": "your_api_token_here",
        "YEPCODE_MCP_OPTIONS": "disableRunCodeTool,runCodeCleanup"
      }
    }
  }
}

Environment Management

set_env_var

Sets an environment variable in the YepCode workspace.

// Input
{
  key: string;                           // Variable name
  value: string;                         // Variable value
  isSensitive?: boolean;                 // Whether to mask the value in logs (default: true)
}

remove_env_var

Removes an environment variable from the YepCode workspace.

// Input
{
  key: string;                           // Name of the variable to remove
}

Storage Management

YepCode provides a built-in storage system that allows you to upload, list, download, and delete files. These files can be accessed from your code executions using the yepcode.storage helper methods.

list_files

Lists all files in your YepCode storage.

// Input
{
  prefix?: string;                       // Optional prefix to filter files
}

// Response
{
  files: Array<{
    filename: string;                    // File name or path
    size: number;                        // File size in bytes
    lastModified: string;                // Last modification date
  }>;
}

upload_file

Uploads a file to YepCode storage.

// Input
{
  filename: string;                      // File path (e.g., 'file.txt' or 'folder/file.txt')
  content: string | {                   // File content
    data: string;                        // Base64 encoded content for binary files
    encoding: "base64";
  };
}

// Response
{
  success: boolean;                      // Upload success status
  filename: string;                      // Uploaded file path
}

download_file

Downloads a file from YepCode storage.

// Input
{
  filename: string;                      // File path to download
}

// Response
{
  filename: string;                      // File path
  content: string;                       // File content (base64 for binary files)
  encoding?: string;                     // Encoding type if binary
}

delete_file

Deletes a file from YepCode storage.

// Input
{
  filename: string;                      // File path to delete
}

// Response
{
  success: boolean;                      // Deletion success status
  filename: string;                      // Deleted file path
}

Process Execution

The MCP server can expose your YepCode Processes as individual MCP tools, making them directly accessible to AI assistants. This feature is enabled by just adding the mcp-tool tag to your process (see our docs to learn more about process tags).

There will be a tool for each exposed process: run_ycp_<process_slug> (or run_ycp_<process_id> if tool name is longer than 60 characters).

run_ycp_<process_slug>

// Input
{
  parameters?: any;                      // This should match the input parameters specified in the process
  options?: {
    tag?: string;                        // Process version to execute
    comment?: string;                    // Execution context
  };
  synchronousExecution?: boolean;        // Whether to wait for completion (default: true)
}

// Response (synchronous execution)
{
  executionId: string;                   // Unique execution identifier
  logs: string[];                        // Process execution logs
  returnValue?: unknown;                 // Process output
  error?: string;                        // Error message if execution failed
}

// Response (asynchronous execution)
{
  executionId: string;                   // Unique execution identifier
}

get_execution

Retrieves the result of a process execution.

// Input
{
  executionId: string;                   // ID of the execution to retrieve
}

// Response
{
  executionId: string;                   // Unique execution identifier
  logs: string[];                        // Process execution logs
  returnValue?: unknown;                 // Process output
  error?: string;                        // Error message if execution failed
}

License

This project is licensed under the MIT License - see the LICENSE file for details.

YepCode MCP Server