Spline

v1.0.0Developer Toolsstable

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

splinemcpai-integration
Share:
69
Stars
0
Downloads
0
Weekly
0/5

What is Spline?

Spline is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for working with spline 3d design tool api

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

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

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

Use Cases

Interact with Spline 3D design tool API.
Create and manage 3D scenes and components.
Export and manipulate Spline design assets.
aydinfer

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMay 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx spline

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Spline

The Spline MCP server bridges Claude and the Spline 3D design tool, enabling AI-driven code generation for embedding and controlling Spline scenes in web applications. It exposes tools for generating working JavaScript, React, and Next.js integration code using the @splinetool/runtime library, covering object queries, event handling, variable management, and playback control. Developers use it to get instant, runnable code for adding interactivity to their Spline-powered 3D web experiences without manually consulting the runtime API.

Prerequisites

  • Node.js 16 or later with npx available
  • A Spline account and at least one published 3D scene (spline.design)
  • The @splinetool/runtime npm package installed in your web project for runtime integration
  • An MCP-compatible client such as Claude Desktop
1

Install the Spline MCP server

The server is distributed as an npm package and can be run directly via npx. No global install is required — Claude Desktop will invoke it on demand.

npx -y spline-mcp-server
2

Add the server to Claude Desktop config

Open your Claude Desktop configuration file and add the spline entry under mcpServers. No API key or environment variables are required for the code generation tools.

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

Publish your Spline scene and copy its URL

In the Spline editor, click the Export or Publish button and copy the public scene URL (e.g. https://prod.spline.design/your-scene-id/scene.splinecode). You will pass this URL to Claude when requesting integration code.

4

Restart Claude Desktop

Quit and reopen Claude Desktop so it recognizes the new MCP server. The spline server will start automatically when Claude first uses it.

5

Request integration code from Claude

Ask Claude to generate a React component, vanilla JS snippet, or Next.js page that loads your Spline scene. Provide the scene URL and describe any interactions you need (click handlers, variable updates, animations).

Spline Examples

Client configuration

Minimal claude_desktop_config.json entry for the Spline MCP server. No credentials are needed.

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

Prompts to try

Example natural-language prompts for generating Spline runtime integration code.

- "Generate a React component that loads my Spline scene from https://prod.spline.design/abc123/scene.splinecode and emits a click event on the 'Button' object"
- "Write a Next.js page that embeds my Spline scene and toggles the visibility of an object named 'Panel' on button click"
- "Create vanilla JavaScript code that loads a Spline scene, finds an object by name, and updates its position on mouse hover"
- "Show me how to use setVariable to change a Spline scene variable called 'colorTheme' based on user input"

Troubleshooting Spline

Generated code fails to load the scene in the browser

Ensure you have installed @splinetool/runtime in your project ('npm install @splinetool/runtime') and that your scene URL ends in .splinecode and is publicly accessible.

findObjectByName returns null for a known object

Object names are case-sensitive and must match exactly as set in the Spline editor. Open your scene in Spline and verify the exact name in the Layers panel, then re-run the Claude prompt with the corrected name.

The MCP server starts but Claude says no tools are available

Check that the args array uses '-y' before 'spline-mcp-server'. Restart Claude Desktop after editing the config. Run 'npx -y spline-mcp-server' in a terminal to confirm the package installs without errors.

Frequently Asked Questions about Spline

What is Spline?

Spline is a Model Context Protocol (MCP) server that mcp server for working with spline 3d design tool api It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Spline?

Follow the installation instructions on the Spline GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Spline?

Spline works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Spline free to use?

Yes, Spline is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

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

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Spline?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides