Which integrations are available for this server?

Enables interaction with n8n for workflow automation, including status checks, workflow generation, and webhook triggers.

How do I use spline-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@spline-mcp generate React component for scene https://prod.spline.design/abc123/scene.splinecode" 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-mcp

by lesleslie

Overview Schema Related Servers Score Discussions

Python

Remote

spline-mcp

Code style: crackerjack Runtime: oneiric Framework: FastMCP Python: 3.14+

MCP server for Spline.design code generation and asset management.

Overview

Spline.design is a 3D design tool that exports interactive scenes for the web. This MCP server provides:

Code Generation: Generate React, Next.js, and vanilla JS integration code
Asset Management: Download, cache, and validate .splinecode files
Integration Support: WebSocket (Mahavishnu) integration
Helper Utilities: URL building, event documentation, code snippets

Note: Spline does not have a traditional REST API. Scenes are created in the Spline editor and exported as .splinecode files for runtime use.

Related MCP server: Pixal3D-MCP

Spline V2 Compatibility

Spline V2 (released August 20, 2026) ships its own MCP server inside the rebuilt Spline desktop app that lets AI agents drive the editor directly — creating and modifying objects, materials, lights, cameras, booleans, particles, cloners, lathes, sky, variables, events, and states. See the Spline V2 launch announcement for details.

This server fills a different, complementary niche:

Workflow stage	Tool
Authoring — building / editing the scene in the editor	Spline V2 MCP (bundled with the Spline desktop app)
Embedding — putting the exported scene into your React / Next.js / vanilla app	This server (`spline-mcp`)
Runtime control — manipulating variables / events from your app at runtime	Both cooperate: V2 MCP builds the scene; this server emits the JS that drives `setNumberVariable()` / `emitEvent()` from the host app

Concretely, this server does not edit scenes — it operates strictly on already-exported .splinecode URLs. If you need an agent to author a new scene from scratch, install the Spline desktop app and use its built-in MCP server. Use this server when you have a published .splinecode URL and want to scaffold the React / Next.js / vanilla integration, cache the scene asset, wire up runtime event handlers, or pipe events into Mahavishnu.

Installation

uv pip install -e .

Quick Start

Generate a React Component

spline-mcp generate react https://prod.spline.design/6Wq1Q7YGyM-iab9i/scene.splinecode

Download a Scene

spline-mcp download https://prod.spline.design/6Wq1Q7YGyM-iab9i/scene.splinecode

MCP Server Usage

Stdio Mode (default)

spline-mcp serve

HTTP Mode

spline-mcp serve --http --port 3048

Available Tools

Code Generation

Tool	Description
`generate_react_component`	Generate React component with TypeScript
`generate_vanilla_js`	Generate standalone HTML/JS
`generate_nextjs_component`	Generate Next.js component with SSR support
`generate_event_handler`	Generate event handler code
`generate_variable_binding`	Generate runtime variable bindings
`generate_full_integration`	Complete integration with all features

Asset Management

Tool	Description
`download_scene`	Download and cache a .splinecode file
`validate_scene`	Validate a .splinecode file
`list_cached_scenes`	List all cached scenes
`clear_cache`	Clear cached scenes
`get_cache_stats`	Get cache statistics

Helper Utilities

Tool	Description
`build_export_url`	Build export URL from scene ID
`parse_scene_url`	Parse URL to extract scene ID
`list_event_types`	List supported Spline event types
`get_event_documentation`	Get docs for specific event
`generate_snippet`	Generate common code snippets

Integration

Tool	Description
`get_websocket_status`	Check Mahavishnu WebSocket connection
`subscribe_to_channel`	Subscribe to real-time updates
`get_integration_status`	Status of all integrations
`get_integration_status`	Status of all integrations

Documentation

Tool	Description
`get_runtime_api_docs`	Get documentation for the @splinetool/runtime API by topic
`get_installation_guide`	Get installation guide for the Spline runtime
`get_troubleshooting_guide`	Get troubleshooting guide for common Spline issues

Configuration

Set via environment variables with SPLINE_ prefix:

Variable	Default	Description
`SPLINE_DEFAULT_FRAMEWORK`	`react`	Default framework (react/vanilla/nextjs)
`SPLINE_TYPESCRIPT`	`true`	Generate TypeScript code
`SPLINE_LAZY_LOAD`	`true`	Use lazy loading with Suspense
`SPLINE_SSR_PLACEHOLDER`	`false`	Generate SSR placeholder for Next.js
`SPLINE_INDENT_SPACES`	`2`	Indentation spaces for generated code (2-8)
`SPLINE_SEMICOLONS`	`true`	Use semicolons in generated JavaScript
`SPLINE_CACHE_DIR`	`~/.spline-mcp/cache`	Cache directory
`SPLINE_MAX_CACHE_SIZE_MB`	`500`	Maximum cache size
`SPLINE_AUTO_VALIDATE`	`true`	Automatically validate downloaded scenes
`SPLINE_WEBSOCKET_ENABLED`	`true`	Enable WebSocket integration
`SPLINE_WEBSOCKET_URL`	`ws://localhost:8690`	Mahavishnu WebSocket URL
`SPLINE_WEBSOCKET_AUTO_RECONNECT`	`true`	Automatically reconnect on disconnect
`SPLINE_ENABLE_HTTP_TRANSPORT`	`false`	Enable HTTP transport
`SPLINE_HTTP_HOST`	`127.0.0.1`	HTTP server host
`SPLINE_HTTP_PORT`	`3048`	HTTP server port
`SPLINE_LOG_LEVEL`	`INFO`	Logging level
`SPLINE_LOG_JSON`	`true`	Use JSON logging format

