sample-tool
A sample tool for demonstration purposes
LABSCO SUMMARY
From "I need a model of a chair" to a file on disk.
The three tools line up with the actual sequence: filter the catalogue to what you are allowed to download, check the one you like before committing, then pull it in the format your engine wants. Using the downloadable filter from the start is worth doing — a lot of what search returns is view-only.
What it is
A Sketchfab server with three working tools: search the catalogue by keywords, tags and categories, read a model's full details, and download it in glTF, GLB, USDZ or source format to a path you choose.
What you get
- Models searched by text, tags and categories, with a downloadable-only filter and a result limit
- Full details for a model by its identifier
- A model downloaded in glTF, GLB, USDZ or its source format, saved to a directory or file path you name
- A demonstration tool alongside the three real ones
Requirements
A Sketchfab API key, supplied at launch or as an environment setting. Node to run it from a build of the repository.
Setup effort
One command plus a key — npx -y sketchfab-mcp-server, then supply credentials
USE CASES
01
Finding a model that fits a scene
Search by keywords with tags and categories narrowing it, and cap how many come back.
02
Checking a model before downloading it
Read its full details — the part that tells you whether it is worth the download.
03
Getting the asset into your project
Download it in the format your pipeline wants, straight to the directory you work in.
04
Only seeing what you can actually use
Restrict the search to downloadable models so the results are not full of view-only ones.
4 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
sketchfab-download
Download a 3D model from Sketchfab
sketchfab-model-details
Get detailed information about a specific Sketchfab model
sketchfab-search
Search for 3D models on Sketchfab based on keywords and filters
BEFORE YOU INSTALL
What to know first
Tools you get
4 tools when we connected. sample-tool is leftover template code; the Sketchfab tools are sketchfab-search, sketchfab-model-details and sketchfab-download.
Requires
- npx on PATH
- Node.js 18 or later
- SKETCHFAB_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 4 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
Build from source
TERMINAL
git clone https://github.com/gregkop/sketchfab-mcp-server
cd sketchfab-mcp-server
npm install
npm run buildnpx
TERMINAL
npx -y sketchfab-mcp-serverMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"sketchfab": {
"command": "node",
"args": [
"<YOUR_PATH_TO_BUILD>/index.js",
"--api-key",
"<YOUR_API_KEY>"
]
}
}
}
