Atlas / MCP servers / aydinfer / Spline

SplineSAFE

mcp/aydinfer/spline

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

Verdict
SAFE
Grade
B
Trust score
89 /100
Exposed tools
145 145r · 0w · 0d
Transport
stdio · streamable-http
License
MIT
Stars
85
01

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

This project is archived. Spline.design does not provide a public REST API, making most of this server's functionality non-operational. See below for details.

Why archived

This MCP server was built to programmatically control Spline.design 3D scenes through Claude. However, Spline does not offer 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.

Spline's actual developer tools are:

  • [Code API](https://docs.spline.design/exporting-your-scene/web/code-api-for-web) — A client-side JavaScript runtime (@splinetool/runtime) that only works in a browser with a canvas element. It can manipulate objects in exported scenes but cannot create scenes or objects.
  • [Real-time API](https://docs.spline.design/interaction-states-events-and-actions/real-time-api) — A feature inside the Spline editor for making outbound API calls from Spline to external services. Not an inbound API.

Neither of these enables the kind of server-side programmatic control this MCP server attempts.

What does work

10 code generation tools generate @splinetool/runtime code for Vanilla JS, React, and Next.js. However, Claude can already write this code without an MCP server, making these tools redundant.

Installation

Using npx (for Claude Desktop)

Add this to your Claude Desktop MCP config:

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

Local development

git clone https://github.com/aydinfer/spline-mcp-server.git
cd spline-mcp-server
npm install
npm start

What you can do with it

Ask Claude to generate Spline runtime code for your projects:

  • "Generate a React component that loads my Spline scene and adds click handlers to objects"
  • "Write animation code that rotates an object on hover"
  • "Create an interactive scen
Read from source at commit 1890089fea1dOBSERVED · 2026-10-07
02

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code
claude mcp add spline-mcp-server --env OPENAI_API_KEY=${OPENAI_API_KEY} --env SPLINE_API_KEY=${SPLINE_API_KEY} -- npx -y [email protected]
claude-desktop
{
  "mcpServers": {
    "spline-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "OPENAI_API_KEY": "${OPENAI_API_KEY}",
        "SPLINE_API_KEY": "${SPLINE_API_KEY}"
      }
    }
  }
}
03

Exposed tools (145)

145 read · 0 write · 0 destructive.

ToolRiskDescription
addCameraread
addDirectionalLightread
addHanaEffectread
addHanaElementread
addHanaInteractionread
addHanaStateread
addMaterialLayerread
addObjectToUILayoutread
addPhysicsBodyread
applyEffectorToClonerread
applyForceread
applyMaterialread
applySculptingBrushread
applyTorqueread
browseLibraryread
checkGaussianSplattingJobread
commitSculptChangesread
compareSnapshotsread
configureAnimationActionread
configureApiread
configureApiRequestActionread
configureCameraActionread
configureColorLayerread
configureConditionalActionread
configureEventParametersread
configureFogread
configureFresnelLayerread
configureGlassLayerread
configureGradientLayerread
configureImageLayerread
configureMatcapLayerread
configureNormalLayerread
configureOpenAIread
configurePostProcessingread
configureSoundActionread
configureTransitionActionread
configureVariableActionread
controlHanaAnimationread
controlParticleSystemread
controlPathAnimationread
convertMeshToGaussianSplattingread
copyBetweenScenesread
create3DPathread
create3DTextread
createActionread
createBooleanOperationread
createClonerread
createComponentread
createComprehensiveEventread
createEventread
createGaussianSplattingFromImagesread
createHanaAnimationread
createHanaCanvasread
createHanaPrototyperead
createJointread
createLayeredMaterialread
createMaterialread
createObjectread
createParametricObjectread
createParticleForceread
createParticleSystemread
createPenPathread
createResponsiveVariantread
createSceneread
createSceneGroupread
createSculptObjectread
createShapeBlendread
createSnapshotread
createStateread
createUIComponentread
createUILayoutread
createWebhookread
deleteActionread
deleteApiread
deleteMaterialLayerread
deleteObjectread
deleteSnapshotread
deleteWebhookread
distributeAlongPathread
edit3DMeshread
export3DModelread
exportHanaCanvasread
exportSceneCoderead
exportSnapshotread
extrude2DShaperead
generateAnimationCoderead
generateComprehensiveExampleread
generateEmbedCoderead
generateEventListenerCoderead
generateObjectCoderead
generateReactComponentread
generateSceneInteractionCoderead
generateTextWithOpenAIread
generateVariableCoderead
getApisread
getEventDetailsread
getEventsread
getMaterialDetailsread
getMaterialsread
getObjectDetailsread
getObjectsread
getRuntimeSetupread
getSceneread
getScenesread
getStateDetailsread
getStatesread
getVariableread
getWebhooksread
helloread
import3DModelread
importFromLibraryread
importGaussianSplattingread
instantiateComponentread
lathe2DShaperead
linkScenesread
listActionsread
listMaterialLayersread
listScenesread
listSnapshotsread
mergeSnapshotread
navigateBetweenScenesread
objectFollowPathread
reorderMaterialLayersread
restoreSnapshotread
sendWebhookDataread
setVariableread
setupServiceWebhookread
triggerEventread
triggerHanaStateread
triggerStateread
triggerWebhookread
update3DPathread
updateClonerread
updateComponentInstanceread
updateGaussianSplattingread
updateHanaElementread
updateMaterialread
updateObjectread
updateObjectPivotread
updateParametricObjectread
updateParticleSystemread
updatePenPathread
updatePhysicsBodyread
updatePhysicsWorldread
updateTextObjectread
04