Generated Code Examples

React Component

import { Suspense, useRef, useCallback } from 'react';
import Spline from '@splinetool/react-spline';

interface HeroSceneProps {
  className?: string;
}

export function HeroScene({ className }: HeroSceneProps) {
  return (
    <Suspense fallback={<div>Loading 3D scene...</div>}>
      <Spline
        scene="https://prod.spline.design/xxx/scene.splinecode"
        className={className}
      />
    </Suspense>
  );
}

With WebSocket Integration

// Auto-generated WebSocket integration with soft failover
const { subscribe, isConnected } = useWebSocket('ws://localhost:8690');

useEffect(() => {
  if (!isConnected) return;

  const unsubscribe = subscribe('spline:variables', (data) => {
    splineRef.current?.setVariables(data);
  });

  return unsubscribe;
}, [isConnected]);

Architecture

spline_mcp/
├── generators/         # Code generation (React, Vanilla, Next.js)
│   ├── base.py         # Base classes and types
│   ├── react.py        # React generator with FastBlocks patterns
│   ├── vanilla.py      # Vanilla JS/HTML generator
│   └── nextjs.py       # Next.js SSR generator
├── assets/             # Asset management
│   ├── manager.py      # Download, cache, validate
│   └── validator.py    # Scene file validation
├── integrations/       # External integrations
│   └── websocket.py    # Mahavishnu WebSocket (soft failover)
├── tools/              # MCP tool definitions
│   ├── generation.py   # Code generation tools
│   ├── assets.py       # Asset management tools
│   ├── helpers.py      # Utility tools
│   └── integration.py  # Integration tools
├── config.py           # Oneiric-based configuration
└── server.py           # FastMCP application

Ecosystem Integration

Part of the Bodai Ecosystem:

Component	Role	Port
Mahavishnu	Orchestrator	8680
Akosha	Seer	8682
Dhara	Curator	8683
Session-Buddy	Builder	8678
Crackerjack	Inspector	8676
spline-mcp	3D Orchestrator	3048

Installation via Bodai Marketplace

This repo ships a Bodai Claude Code plugin manifest (.claude-plugin/plugin.json) plus a colocated .mcp.json and three slash commands in commands/. To install via the Bodai marketplace, first register the marketplace with Claude Code, then install the plugin by name. Once installed, the slash commands /spline-generate, /spline-assets, and /spline-websocket become available alongside the mcp__spline__* tools. Make sure the spline-mcp HTTP server is running on its configured port before invoking the slash commands.

License

BSD-3-Clause

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Vitrine MCP Serverofficial
E-commerce & Retail Design Tools
vitrine3d
A
license
A
quality
C
maintenance
MCP server for Vitrine, the 3D product viewer platform. Enables AI agents to upload GLB models, configure scenes, publish embeds, and manage Looks.
Updated 4 months ago (2026-05-10 16:55 UTC)
17
20
1
MIT
Pixal3D-MCP
AI & Machine Learning Image & Video Processing
Lightfielder
F
license
Not graded
quality
B
maintenance
Standalone MCP server for generating high-fidelity 3D assets from a single image using Pixal3D inference.
Updated 4 months ago (2026-05-14 10:00 UTC)
2
Rodin Gen-2 MCP Server
AI & Machine Learning Design Tools
TiGRoNdev
A
license
A
quality
D
maintenance
MCP server for integrating with Rodin Gen-2 API to generate 3D models from text descriptions or images.
Updated 10 months ago (2025-11-14 17:22 UTC)
6
MIT
GameDev-MCP-Server
Games & Gamification Developer Tools
IvanMurzak
A
license
Not graded
quality
A
maintenance
Open-source, engine-agnostic MCP server shared by Unity-MCP, Godot-MCP, and Unreal-MCP.
Updated 10 days ago (2026-08-21 07:02 UTC)
9
Apache 2.0

View all related MCP servers

Related MCP Connectors

Supabase
MCP server for interacting with the Supabase platform
Lovable
Official MCP server for Lovable, the AI-powered full-stack app builder.
mcp-seedream-pro
MCP server for ByteDance Seedream AI image generation

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lesleslie/spline-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

spline-mcp

Overview

Spline V2 Compatibility

Installation

Quick Start

Generate a React Component

Download a Scene

MCP Server Usage

Stdio Mode (default)

HTTP Mode

Available Tools

Code Generation

Asset Management

Helper Utilities

Integration

Documentation

Configuration

Generated Code Examples

React Component

With WebSocket Integration

Architecture

Ecosystem Integration

Installation via Bodai Marketplace

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

Vitrine MCP Serverofficial

Pixal3D-MCP

Rodin Gen-2 MCP Server

GameDev-MCP-Server

Related MCP Connectors

Latest Blog Posts

MCP directory API