Documentation
Scriptling is a minimal, sandboxed interpreter for Python-like scripting designed for embedding in Go applications. Use the sections below to get started, integrate with Go, or explore tutorials.
Choose by task
- New to Scriptling: Start with Getting Started to install the CLI or embed the interpreter, then learn the language from the Reference.
- Run a server: Choose the CLI guide for HTTP, JSON-RPC, MCP, or plugin server modes.
- Find a library: Look it up in the A–Z list or browse the Library Reference by capability, and check registration requirements for your runtime.
- Connect to a database: Choose a driver or ORM from the Database Libraries.
Guides
Getting Started
Install the CLI or embed Scriptling in Go
CLI Guide
Running scripts, HTTP server mode, MCP server mode, and packages
Go Integration
Embed the interpreter, register functions, and create custom libraries
Security Guide
Sandbox configuration, path restrictions, and network access control
Plugins
Extend Scriptling with Go, C, PHP, or any JSON-RPC language
LLM Script Generation Guide
Guidance for generating accurate Scriptling code with LLMs
Tutorials
Step-by-step guides: API data, rules engines, MCP servers and plugins
Script Metadata
Declare the scriptling version, libraries and plugins a script needs
Tutorials
Step-by-step guides for real-world scenarios:
- Fetching API Data: Write a CLI script that fetches data from a public API and processes the results.
- Embedding a Rules Engine: Embed Scriptling in a Go application to evaluate business rules at runtime.
- MCP Tool Server: Create a Model Context Protocol server with custom tools for AI assistants.
- Resources & Prompts Server: Create MCP resources and prompts as files, alongside tools.
- MCP App Package: Build a complete MCP application with an app view, tools, a prompt and a skill, package it as one artifact, and run it from the package.
- Writing a Go Plugin: Build an executable plugin that exposes functions and classes under plugin.*.
- Writing a C Plugin: Build a multi-threaded C plugin with functions, classes, properties, callbacks, and logging.
- Writing a Fetcher Plugin: Serve libraries, assets and script sources from a plugin-owned scheme such as demo://.
- Plugin Callbacks: Pass a Scriptling callback into a Go plugin and stream events back while the function runs.
Reference
For language syntax, built-in functions, and library APIs, see the Reference section.