Spline MCP Server

Name: Spline MCP Server
Author: aydinfer

@aydinfer

Repository

About Spline MCP Server

An MCP server for working with Spline 3D design tool API

#spline #3d-design #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "spline-mcp-server": {
      "command": "npx",
      "args": [
        "spline-mcp-server"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Spline MCP Server?

An archived MCP server that aimed to control Spline.design 3D scenes programmatically. Due to Spline’s lack of a public REST API, most of the ~130 scene manipulation tools are non‑functional. The only operational part is a set of code generation tools that produce @splinetool/runtime code for Vanilla JS, React, and Next.js.

How to use Spline MCP Server?

Configure Claude Desktop by adding the server entry to your MCP config with npx -y spline-mcp-server. For local development, clone the repository, run npm install and npm start. Then ask Claude to generate Spline runtime code for web projects (e.g., React components with click handlers, hover animations, Next.js integration).

Key features of Spline MCP Server

10 code generation tools for @splinetool/runtime
Generates Vanilla JS, React, and Next.js code
Emits working code for interactive scene control
Provides prompts for common Spline runtime tasks

Use cases of Spline MCP Server

Generate a React component that loads a 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

FAQ from Spline MCP Server

Why is the Spline MCP Server archived?

Spline.design does not provide 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.

What functionality of the Spline MCP Server still works?

The 10 code generation tools that produce @splinetool/runtime code for Vanilla JS, React, and Next.js. All other tools are non‑functional.

How do I install the Spline MCP Server?

Add the server to your Claude Desktop MCP config using npx -y spline-mcp-server. For local development, clone the repo, run npm install and npm start.

What is the `@splinetool/runtime` API that the code generation tools target?

The runtime provides methods like findObjectByName, findObjectById, getAllObjects, emitEvent, addEventListener, setVariable, getVariable, setZoom, play, and stop. Objects expose position, rotation, scale, visible, and intensity properties.

Does Spline have a public REST API I can use instead?

No. Spline’s developer tools are a client‑side JavaScript runtime (@splinetool/runtime) that works only in a browser with a canvas element, and a Real‑time API inside the Spline editor for making outbound calls. Neither supports server‑side programmatic control.