spline MCP Server

Use This MCP server To

Export 3D scenes to GLB, GLTF, FBX, or OBJ formats Import 3D models into Spline projects Retrieve detailed information about Spline scenes List all available scenes within a Spline project Create and manage keyframe animations for 3D objects Trigger animations based on user interactions like clicks or hovers List animations present in a specific 3D scene Automate 3D project workflows using Spline API via MCP

README

Spline MCP Server

An MCP server for working with the Spline 3D design tool API. This server provides a convenient interface for Claude to interact with Spline's features, including exporting scenes, importing models, creating animations, and managing projects.

Features

Basic Operations

Export Spline scenes to various formats (GLB, GLTF, FBX, OBJ)
Import 3D models into Spline
Get details about Spline scenes
List available Spline scenes

Animation Capabilities

Create keyframe animations for objects
Trigger existing animations
List animations in a scene
Create event-triggered animations (onClick, onHover, etc.)

Installation

npm install spline-mcp-server

Or use it directly with npx:

npx spline-mcp-server

Configuration

Create a .env file with your Spline API credentials:

SPLINE_API_KEY=your_api_key_here
SPLINE_API_URL=https://api.spline.design

Usage

This MCP server can be used with Claude to interact with Spline's features. Here are some examples of how to use it:

Basic Operations

Export my Spline scene with ID "abc123" to GLB format

Import the 3D model from "https://example.com/model.glb" into my Spline project

Get details for my Spline scene with ID "abc123"

List my available Spline scenes

Animation Operations

Create an animation named "Rotate" for the cube object in my scene

Trigger the "Bounce" animation for the ball object

Create an onClick animation that makes an object move up when clicked

List all animations in my scene

Animation Examples

Creating a Simple Rotation Animation

Create an animation named "Spin" for object "cube-123" in scene "abc456" with keyframes for rotation

Creating an Event-Based Animation

Create an onClick animation named "Grow" for object "button-123" in scene "abc456" that scales the object to 1.5x its size

Triggering Animations

Trigger the "Pulse" animation for object "heart-123" in scene "abc456" with loop enabled

API Documentation

For more information about the Spline API, see the official documentation.

License

MIT

spline-mcp-server FAQ

How do I install the spline-mcp-server?

Install via npm with 'npm install spline-mcp-server' or run directly using 'npx spline-mcp-server'.

How do I configure API access for the spline-mcp-server?

Create a .env file with your SPLINE_API_KEY and SPLINE_API_URL to authenticate requests.

Can I export 3D scenes to multiple file formats?

Yes, the server supports exporting scenes to GLB, GLTF, FBX, and OBJ formats.

Does the server support animation creation?

Yes, it allows creating keyframe animations and event-triggered animations like onClick and onHover.

How does the server interact with LLMs like Claude?

It provides a structured API interface enabling Claude to query and manipulate Spline 3D scenes programmatically.

Is it possible to list all animations in a scene?

Yes, the server can list animations available within any given Spline scene.

What environment variables are required?

SPLINE_API_KEY for authentication and SPLINE_API_URL for the API endpoint must be set.

Can I use this server with other LLM providers?

Yes, it is provider-agnostic and works with models like Claude, GPT-4, and Gemini.