JADE REALMS / Documentation développeur
Connexion MCP
Ajoutez cette URL dans un client compatible Streamable HTTP distant, choisissez sans authentification puis découvrez les outils. Le navigateur peut être fermé.
Étapes de connexion
Ajoutez cette URL dans un client compatible Streamable HTTP distant, choisissez sans authentification puis découvrez les outils. Le navigateur peut être fermé.
https://3dmodelhub.io/mcp- Add a remote MCP server using this URL and Streamable HTTP transport.
- Select None for authentication. This public service has no API key or OAuth sign-in step.
- Discover the seven tools below. Read site information, search models, then request download URLs.
- Transport
- Streamable HTTP
- Authentication
- None
- Server
- jaderealms-public-assets
Distinct du WebMCP du navigateur. OAuth, bibliothèques achetées et commandes privées ne sont pas inclus.
Outils MCP
| Outils MCP | REST API | Obligatoire |
|---|---|---|
jaderealms_get_site_info | GET /api/v1/site | — |
jaderealms_search_models | GET /api/v1/models | — |
jaderealms_get_model_details | GET /api/v1/models/{id} | id |
jaderealms_list_scene_kits | GET /api/v1/kits | — |
jaderealms_get_scene_kit_details | GET /api/v1/kits/{id} | id |
jaderealms_get_usage_guidance | GET /api/v1/guidance | topic |
jaderealms_get_model_downloads | GET /api/v1/models/{id}/downloads | id |
Rechercher → consulter → télécharger
{
"name": "jaderealms_search_models",
"arguments": {
"q": "pine",
"tested_engine": "godot",
"max_triangles": 150000,
"limit": 3,
"locale": "fr"
}
}Exemple de client
npm install --save-exact @modelcontextprotocol/sdk@1.32.1import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
const client = new Client({ name: 'asset-library-client', version: '1.0.0' });
try {
await client.connect(new StreamableHTTPClientTransport(new URL("https://3dmodelhub.io/mcp")));
console.log(await client.listTools());
const result = await client.callTool({
"name": "jaderealms_search_models",
"arguments": {
"q": "pine",
"tested_engine": "godot",
"max_triangles": 150000,
"limit": 3,
"locale": "fr"
}
});
console.log(result.structuredContent);
} finally {
await client.close();
}Exemples de protocole
GET dans la barre d’adresse renvoie 405. Le serveur attend des messages MCP POST ; utilisez ces exemples ou le SDK officiel.
curl --fail 'https://3dmodelhub.io/mcp' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-11-25' \
--data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"manual-check","version":"1.0.0"}}}'curl --fail 'https://3dmodelhub.io/mcp' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-11-25' \
--data '{"jsonrpc":"2.0","method":"notifications/initialized"}'curl --fail 'https://3dmodelhub.io/mcp' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-11-25' \
--data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'curl --fail 'https://3dmodelhub.io/mcp' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-11-25' \
--data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"jaderealms_search_models","arguments":{"q":"pine","tested_engine":"godot","max_triangles":150000,"limit":3,"locale":"fr"}}}'Portée et compatibilité
Renvoie métadonnées et URL. Aucun achat, accès privé ou écriture dans un projet local. La 3D dans le chat dépend du client.
Uniquement des faits publiés. Les inconnues restent null ; les vérifications portent sur le hash GLB et ne certifient pas les performances.
Les métadonnées partagent une limite au mieux de 120 requêtes par minute et IP dans chaque site Cloudflare. Ce n’est pas un quota de fichiers gratuits.
- POST: initialize / notifications / tools/list / tools/call
- GET / DELETE: 405 · OPTIONS: 204
- JSON response · no persistent session ID · 32 KiB message limit
- tools/call: content + structuredContent; isError=true on invalid arguments
Erreurs et reprises
| HTTP / JSON-RPC | Description |
|---|---|
| 405 | GET from an address bar is unsupported; connect with MCP POST. |
| 406 | Accept must include both application/json and text/event-stream. |
| 415 | Send JSON with Content-Type: application/json. |
| 403 | Browser Origin is not allowed. Default origins cover this site and configured ChatGPT, Claude and Cursor origins. A site administrator can configure MCP_ALLOWED_ORIGINS for another browser client. |
| 413 | Messages must fit within 32 KiB; batch messages are unsupported. |
| 429 | Wait for Retry-After before retrying. |
| JSON-RPC / tools/call | Check JSON-RPC error first. If result.isError is true, inspect structuredContent or text for the tool error instead of treating it as success. |