Spline MCP Server

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.