Code Execution

The AgentiCode MCP server provides sandboxed code execution in user-isolated workspaces.

Authentication: User session with workspace isolation

Tools

execute_code

Execute code in multiple languages:

Input:
  code: string - Code to execute
  language: string - Programming language
  user_id: string - User identifier
  filename?: string - Optional filename
  timeout_seconds?: number - Timeout (default: 30)

Output:
  stdout: string - Standard output
  stderr: string - Standard error
  exitCode: number - Exit code
  filename: string - Executed file
  filepath: string - Full path

Supported Languages:
  - python
  - javascript
  - typescript
  - go
  - bash / shell
  - sql
  - rust

run_shell_command

Execute shell commands:

Input:
  command: string - Shell command
  user_id: string - User identifier
  working_directory?: string - Working directory
  timeout_seconds?: number - Timeout (default: 30)

Output:
  stdout: string
  stderr: string
  exitCode: number

write_file

Write file to workspace:

Input:
  filepath: string - File path (relative to workspace)
  content: string - File content
  user_id: string - User identifier

Output: Write confirmation

read_file

Read file from workspace:

Input:
  filepath: string - File path
  user_id: string - User identifier

Output: File content

list_files

List workspace files:

Input:
  directory?: string - Directory path (default: workspace root)
  user_id: string - User identifier
  recursive?: boolean - Include subdirectories

Output: File listing with metadata

get_session_info

Get user session details:

Input:
  user_id: string - User identifier

Output:
  sessionId: string
  workspace: string
  status: string
  created: timestamp

stop_session

Stop user session:

Input:
  user_id: string - User identifier
  session_id?: string - Specific session

Output: Stop confirmation

Architecture

MCP Proxy
    │
    ▼
AgentiCode Manager
    │
    ▼
PTY Session (per user)
    │
    ▼
Isolated Workspace (/workspaces/{userId})

Workspace Isolation

Each user gets an isolated workspace:

• Path: /workspaces/{userId}

• Files persist across sessions

• No access to other users' workspaces

• Resource limits enforced

Supported Languages

Python

# Executed with python3
print("Hello, World!")

# Libraries available: numpy, pandas, requests, etc.
import numpy as np
arr = np.array([1, 2, 3])
print(arr.mean())

JavaScript

// Executed with node
console.log("Hello, World!");

// ES modules supported
const result = await fetch('https://api.example.com');

TypeScript

// Compiled and executed with ts-node
const greeting: string = "Hello, World!";
console.log(greeting);

Go

// Compiled and executed with go run
package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}

Bash/Shell

#!/bin/bash
echo "Hello, World!"
ls -la

SQL

-- Executed against configured database
SELECT * FROM users LIMIT 10;

Rust

// Compiled and executed with rustc
fn main() {
    println!("Hello, World!");
}

Timeouts

• Default: 30 seconds

• Maximum: 300 seconds (5 minutes)

• Long-running tasks should use background execution

Security

• Sandboxed execution: Isolated from host system

• Resource limits: CPU, memory, disk quotas

• Network isolation: Limited network access

• No root access: Runs as unprivileged user

• File system isolation: Per-user workspaces only