The Spline MCP Server is an archived project primarily designed to generate client-side Spline runtime code for web applications. Most of its intended server-side scene manipulation features are non-operational due to the lack of a public Spline REST API.
Working Capabilities (Code Generation):
Generate
@splinetool/runtimecode for Vanilla JS, React, and Next.js to load and interact with Spline scenesGenerate React components with event handlers (e.g., click handlers) attached to scene objects
Generate animation code for rotating, moving, scaling, or changing object colors on user interaction
Generate object manipulation code (move, rotate, scale, color, visibility, emit events)
Generate event listener code for mouse, touch, keyboard, and scene events
Generate variable get/set code for managing interactive scene state
Generate embed (iframe) code for Spline scenes
Generate comprehensive usage examples and scene interaction boilerplate
Get runtime setup instructions (
getRuntimeSetup)Generate text via OpenAI (
generateTextWithOpenAI)
Non-Functional Capabilities (broken — no public API exists):
~130 tools targeting non-existent Spline REST endpoints, covering scene management, object CRUD, material management, state/event/action management, webhooks, physics, particles, lighting, cameras, and post-processing effects — all will fail with network errors.
Enables configuration of the server with environment variables stored in a .env file, including API credentials for Spline
Supports exporting Spline scenes to glTF format, allowing 3D models to be used in various platforms that support the format
Allows installation and running of the server through npm, including direct execution with npx
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Spline MCP Servercreate a rotating cube animation with a metallic material"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Spline.design MCP Server (Archived)
This project is archived. Spline.design does not provide a public REST API, making most of this server's functionality non-operational. See below for details.
Why archived
This MCP server was built to programmatically control Spline.design 3D scenes through Claude. However, Spline does not offer a public REST API for scene manipulation. The ~130 tools that call api.spline.design target endpoints that don't exist and will fail with network errors.
Spline's actual developer tools are:
Code API — A client-side JavaScript runtime (
@splinetool/runtime) that only works in a browser with a canvas element. It can manipulate objects in exported scenes but cannot create scenes or objects.Real-time API — A feature inside the Spline editor for making outbound API calls from Spline to external services. Not an inbound API.
Neither of these enables the kind of server-side programmatic control this MCP server attempts.
What does work
10 code generation tools generate @splinetool/runtime code for Vanilla JS, React, and Next.js. However, Claude can already write this code without an MCP server, making these tools redundant.
Related MCP server: Sketchfab MCP Server
Installation
Using npx (for Claude Desktop)
Add this to your Claude Desktop MCP config:
{
"mcpServers": {
"spline": {
"command": "npx",
"args": ["-y", "spline-mcp-server"]
}
}
}Local development
git clone https://github.com/aydinfer/spline-mcp-server.git
cd spline-mcp-server
npm install
npm startWhat you can do with it
Ask Claude to generate Spline runtime code for your projects:
"Generate a React component that loads my Spline scene and adds click handlers to objects"
"Write animation code that rotates an object on hover"
"Create an interactive scene with variable-based state management"
"Generate Next.js code with Spline integration"
Claude will use the code generation tools to produce working @splinetool/runtime code you can use directly in your web projects.
Spline Runtime API Reference
The @splinetool/runtime provides these methods (which the code generation tools target):
Method | Description |
| Find an object by name |
| Find an object by ID |
| List all scene objects |
| Trigger an event on an object |
| Listen for scene events |
| Set a scene variable |
| Get a scene variable |
| Control zoom level |
| Control rendering |
Objects expose position, rotation, scale, visible, and intensity properties.
Project Structure
spline-mcp-server/
├── src/
│ ├── tools/ # MCP tool implementations
│ │ └── design/ # Advanced design tools (pending API)
│ ├── utils/ # API client and runtime manager
│ ├── prompts/ # Prompt templates
│ ├── resources/ # MCP resources
│ └── index.js # Main server entry point
├── bin/cli.js # CLI entry point
├── docs/ # Documentation
└── package.jsonLicense
This project is licensed under the MIT License — see the LICENSE file for details.
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.