Trust audit

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

LayerWhat it checksResult
L0Provenance & inventoryPASS
L1Static analysis of the codePASS
L2Instruction surface (what it tells the agent)PASS
L3Class-specific surfacePASS
L4Behavioural (sandbox)SKIPPED

What the source does

Filesystem
declared (5 observation(s))
Network
declared (5 observation(s))
Shell
declared (2 observation(s))
Dependencies
not all pinned
Secrets in source
none-found

Findings (6)

LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/tools/design/boolean-operations.js:8
import { fetchFromSplineApi } from "../../utils/api-client.js";
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/tools/design/cloner-tools.js:8
import { fetchFromSplineApi, updateSplineObject } from "../../utils/api-client.js";
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/tools/design/component-tools.js:8
import { fetchFromSplineApi, updateSplineObject } from "../../utils/api-client.js";
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/tools/design/extrusion-tools.js:8
import { fetchFromSplineApi } from "../../utils/api-client.js";
LOWFilesystem / path · fs.traversal · CWE-22, CWE-59
src/tools/design/gaussian-splatting-tools.js:8
import { fetchFromSplineApi, updateSplineObject } from "../../utils/api-client.js";
LOWSupply chain · supply.unpinned · CWE-829, CWE-1357
package.json
@modelcontextprotocol/sdk, axios, dotenv, express, node-fetch, zod
Why it matters. 6 dependency range(s) float
Fix. pin exact versions or ship a lockfile

Gates applied: no_behavioural_pass.

Audited 2026-10-07 · audit v0.4.1 · source sha 1890089fea1dfull audit observations/trust-audit/mcp-server/aydinfer__spline.json · Report an issue / request a re-scan
05

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

DateSourceVerdictGradeScoreChange
2026-10-071890089fea1dSAFEB89first audit
06

Questions

What is the Spline MCP server?

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

What tools does Spline expose?

145 in total: 145 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.

Is Spline safe to connect to an agent?

The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.

What credentials does Spline need?

It reads OPENAI_API_KEY and SPLINE_API_KEY from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.

How does Spline run?

It speaks stdio and streamable-http, so it runs as a local process your client starts. It is published on npm as spline-mcp-server at 1.0.0.

How current is this page?

The grade is for one exact copy of the source (1890089fea1d), read on 2026-10-07. The repository is watched and re-audited when it changes.

Advertisement